API reference
Request an agent action
Submits an agent tool action for approval or auto-allows read-only tools. Returns pending_approval if the action requires manual review.
POST
/v1/agent/actionsAuthorization
bearerAuth AuthorizationBearer <token>
Paste your API key from the dashboard (no sk_ prefix required).
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/agent/actions" \ -H "Content-Type: application/json" \ -d '{ "agent_session_id": "string", "tool": "get_order", "input": { "property1": null, "property2": null } }'{
"decision": "auto_allowed",
"actionId": "string"
}{
"statusCode": -9007199254740991,
"message": "string",
"error": "string"
}{
"statusCode": -9007199254740991,
"message": "string",
"error": "string"
}{
"statusCode": -9007199254740991,
"message": "string",
"error": "string"
}{
"statusCode": -9007199254740991,
"message": "string",
"error": "string"
}