Skip to main content
POST
/
agents
/
{agentId}
/
execute
Execute Agent Task
curl --request POST \
  --url https://api.vexara.io/v1/agents/{agentId}/execute \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "task": "Analyze SOL price trends for the last 24h",
  "parameters": {
    "timeframe": "24h",
    "indicators": [
      "RSI",
      "MACD"
    ]
  },
  "priority": "normal"
}'
{
  "taskId": "task_xyz789",
  "status": "queued",
  "estimatedCompletion": 123,
  "cost": 123
}

Authorizations

​
Authorization
string
header
required

JWT Bearer token authentication. Include the token in the Authorization header

Path Parameters

​
agentId
string
required

Body

application/json
​
task
string
required
Example:

"Analyze SOL price trends for the last 24h"

​
parameters
object
Example:
{
  "timeframe": "24h",
  "indicators": ["RSI", "MACD"]
}
​
priority
enum<string>
default:normal
Available options:
low,
normal,
high

Response

200 - application/json

Task submitted successfully

​
taskId
string
Example:

"task_xyz789"

​
status
enum<string>
Available options:
queued,
processing,
completed,
failed
Example:

"queued"

​
estimatedCompletion
number

Estimated seconds until completion

​
cost
number

Cost in agent tokens