File Processing API

Trigger extraction and indexing for a previously uploaded file. Processing runs asynchronously through the existing pipeline.

POST/v1/files/:id/process

Authentication

Requires a secret API key passed as a Bearer token (Authorization: Bearer carrier_sk_…).

Example request

bash
curl -X POST https://api.carrieros.ai/v1/files/f7a2…/process \
  -H "Authorization: Bearer carrier_sk_live_YOUR_KEY"

Response

FieldTypeDescription
file_idstringThe file being processed.
statusstringProcessing status — processing once enqueued.

Example response

json
{
  "success": true,
  "data": {
    "file_id": "f7a2…",
    "status": "processing"
  }
}

Possible errors

CodeHTTPWhen it occurs
FILE_NOT_FOUND404No such file for this account/key.

Notes

Once processing completes, the file's content becomes available to the Search API.