Skip to main content
Authenticated API

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

Agent Management

Register, configure, and manage AI agent lifecycle within the ACP Integration.

Register Agent​

Create a new AI agent registration.

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

Request Body:

{
  "name": "restaurant-assistant",
  "display_name": "Maximus Restaurant Assistant",
  "description": "AI assistant for restaurant operations",
  "agent_type": "conversational",
  "model_tier": "T4",
  "capabilities": ["order_management", "inventory_queries", "scheduling"],
  "config": {
    "max_tokens": 4096,
    "temperature": 0.7,
    "system_prompt": "You are Maximus, a helpful restaurant assistant..."
  },
  "metadata": {
    "version": "1.2.0",
    "owner": "operations-team"
  }
}

Response (201 Created):

{
  "agent_id": "agent_abc123",
  "name": "restaurant-assistant",
  "display_name": "Maximus Restaurant Assistant",
  "status": "testing",
  "created_at": "2026-01-19T14:30:00Z",
  "updated_at": "2026-01-19T14:30:00Z"
}

List Agents​

Retrieve all registered agents with optional filtering.

GET /acp/agents?status=active&agent_type=conversational

Query Parameters:

ParameterTypeDescription
statusstringFilter by status: testing, active, paused, deprecated, disabled
agent_typestringFilter by type: conversational, workflow, autonomous
limitintegerResults per page (default: 50, max: 100)
offsetintegerPagination offset

Response (200 OK):

{
  "agents": [
    {
      "agent_id": "agent_abc123",
      "name": "restaurant-assistant",
      "display_name": "Maximus Restaurant Assistant",
      "agent_type": "conversational",
      "status": "active",
      "model_tier": "T4",
      "capabilities": ["order_management", "inventory_queries"],
      "created_at": "2026-01-19T14:30:00Z"
    }
  ],
  "total": 12,
  "limit": 50,
  "offset": 0
}

Get Agent Details​

Retrieve detailed information about a specific agent.

GET /acp/agents/{agent_id}

Response (200 OK):

{
  "agent_id": "agent_abc123",
  "name": "restaurant-assistant",
  "display_name": "Maximus Restaurant Assistant",
  "description": "AI assistant for restaurant operations",
  "agent_type": "conversational",
  "status": "active",
  "model_tier": "T4",
  "capabilities": [
    {
      "capability_id": "cap_order_mgmt",
      "name": "order_management",
      "permission_level": "execute"
    }
  ],
  "enabled_tools": [
    {
      "tool_id": "tool_create_order",
      "name": "create_order",
      "enabled_at": "2026-01-15T10:00:00Z"
    }
  ],
  "config": {
    "max_tokens": 4096,
    "temperature": 0.7,
    "system_prompt": "You are Maximus..."
  },
  "stats": {
    "total_requests": 15420,
    "requests_today": 342,
    "avg_latency_ms": 1250,
    "error_rate": 0.02
  },
  "created_at": "2026-01-19T14:30:00Z",
  "updated_at": "2026-01-19T16:45:00Z"
}

Update Agent​

Update agent configuration.

PUT /acp/agents/{agent_id}
Content-Type: application/json

Request Body:

{
  "display_name": "Maximus Restaurant Assistant v2",
  "description": "Updated AI assistant with voice support",
  "model_tier": "T5",
  "config": {
    "max_tokens": 8192,
    "temperature": 0.8
  }
}

Update Agent Status​

Change agent operational status.

POST /acp/agents/{agent_id}/status
Content-Type: application/json

Request Body:

{
  "status": "active",
  "reason": "Passed QA testing, promoting to production"
}

Valid Status Values:

StatusDescription
testingAgent under development/testing
activeAgent live and serving requests
pausedTemporarily disabled
deprecatedScheduled for removal
disabledPermanently disabled

Delete Agent​

Soft-delete an agent (marks as deleted but retains data).

DELETE /acp/agents/{agent_id}

Response (200 OK):

{
  "agent_id": "agent_abc123",
  "status": "deleted",
  "deleted_at": "2026-01-19T18:00:00Z"
}