v2

latestOpenAPI 3.1.02026-08-05267431678.1 KB
generate

Get Generation Job Status

Get the current status of an async generation job.

Returns the current status and, when complete, the generated data.

Args: job_id: The job/dataset UUID to query. auth: Authenticated user context.

Returns: GenerateJobStatus with status and data when the job is 'ready'.

Raises: HTTPException: 400 if job_id is not a valid UUID. HTTPException: 404 if the job is not found or not owned by this user.

get/generate/jobs/{job_id}

Path parameters

job_idstring required

Response

Successful Response

job_idstring required

Job ID (same as dataset_id)

statusstring required

Job status: queued, generating, ready, failed

dataobject[] nullable

Generated data rows (only present when status is 'ready')

countinteger nullable

Number of generated rows (only present when status is 'ready')

task_typestring nullable

Generation task type: ner, classification, or custom

token_usageinteger nullable

Estimated tokens used (only present when status is 'ready')

datasetobject nullable

Dataset info (only present when status is 'ready')

errorstring nullable

Error message (only present when status is 'failed')

is_seedboolean nullable

Whether this is a seed dataset

created_atstring nullable

Job creation timestamp