Jobs

get

Latest job

Authorizations

authenticationOIDC

sessionidstringRequired

Log in using the POST /api/v1/auth/ endpoint

Path parameters

engine_idstringRequired

Query parameters

job_typestringRequired

Responses

200

Success: Job details

application/json

idstring · uuidRequired

engine_idany ofOptionalDefault: null

string · uuidOptional

or

nullOptional

workflow_idany ofOptionalDefault: null

string · uuidOptional

or

nullOptional

typestring · enumRequiredPossible values:

statusstring · enumRequiredPossible values:

createdany ofOptionalDefault: null

string · date-timeOptional

or

nullOptional

last_updatedany ofOptionalDefault: null

string · date-timeOptional

or

nullOptional

settingsany ofOptionalDefault: null

stringOptional

or

objectOptional

or

nullOptional

nowany ofOptionalDefault: null

string · date-timeOptional

or

nullOptional

422

Validation error

application/json

503

Message: unable to fetch engine from external service

get

/api/v1/jobs/{engine_id}/latest/

HTTPcURLJavaScriptPython

GET /api/v1/jobs/{engine_id}/latest/?job_type=text HTTP/1.1
Accept: */*

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "engine_id": "123e4567-e89b-12d3-a456-426614174000",
  "workflow_id": "123e4567-e89b-12d3-a456-426614174000",
  "type": "synthesize",
  "status": "STARTED",
  "created": "2026-02-20T14:02:01.781Z",
  "last_updated": "2026-02-20T14:02:01.781Z",
  "settings": "text",
  "now": "2026-02-20T14:02:01.781Z"
}

get

List jobs

Authorizations

authenticationOIDC

sessionidstringRequired

Log in using the POST /api/v1/auth/ endpoint

Path parameters

engine_idstringRequired

Query parameters

job_typestring · enumOptionalPossible values:

Responses

200

Success: Jobs list

application/json

422

Validation error

application/json

503

Message: unable to fetch engine from external service

get

/api/v1/jobs/{engine_id}/list/

HTTPcURLJavaScriptPython

GET /api/v1/jobs/{engine_id}/list/ HTTP/1.1
Accept: */*

{
  "jobs": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "engine_id": "123e4567-e89b-12d3-a456-426614174000",
      "workflow_id": "123e4567-e89b-12d3-a456-426614174000",
      "type": "synthesize",
      "status": "STARTED",
      "created": "2026-02-20T14:02:01.781Z",
      "last_updated": "2026-02-20T14:02:01.781Z",
      "settings": "text",
      "now": "2026-02-20T14:02:01.781Z"
    }
  ]
}

get

Get Job

Authorizations

authenticationOIDC

sessionidstringRequired

Log in using the POST /api/v1/auth/ endpoint

Path parameters

job_idstringRequired

Responses

200

Success: Job details

application/json

idstring · uuidRequired

engine_idany ofOptionalDefault: null

string · uuidOptional

or

nullOptional

workflow_idany ofOptionalDefault: null

string · uuidOptional

or

nullOptional

typestring · enumRequiredPossible values:

statusstring · enumRequiredPossible values:

createdany ofOptionalDefault: null

string · date-timeOptional

or

nullOptional

last_updatedany ofOptionalDefault: null

string · date-timeOptional

or

nullOptional

settingsany ofOptionalDefault: null

stringOptional

or

objectOptional

or

nullOptional

nowany ofOptionalDefault: null

string · date-timeOptional

or

nullOptional

422

Validation error

application/json

503

Message: unable to fetch engine from external service

get

/api/v1/jobs/{job_id}/

HTTPcURLJavaScriptPython

GET /api/v1/jobs/{job_id}/ HTTP/1.1
Accept: */*

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "engine_id": "123e4567-e89b-12d3-a456-426614174000",
  "workflow_id": "123e4567-e89b-12d3-a456-426614174000",
  "type": "synthesize",
  "status": "STARTED",
  "created": "2026-02-20T14:02:01.781Z",
  "last_updated": "2026-02-20T14:02:01.781Z",
  "settings": "text",
  "now": "2026-02-20T14:02:01.781Z"
}

put

Cancel job

Authorizations

authenticationOIDC

sessionidstringRequired

Log in using the POST /api/v1/auth/ endpoint

Path parameters

job_idstringRequired

Responses

200

Success: Job status

application/json

idany ofOptionalDefault: null

string · uuidOptional

or

nullOptional

statusany ofOptionalDefault: null

string · enumOptionalPossible values:

or

nullOptional

reasonany ofOptionalDefault: null

stringOptional

or

nullOptional

422

Validation error

application/json

503

Message: unable to fetch engine from external service

put

/api/v1/jobs/{job_id}/cancel/

HTTPcURLJavaScriptPython

PUT /api/v1/jobs/{job_id}/cancel/ HTTP/1.1
Accept: */*

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "status": "STARTED",
  "reason": "text"
}

delete

Delete job

Authorizations

authenticationOIDC

sessionidstringRequired

Log in using the POST /api/v1/auth/ endpoint

Path parameters

job_idstringRequired

Responses

200

Success: Job status

application/json

idany ofOptionalDefault: null

string · uuidOptional

or

nullOptional

statusany ofOptionalDefault: null

string · enumOptionalPossible values:

or

nullOptional

reasonany ofOptionalDefault: null

stringOptional

or

nullOptional

422

Validation error

application/json

503

Message: unable to fetch engine from external service

delete

/api/v1/jobs/{job_id}/delete/

HTTPcURLJavaScriptPython

DELETE /api/v1/jobs/{job_id}/delete/ HTTP/1.1
Accept: */*

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "status": "STARTED",
  "reason": "text"
}

get

Job logs

Authorizations

authenticationOIDC

sessionidstringRequired

Log in using the POST /api/v1/auth/ endpoint

Path parameters

job_idstringRequired

Responses

200

Success: Job log

application/json

idany ofOptionalDefault: null

string · uuidOptional

or

nullOptional

logany ofOptionalDefault: null

stringOptional

or

nullOptional

422

Validation error

application/json

503

Message: unable to fetch engine from external service

get

/api/v1/jobs/{job_id}/download_log/

HTTPcURLJavaScriptPython

GET /api/v1/jobs/{job_id}/download_log/ HTTP/1.1
Accept: */*

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "log": "text"
}