Async classify endpoint.

Persists a pollable job row, then runs the same classify CPU-worker pipeline without awaiting the result. Clients poll GET /job/{job_id}.

post/classify_async

Request

  • Base URL
    https://platform.reducto.ai
  • Auth
    HTTP bearer

Request body

model'default' | 'accurate'

The classification model to use. Set to "accurate" to run Deep Classify for higher accuracy on hard documents. Defaults to "default".

priorityboolean

Workers poll the priority queue ahead of the standard queue, so priority jobs start sooner when there is queued work; sync jobs are prioritized above async jobs by default.

force_url_resultboolean

Force the endpoint result to be returned in URL form.

category_groupsobject

A mapping of higher-level classify groups to the category labels that belong to each group. When provided, the response includes extra_metadata.grouping with the matched group name, or ungrouped if the selected category is not in any group.

document_metadatastring nullable

Optional document-level metadata to include in classification prompts.

Response

Successful Response

job_idstring required

Changes