Skip to main content
Authenticated API

ACP (AI Cost & Performance) endpoints require a valid JWT Bearer token. Accessible via the API gateway.

Capability Management

Capabilities define what an agent can do at a high level. Use capabilities to organize and control agent permissions.

Register Capability​

POST /acp/capabilities
Content-Type: application/json

Request Body:

{
  "name": "inventory_management",
  "display_name": "Inventory Management",
  "description": "Ability to query and modify inventory levels",
  "category": "operations",
  "risk_level": "medium",
  "requires_approval": true,
  "approval_threshold": "high_value",
  "related_tools": ["query_inventory", "update_stock", "create_order_request"]
}

Response (201 Created):

{
  "capability_id": "cap_inv_mgmt",
  "name": "inventory_management",
  "display_name": "Inventory Management",
  "category": "operations",
  "risk_level": "medium",
  "created_at": "2026-01-19T14:30:00Z"
}

List Capabilities​

GET /acp/capabilities?category=operations

Query Parameters:

ParameterTypeDescription
categorystringFilter by category: operations, commerce, analytics, admin

Response (200 OK):

{
  "capabilities": [
    {
      "capability_id": "cap_order_mgmt",
      "name": "order_management",
      "display_name": "Order Management",
      "category": "commerce",
      "risk_level": "medium",
      "requires_approval": false
    },
    {
      "capability_id": "cap_inv_mgmt",
      "name": "inventory_management",
      "display_name": "Inventory Management",
      "category": "operations",
      "risk_level": "medium",
      "requires_approval": true
    }
  ],
  "total": 15
}

Get Capability Details​

GET /acp/capabilities/{capability_id}

Response (200 OK):

{
  "capability_id": "cap_inv_mgmt",
  "name": "inventory_management",
  "display_name": "Inventory Management",
  "description": "Ability to query and modify inventory levels",
  "category": "operations",
  "risk_level": "medium",
  "requires_approval": true,
  "approval_threshold": "high_value",
  "related_tools": [
    {
      "tool_id": "tool_query_inv",
      "name": "query_inventory"
    },
    {
      "tool_id": "tool_update_stock",
      "name": "update_stock"
    }
  ],
  "agents_with_capability": 3,
  "created_at": "2026-01-19T14:30:00Z"
}