Job Management

Operations for tracking and managing generation jobs

Get job status

get

Retrieves detailed information about a specific job including status and progress

Authorizations

bearerAuth

AuthorizationstringRequired

JWT token for user session authentication.

Query parameters

jobIdstring · uuidRequired

ID of the job to retrieve

Responses

200

Job status retrieved successfully

application/json

401

Unauthorized

application/json

404

Job not found

application/json

500

Internal Server Error

application/json

get

/getJobStatus

HTTPcURLJavaScriptPython

GET /api/getJobStatus?jobId=123e4567-e89b-12d3-a456-426614174000 HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": "987fcdeb-51a2-43d7-8f9e-123456789abc",
  "user_id": "123e4567-e89b-12d3-a456-426614174000",
  "project_id": "123e4567-e89b-12d3-a456-426614174000",
  "status": "draft",
  "progress": 75.5,
  "progress_stage": "generating_work",
  "percent_complete": 1,
  "title": "text",
  "is_byok": false,
  "reasoning_model": "google/gemini-2.5-flash-001",
  "writing_model": "google/gemini-2.5-flash-001",
  "function_model": "google/gemini-2.5-flash-001",
  "error_message": "text",
  "is_starred": false,
  "created_at": "2026-01-20T23:12:33.320Z",
  "updated_at": "2026-01-20T23:12:33.320Z"
}

Cancel a running job

post

Cancels a job that is currently in progress or queued

Authorizations

bearerAuth

AuthorizationstringRequired

JWT token for user session authentication.

Body

application/json

jobIdstring · uuidRequired

ID of the job to cancel

Responses

200

Job cancelled successfully

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

404

Job not found

application/json

500

Internal Server Error

application/json

post

/cancelJob

HTTPcURLJavaScriptPython

POST /api/cancelJob HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 48

{
  "jobId": "123e4567-e89b-12d3-a456-426614174000"
}

{
  "message": "Job cancelled successfully"
}