Prerequisites

Before you can upload a file to Petal, you will need:

  1. Your bearer token and desired Workspace ID. They can be obtained as described here.
  2. Software that can use APIs, such as cURL or Python.

Upload a Document

The API endpoint for creating a Document is https://cite.petal.org/api/document/create. You will need to send a POST request to the endpoint with a multipart/form-data body containing three fields:

organization_id
integer

The ID of your Workspace/Organization

doctype
string

The extension of your document, e.g. pdf, docx, ppt

file
binary

The file you wish to upload

Below is an example of a Document creation POST request.

Remember to replace <token> with your own bearer token.