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
Query parameters
jobIdstring · uuidRequired

ID of the job to retrieve

Responses
200
Job status retrieved successfully
application/json
get
GET /api/getJobStatus?jobId=123e4567-e89b-12d3-a456-426614174000 HTTP/1.1
Host: 
Authorization: Bearer JWT
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": "2025-07-17T10:55:32.134Z",
  "updated_at": "2025-07-17T10:55:32.134Z"
}

Cancel a running job

post

Cancels a job that is currently in progress or queued

Authorizations
Body
jobIdstring · uuidRequired

ID of the job to cancel

Responses
200
Job cancelled successfully
application/json
post
POST /api/cancelJob HTTP/1.1
Host: 
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 48

{
  "jobId": "123e4567-e89b-12d3-a456-426614174000"
}
{
  "message": "Job cancelled successfully"
}