> For the complete documentation index, see [/llms.txt](/llms.txt).

> Source: /api/agents/jobs/create-job

# Create job

Run an agent with specific input files.

OpenAPI spec: `./openapi/openapi-agent.yaml`

- `POST /responses`

<br />

## Response

**The response object**

<table><tbody><tr><td><strong>id</strong> string<br />A unique identifier for the job.</td></tr><tr><td><strong>object</strong> string <br />The object type, which is always <code>response</code>.</td></tr><tr><td><strong>created\_at</strong> integer<br />The Unix timestamp (in seconds) of when the job was created.</td></tr><tr><td><strong>status</strong> string<br />The current status of the job. Options: <code>queued</code>, <code>in\_progress</code>, <code>completed</code>, <code>failed</code>.</td></tr><tr><td><strong>model</strong> string<br />The Agent ID being used.</td></tr><tr><td><strong>output</strong> list<br />A list of output items from the agent.</td></tr><tr><td><strong>usage</strong> object<br />Token usage statistics for the job.</td></tr><tr><td><strong>usage.input\_tokens</strong> integer<br />Number of tokens used in the input.</td></tr><tr><td><strong>usage.output\_tokens</strong> integer<br />Number of tokens used in the output.</td></tr><tr><td><strong>usage.total\_tokens</strong> integer<br />Total number of tokens used.</td></tr></tbody></table>

## Example

### Request

_Request/response examples: agent-jobs / request / create_

### Response

_Request/response examples: agent-jobs / response-200 / create_