Actions

Types action

Types action. Authenticate with a bearer API key that includes the required scope. Resources that belong to another account return 404 NOT_FOUND. Mutations accept Idempotency-Key and emit a webhook event when they succeed.

Required scopeactions:read

curl -X GET https://api.agentency.com/v1/actions/types \
  -H "Authorization: Bearer <YOUR_KEY>" \
  -H "Content-Type: application/json"

List actions

List actions. Authenticate with a bearer API key that includes the required scope. Resources that belong to another account return 404 NOT_FOUND. Mutations accept Idempotency-Key and emit a webhook event when they succeed.

Required scopeactions:read

{
  "object": "list",
  "data": [
    {
      "object": "action",
      "id": 1,
      "chatbot_id": 1,
      "type": "button",
      "name": "accusantium fuga",
      "tool_name": "act__qfrjklkyay",
      "description": "Use this when Maiores porro ab similique ea molestias quos.",
      "enabled": true,
      "is_high_risk": false,
      "config": {
        "parameters": []
      },
      "has_credentials": false,
      "run_count": 0,
      "success_count": 0,
      "success_rate": null,
      "last_run_at": null,
      "created_at": "2026-01-01T00:00:00+00:00",
      "updated_at": "2026-01-01T00:00:00+00:00"
    }
  ],
  "has_more": false,
  "next_cursor": null,
  "previous_cursor": null,
  "url": "/v1/actions"
}

curl -X GET https://api.agentency.com/v1/actions \
  -H "Authorization: Bearer <YOUR_KEY>" \
  -H "Content-Type: application/json"

Create a action

Create a action. Authenticate with a bearer API key that includes the required scope. Resources that belong to another account return 404 NOT_FOUND. Mutations accept Idempotency-Key and emit a webhook event when they succeed.

Required scopeactions:write

curl -X POST https://api.agentency.com/v1/actions \
  -H "Authorization: Bearer <YOUR_KEY>" \
  -H "Content-Type: application/json"
  -d '{
  "chatbot_id": 1,
  "type": "type",
  "name": "name",
  "description": "description",
  "tool_name": "tool_name",
  "enabled": true,
  "is_high_risk": true,
  "max_iterations": "max_iterations"
}'

Retrieve a action

Retrieve a action. Authenticate with a bearer API key that includes the required scope. Resources that belong to another account return 404 NOT_FOUND. Mutations accept Idempotency-Key and emit a webhook event when they succeed.

Required scopeactions:read

{
  "object": "action",
  "id": 1,
  "chatbot_id": 1,
  "type": "button",
  "name": "accusantium fuga",
  "tool_name": "act__qfrjklkyay",
  "description": "Use this when Maiores porro ab similique ea molestias quos.",
  "enabled": true,
  "is_high_risk": false,
  "config": {
    "parameters": []
  },
  "has_credentials": false,
  "run_count": 0,
  "success_count": 0,
  "success_rate": null,
  "last_run_at": null,
  "created_at": "2026-01-01T00:00:00+00:00",
  "updated_at": "2026-01-01T00:00:00+00:00"
}

curl -X GET https://api.agentency.com/v1/actions/{id} \
  -H "Authorization: Bearer <YOUR_KEY>" \
  -H "Content-Type: application/json"

Update a action

Update a action. Authenticate with a bearer API key that includes the required scope. Resources that belong to another account return 404 NOT_FOUND. Mutations accept Idempotency-Key and emit a webhook event when they succeed.

Required scopeactions:write

curl -X PATCH https://api.agentency.com/v1/actions/{id} \
  -H "Authorization: Bearer <YOUR_KEY>" \
  -H "Content-Type: application/json"
  -d '{
  "name": "name",
  "description": "description",
  "enabled": true,
  "is_high_risk": true,
  "max_iterations": "max_iterations",
  "config": "config",
  "credentials": "credentials"
}'

Delete a action

Delete a action. Authenticate with a bearer API key that includes the required scope. Resources that belong to another account return 404 NOT_FOUND. Mutations accept Idempotency-Key and emit a webhook event when they succeed.

Required scopeactions:write

curl -X DELETE https://api.agentency.com/v1/actions/{id} \
  -H "Authorization: Bearer <YOUR_KEY>" \
  -H "Content-Type: application/json"

Runs action

Runs action. Authenticate with a bearer API key that includes the required scope. Resources that belong to another account return 404 NOT_FOUND. Mutations accept Idempotency-Key and emit a webhook event when they succeed.

Required scopeactions:read

{
  "object": "list",
  "data": [
    {
      "object": "action_run",
      "id": 1,
      "action_id": 1,
      "status": "success",
      "created_at": "2026-01-01T00:00:00+00:00"
    }
  ],
  "has_more": false,
  "next_cursor": null,
  "previous_cursor": null,
  "url": "/v1/actions/1/runs"
}

curl -X GET https://api.agentency.com/v1/actions/{id}/runs \
  -H "Authorization: Bearer <YOUR_KEY>" \
  -H "Content-Type: application/json"

Chatbot runs action

Chatbot runs action. Authenticate with a bearer API key that includes the required scope. Resources that belong to another account return 404 NOT_FOUND. Mutations accept Idempotency-Key and emit a webhook event when they succeed.

Required scopeactions:read

curl -X GET https://api.agentency.com/v1/chatbots/{id}/action_runs \
  -H "Authorization: Bearer <YOUR_KEY>" \
  -H "Content-Type: application/json"

Test action

Test action. Authenticate with a bearer API key that includes the required scope. Resources that belong to another account return 404 NOT_FOUND. Mutations accept Idempotency-Key and emit a webhook event when they succeed. A `message` probe runs a real, billed model completion: it is 402 `CHATBOT_BUDGET_EXCEEDED` / `USER_BUDGET_EXCEEDED` when the monthly AI budget is spent and 402 `MESSAGE_CREDITS_EXCEEDED` when the account has no message credits left. An explicit-`arguments` dry run is never billing-gated. 404 `ACTIONS_DISABLED` while Call Actions are switched off platform-wide.

Required scopeactions:write

curl -X POST https://api.agentency.com/v1/actions/{id}/test \
  -H "Authorization: Bearer <YOUR_KEY>" \
  -H "Content-Type: application/json"
  -d '{
  "message": "message",
  "arguments": "arguments"
}'

Discover mcp action

Discover mcp action. Authenticate with a bearer API key that includes the required scope. Resources that belong to another account return 404 NOT_FOUND. Mutations accept Idempotency-Key and emit a webhook event when they succeed.

Required scopeactions:write

curl -X POST https://api.agentency.com/v1/actions/mcp/discover \
  -H "Authorization: Bearer <YOUR_KEY>" \
  -H "Content-Type: application/json"
  -d '{
  "server_url": "server_url",
  "token": "token"
}'