POST
/
v1
/
agents
/
run
/
default
/
{agent_type}
/
async
curl --request POST \
  --url https://api.roe-ai.com/v1/agents/run/default/{agent_type}/async/ \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data 'task/prompt=<string>'
"123e4567-e89b-12d3-a456-426614174000"

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
agent_type
enum<string>
required

Type of default agent to run. For classification, agent inputs must include 'task' and 'target'. For extraction, agent inputs must include 'prompt' and 'target'.

Available options:
classification,
extraction

Body

​
task/prompt
string

Prompt for the agent to generate output; can be a file or a string

Minimum length: 1
​
target
file

Target data for the agent to process; can be a file or a string

Response

200
application/json
Agent job ID

The response is of type string.