Skip to main content
POST
Create Job
Create a one-off messaging job. Jobs are used for fire-and-forget message processing where the agent processes a prompt and returns a response.
This endpoint requires API key authentication via the X-API-Key header.

Request Body

userId
string
required
UUID of the user sending the message
content
string
required
The message content/prompt to process (max 50KB)
agentId
string
UUID of the agent to process the message. If not provided, uses the first available agent.
timeoutMs
number
default:"120000"
Job timeout in milliseconds (min: 1000, max: 300000)
metadata
object
Additional metadata to attach to the job (max 10KB)

Response

jobId
string
Unique job identifier for tracking
status
string
Initial job status: pending or processing
createdAt
number
Unix timestamp of job creation
expiresAt
number
Unix timestamp when the job will timeout

Example Request

Job Status Values