Trigger processing for uploaded documents | Pyramid AI

curl -X POST https://api.pyramid-ai.com/api/v2/documents/process \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "document_ids": [
    "doc_9f8b7c6a-1234-4d56-8e9f-abcdef123456",
    "doc_4a3b2c1d-5678-4e90-b123-fedcba654321"
  ]
}'

{
  "request_id": "req_20240612_abcdef1234567890",
  "success": true,
  "data": {
    "processed": [
      "doc_9f8b7c6a-1234-4d56-8e9f-abcdef123456"
    ],
    "skipped": [
      {
        "document_id": "doc_7e6d5c4b-2345-4f67-9abc-123456abcdef",
        "reason": "status_not_awaiting_upload",
        "current_status": "processing"
      }
    ],
    "failed": [
      {
        "document_id": "doc_4a3b2c1d-5678-4e90-b123-fedcba654321",
        "error": "DISPATCH_FAILED",
        "message": "Failed to dispatch document for processing due to internal server error."
      }
    ]
  },
  "pagination": {
    "total": 3,
    "offset": 0,
    "limit": 50
  }
}

Step 2 of the upload flow. After uploading bytes via the presigned URL, call this to start chunking and embedding. Documents that aren’t in awaiting_upload status are skipped with a reason.

Authentication

AuthorizationBearer

Pyramid API key (prefix with “Bearer ”)

Request

This endpoint expects an object.

document_idslist of stringsRequired

Response

Processing results

request_idstringformat: "uuid"

Server-generated per-request UUID. Also sent as X-Request-Id response header. Include in support tickets.

successany

dataobject

paginationobject

Present only on list endpoints. Top-level (not nested inside data).

Errors

400

Bad Request Error

401

Unauthorized Error