agent-jobs
agent-jobs

Get Job Status

Poll job status (for clients that don't want to use SSE).

Per Issue #271 specification.

get/api/chat/agentic/jobs/{job_id}

Request

  • Base URL: https://api.usepomo.ai (the document declares no server; this is the origin it was published from)
  • URL: https://api.usepomo.ai/api/chat/agentic/jobs/{job_id}
  • Auth: HTTP bearer

Path parameters

job_idstring required

Response

Successful Response

job_idstring required

Job identifier

typestring required

Job type

statusstring required

Current status: pending, running, completed, failed, cancelled

resultobject nullable

Job result (only when completed)

errorstring nullable

Error message (only when failed)

error_detailobject nullable

Structured plan-gate answer ({status_code, detail}) when the job failed on a usage limit, feature gate or subscription gate

progressobject nullable

Current progress data

created_atstring date-time required

Job creation timestamp

started_atstring date-time nullable

Job start timestamp

completed_atstring date-time nullable

Job completion timestamp

Example response

{
  "created_at": "2025-01-15T10:30:00Z",
  "job_id": "987fcdeb-51a2-43f7-9876-543210987654",
  "progress": {
    "message": "Generating ad creative...",
    "progress": 0.25,
    "step": "generate_creative"
  },
  "started_at": "2025-01-15T10:30:01Z",
  "status": "running",
  "type": "ad_creation"
}

Changes

No recorded changes to this operation across all 1 revision of this API.