• Features
  • Pricing
Get Started

List DocumentsCreate DocumentGet DocumentUpdate DocumentTrash DocumentRestore DocumentDelete PermanentlyDuplicate Document

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

All fields are optional. With an empty body, Blueputto creates an untitled document in no folder. A template supplies its default content, metadata, labels, and author.

NameTypeDescription
folderIdstring (uuid) or nullFolder that will contain the document. Use null for no folder.
templateIdstring (uuid)Active template to use as the starting point.
titlestringInitial document title, from 1 to 255 characters.

Example

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

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