• Features
  • Pricing
Get Started

OverviewList DocumentsCreate DocumentGet DocumentUpdate DocumentTrash DocumentRestore DocumentDelete PermanentlyDuplicate Document

Documents

POST /v1/documents

Create a new document by sending a JSON request body.

POST /v1/documents creates a new document.

Authentication

Send an organization API key in x-api-key or Authorization: Bearer <key>.

Request Body

Send a JSON object. The public OpenAPI schema does not enumerate document-specific properties for this route, so provide the fields your workspace expects.

Example

curl -X POST "https://api.blueputto.com/v1/documents" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "content-type: application/json" \
  -d '{}'

Success Response

201 Created

{
  "data": {}
}

Error Responses

  • 400 Bad Request
  • 401 Unauthorized
  • 404 Not Found
  • 429 Too Many Requests

GET /v1/documents

List documents with pagination, search, folder filters, and an optional trash-only filter.

GET /v1/documents/{documentId}

Retrieve a single document by its UUID.

On this page

AuthenticationRequest BodyExampleSuccess ResponseError Responses