agents
Create Agent Run
Create a new agent run.
Creates and initiates a long-running agent process based on the provided prompt. The process will complete asynchronously, and the response contains the agent run ID which can be used to check the status later. The requesting user must be a member of the specified organization.
This endpoint accepts both a text prompt and an optional image file upload.
Rate limit: 10 requests per minute.
POST
Headers
Path Parameters
Body
application/json
Response
200
application/json
Successful Response
Represents an agent run in API responses
Previous
Get Agent RunRetrieve the status and result of an agent run.
Returns the current status, progress, and any available results for the specified agent run.
The agent run must belong to the specified organization. If the agent run is still in progress,
this endpoint can be polled to check for completion.
Rate limit: 60 requests per 30 seconds.
Next