public-api

Categorize Sync

Categorize a document and wait for the result.

post/api/v1/categorize

Request

Base URL
https://ndi-api.nace.ai (the document declares no server; this is the origin it was published from)
Auth
API key in header X-API-Key
TypeScript
https://skmtc.dev/nace/apis/ndi-service/docs/api/v1/categorize/post.ts
A function with typed inputs. Its response is checked against the schema.

Query parameters

timeout_secondsnumber

Max seconds to wait before returning 408 (the job keeps running; poll GET /jobs/{job_id}).

Request body

markdown_urlstring nullable

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

idempotency_keystring nullable

Response

Successful Response

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.