Developer Docs

API Documentation

Complete reference for authentication, endpoint behavior, request contracts, response schemas, and field-level specifications.

Authentication

Document endpoints require API-KEY with JSON content type.

JSON
{
  "Content-Type": "application/json",
  "Authorization": "Bearer {{API-KEY}}"
}

Get All Documents

Retrieve all documents for a project.

GET/api/v1/key/projects/documents
JSON
{
  "success": true,
  "data": [
    {
      "id": "Document UUID",
      "name": "Document name",
      "description": "Document description",
      "status": "Document status",
      "content": "Document content",
      "createdAt": "ISO timestamp",
      "updatedAt": "ISO timestamp"
    }
  ]
}

Get Document By ID

Retrieve a single document by identifier.

GET/api/v1/key/projects/documents/:docId
JSON
{
  "success": true,
  "data": {
    "id": "Document UUID",
    "name": "Document name",
    "description": "Document description",
    "status": "Document status",
    "content": "Document content",
    "createdAt": "ISO timestamp",
    "updatedAt": "ISO timestamp"
  }
}

Create Document

Create a new document record.

POST/api/v1/key/projects/documents
JSON
{
  "name": "Document name",
  "description": "description",
  "content": "content"
}
FieldTypeOptionalNullableEnums/FormatDescriptionNotes
namestringfalsefalse-Document title-
descriptionstringtruetrue-Document description-
contentstringfalsefalse-Document body-

Update Document

Update metadata fields on an existing document.

PUT/api/v1/key/projects/documents/:docId
JSON
{
  "name": "updated name",
  "description": "updated description"
}
FieldTypeOptionalNullableEnums/FormatDescriptionNotes
namestringfalsefalse-Updated name-
descriptionstringfalsefalse-Updated description-

Update Document Content

Patch only the content body of a document.

PATCH/api/v1/key/projects/documents/:docId/content
JSON
{
  "content": "Updated document content..."
}
FieldTypeOptionalNullableEnums/FormatDescriptionNotes
contentstringfalsefalse-Updated document content-

Delete Document

Delete a document by project and document id.

DELETE/api/v1/projects/:projectId/documents/:docId
JSON
{
  "success": true,
  "message": "Document deleted successfully"
}

Document Object Schema

Canonical document response object fields.

FieldTypeOptionalNullableEnums/FormatDescriptionNotes
idstring (uuid)falsefalseUUIDDocument ID-
namestringfalsefalse-Document name-
descriptionstringtruetrue-Document description-
statusstringfalsefalse-Document status-
contentstringfalsefalse-Document content-
createdAtstringfalsefalseISO 8601Created timestamp-
updatedAtstringfalsefalseISO 8601Updated timestamp-