Jobs
Jobs are created by domain endpoints (/v1/reports/jobs, /v1/matching/jobs).
Generated from contracts in
packages/contracts/src/v1. Do not hand-edit this page.
GET /v1/jobs/:jobId
Get current lifecycle state for a job.
Response schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"createdAt": {
"type": "string"
},
"credits": {
"type": "object",
"properties": {
"reservationStatus": {
"anyOf": [
{
"type": "string",
"enum": [
"active",
"released",
"applied"
]
},
{
"type": "null"
}
]
},
"reservedCredits": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
}
},
"required": [
"reservationStatus",
"reservedCredits"
],
"additionalProperties": false
},
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"details": {},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
}
},
"required": [
"code",
"message"
],
"additionalProperties": false
},
"id": {
"type": "string"
},
"matchingId": {
"type": "string"
},
"progress": {
"type": "number"
},
"releasedCredits": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"reportId": {
"type": "string"
},
"stage": {
"type": "string",
"enum": [
"uploaded",
"queued",
"transcoding",
"extracting",
"scoring",
"rendering",
"finalizing"
]
},
"status": {
"type": "string",
"enum": [
"queued",
"running",
"succeeded",
"failed",
"canceled"
]
},
"type": {
"type": "string",
"enum": [
"report.generate",
"matching.generate"
]
},
"updatedAt": {
"type": "string"
},
"usage": {
"type": "object",
"properties": {
"creditsDiscounted": {
"type": "number"
},
"creditsNetUsed": {
"type": "number"
},
"creditsUsed": {
"type": "number"
},
"durationMs": {
"type": "number"
},
"modelVersion": {
"type": "string"
}
},
"required": [
"creditsNetUsed",
"creditsUsed"
],
"additionalProperties": false
}
},
"required": [
"createdAt",
"id",
"status",
"type",
"updatedAt"
],
"additionalProperties": false
}
GET /v1/jobs/:jobId/stream
Server-Sent Events stream for real-time job updates.
- Events include
status,stage,terminal, andheartbeat. - Use
Last-Event-IDheader to resume dropped streams.
Query schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"timeout": {
"default": 300000,
"description": "Stream timeout in milliseconds (default: 300000, max: 300000)",
"type": "number",
"minimum": 1000,
"maximum": 300000
}
},
"required": [
"timeout"
],
"additionalProperties": false
}
Stream event schemas
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Monotonically increasing event ID for resumption"
},
"data": {
"type": "object",
"properties": {
"job": {
"type": "object",
"properties": {
"createdAt": {
"type": "string"
},
"credits": {
"type": "object",
"properties": {
"reservationStatus": {
"anyOf": [
{
"type": "string",
"enum": [
"active",
"released",
"applied"
]
},
{
"type": "null"
}
]
},
"reservedCredits": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
}
},
"required": [
"reservationStatus",
"reservedCredits"
],
"additionalProperties": false
},
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"details": {},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
}
},
"required": [
"code",
"message"
],
"additionalProperties": false
},
"id": {
"type": "string"
},
"matchingId": {
"type": "string"
},
"progress": {
"type": "number"
},
"releasedCredits": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"reportId": {
"type": "string"
},
"stage": {
"type": "string",
"enum": [
"uploaded",
"queued",
"transcoding",
"extracting",
"scoring",
"rendering",
"finalizing"
]
},
"status": {
"type": "string",
"enum": [
"queued",
"running",
"succeeded",
"failed",
"canceled"
]
},
"type": {
"type": "string",
"enum": [
"report.generate",
"matching.generate"
]
},
"updatedAt": {
"type": "string"
},
"usage": {
"type": "object",
"properties": {
"creditsDiscounted": {
"type": "number"
},
"creditsNetUsed": {
"type": "number"
},
"creditsUsed": {
"type": "number"
},
"durationMs": {
"type": "number"
},
"modelVersion": {
"type": "string"
}
},
"required": [
"creditsNetUsed",
"creditsUsed"
],
"additionalProperties": false
}
},
"required": [
"createdAt",
"id",
"status",
"type",
"updatedAt"
],
"additionalProperties": false
},
"progress": {
"type": "number"
},
"stage": {
"type": "string",
"enum": [
"uploaded",
"queued",
"transcoding",
"extracting",
"scoring",
"rendering",
"finalizing"
]
},
"status": {
"type": "string",
"enum": [
"queued",
"running",
"succeeded",
"failed",
"canceled"
]
}
},
"required": [
"job",
"status"
],
"additionalProperties": false
},
"event": {
"type": "string",
"const": "status"
}
},
"required": [
"id",
"data",
"event"
],
"additionalProperties": false
}
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Monotonically increasing event ID for resumption"
},
"data": {
"type": "object",
"properties": {
"job": {
"type": "object",
"properties": {
"createdAt": {
"type": "string"
},
"credits": {
"type": "object",
"properties": {
"reservationStatus": {
"anyOf": [
{
"type": "string",
"enum": [
"active",
"released",
"applied"
]
},
{
"type": "null"
}
]
},
"reservedCredits": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
}
},
"required": [
"reservationStatus",
"reservedCredits"
],
"additionalProperties": false
},
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"details": {},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
}
},
"required": [
"code",
"message"
],
"additionalProperties": false
},
"id": {
"type": "string"
},
"matchingId": {
"type": "string"
},
"progress": {
"type": "number"
},
"releasedCredits": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"reportId": {
"type": "string"
},
"stage": {
"type": "string",
"enum": [
"uploaded",
"queued",
"transcoding",
"extracting",
"scoring",
"rendering",
"finalizing"
]
},
"status": {
"type": "string",
"enum": [
"queued",
"running",
"succeeded",
"failed",
"canceled"
]
},
"type": {
"type": "string",
"enum": [
"report.generate",
"matching.generate"
]
},
"updatedAt": {
"type": "string"
},
"usage": {
"type": "object",
"properties": {
"creditsDiscounted": {
"type": "number"
},
"creditsNetUsed": {
"type": "number"
},
"creditsUsed": {
"type": "number"
},
"durationMs": {
"type": "number"
},
"modelVersion": {
"type": "string"
}
},
"required": [
"creditsNetUsed",
"creditsUsed"
],
"additionalProperties": false
}
},
"required": [
"createdAt",
"id",
"status",
"type",
"updatedAt"
],
"additionalProperties": false
},
"progress": {
"type": "number"
},
"stage": {
"type": "string",
"enum": [
"uploaded",
"queued",
"transcoding",
"extracting",
"scoring",
"rendering",
"finalizing"
]
}
},
"required": [
"job",
"stage"
],
"additionalProperties": false
},
"event": {
"type": "string",
"const": "stage"
}
},
"required": [
"id",
"data",
"event"
],
"additionalProperties": false
}
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Monotonically increasing event ID for resumption"
},
"data": {
"type": "object",
"properties": {
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"additionalProperties": false
},
"job": {
"type": "object",
"properties": {
"createdAt": {
"type": "string"
},
"credits": {
"type": "object",
"properties": {
"reservationStatus": {
"anyOf": [
{
"type": "string",
"enum": [
"active",
"released",
"applied"
]
},
{
"type": "null"
}
]
},
"reservedCredits": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
}
},
"required": [
"reservationStatus",
"reservedCredits"
],
"additionalProperties": false
},
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"details": {},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
}
},
"required": [
"code",
"message"
],
"additionalProperties": false
},
"id": {
"type": "string"
},
"matchingId": {
"type": "string"
},
"progress": {
"type": "number"
},
"releasedCredits": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"reportId": {
"type": "string"
},
"stage": {
"type": "string",
"enum": [
"uploaded",
"queued",
"transcoding",
"extracting",
"scoring",
"rendering",
"finalizing"
]
},
"status": {
"type": "string",
"enum": [
"queued",
"running",
"succeeded",
"failed",
"canceled"
]
},
"type": {
"type": "string",
"enum": [
"report.generate",
"matching.generate"
]
},
"updatedAt": {
"type": "string"
},
"usage": {
"type": "object",
"properties": {
"creditsDiscounted": {
"type": "number"
},
"creditsNetUsed": {
"type": "number"
},
"creditsUsed": {
"type": "number"
},
"durationMs": {
"type": "number"
},
"modelVersion": {
"type": "string"
}
},
"required": [
"creditsNetUsed",
"creditsUsed"
],
"additionalProperties": false
}
},
"required": [
"createdAt",
"id",
"status",
"type",
"updatedAt"
],
"additionalProperties": false
},
"matchingId": {
"type": "string"
},
"reportId": {
"type": "string"
},
"status": {
"type": "string",
"enum": [
"succeeded",
"failed",
"canceled"
]
}
},
"required": [
"job",
"status"
],
"additionalProperties": false
},
"event": {
"type": "string",
"const": "terminal"
}
},
"required": [
"id",
"data",
"event"
],
"additionalProperties": false
}
POST /v1/jobs/:jobId/cancel
Cancel a queued or running job.
Response schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"createdAt": {
"type": "string"
},
"credits": {
"type": "object",
"properties": {
"reservationStatus": {
"anyOf": [
{
"type": "string",
"enum": [
"active",
"released",
"applied"
]
},
{
"type": "null"
}
]
},
"reservedCredits": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
}
},
"required": [
"reservationStatus",
"reservedCredits"
],
"additionalProperties": false
},
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"details": {},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
}
},
"required": [
"code",
"message"
],
"additionalProperties": false
},
"id": {
"type": "string"
},
"matchingId": {
"type": "string"
},
"progress": {
"type": "number"
},
"releasedCredits": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"reportId": {
"type": "string"
},
"stage": {
"type": "string",
"enum": [
"uploaded",
"queued",
"transcoding",
"extracting",
"scoring",
"rendering",
"finalizing"
]
},
"status": {
"type": "string",
"enum": [
"queued",
"running",
"succeeded",
"failed",
"canceled"
]
},
"type": {
"type": "string",
"enum": [
"report.generate",
"matching.generate"
]
},
"updatedAt": {
"type": "string"
},
"usage": {
"type": "object",
"properties": {
"creditsDiscounted": {
"type": "number"
},
"creditsNetUsed": {
"type": "number"
},
"creditsUsed": {
"type": "number"
},
"durationMs": {
"type": "number"
},
"modelVersion": {
"type": "string"
}
},
"required": [
"creditsNetUsed",
"creditsUsed"
],
"additionalProperties": false
}
},
"required": [
"createdAt",
"id",
"status",
"type",
"updatedAt"
],
"additionalProperties": false
}