agent-jobs
agent-jobs

Start Async Job

Start an async job (returns immediately with job_id).

Job runs in background. Client can monitor via SSE stream or poll status.

Per Issue #271 specification.

post/api/chat/agentic/async

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/async
  • Auth: HTTP bearer

Request body

job_typestring required

Type of job to execute

job_dataobject required

Job-specific parameters

organization_idstring uuid required

Organization context

company_profile_idstring uuid nullable

Optional company profile context

Example request

{
  "company_profile_id": "123e4567-e89b-12d3-a456-426614174001",
  "job_data": {
    "campaign_name": "Summer Sale 2025",
    "copy_prompt": "50% off all products",
    "creative_prompt": "Beach vacation theme",
    "platform": "facebook"
  },
  "job_type": "ad_creation",
  "organization_id": "123e4567-e89b-12d3-a456-426614174000"
}

Response

Successful Response

job_idstring required

Unique job identifier

statusstring required

Initial job status (typically 'running')

stream_urlstring required

SSE endpoint for real-time progress

poll_urlstring required

HTTP endpoint for polling status

Example response

{
  "job_id": "987fcdeb-51a2-43f7-9876-543210987654",
  "poll_url": "/api/chat/agentic/jobs/987fcdeb-51a2-43f7-9876-543210987654",
  "status": "running",
  "stream_url": "/api/chat/agentic/jobs/987fcdeb-51a2-43f7-9876-543210987654/stream"
}

Changes

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