Jobs

Asynchronous work (STT, TTS, summaries) produces jobs. Use these endpoints to track and manage them.

List jobs

GET /v1/jobs API key

Query parameters

`serviceId` string	Filter by service, e.g. "stt".
`status` string	pending \| processing \| success \| error
`projectId` uuid	Filter by project.
`q` string	Free-text search over job names.
`limit` integer	Page size. Default 20.
`offset` integer	Page offset. Default 0.

Get a job

GET /v1/jobs/{id} API key

curl https://api-ocr.vanguardinitiative.com/v1/jobs/$JOB_ID \
  -H "authorization: Bearer $API_KEY"

200 Job

{
  "status": "success",
  "job": {
    "id": "b3f1c2a4-...",
    "serviceId": "stt",
    "name": "Team standup",
    "status": "success",
    "result": { "text": "..." },
    "createdAt": "2026-07-18T09:00:00Z"
  }
}

Rename a job

PATCH /v1/jobs/{id} API key

JSON body

name *

string

A human-friendly label for the job.

Delete a job

DELETE /v1/jobs/{id} API key

Deleting a job also removes any stored output.

Summarise a transcript

POST /v1/jobs/{id}/summarize API key

JSON body

`preset` string	Summary style, e.g. "meeting".
`force` boolean	Regenerate even if a summary already exists.