public-api

Categorize Async

Start a categorize job: classify document segments/sheets against a taxonomy.

post/api/v1/categorize_async

Request

Request body

markdown_urlstring nullable

Markdown from a prior parse of the same file; skips the internal parse when present.

idempotency_keystring nullable

Response

Idempotent replay — a job with this idempotency_key already exists; body is its current state.

job_idstring uuid required
actionstring required

One of parse/ground/categorize/extract.

statusstring required

One of pending/running/succeeded/failed.

is_exampleboolean

True for provisioned Playground example jobs.

created_atstring date-time required
started_atstring date-time nullable
completed_atstring date-time nullable
credits_usedinteger nullable

Credits charged to this job per the ledger. 0 for failed/cancelled jobs (never charged) and zero-credit example jobs; null while the job is non-terminal (not counted yet) or for a succeeded job predating the ledger.

Changes

No recorded changes to this operation across all 1 revision of this API.