Skip to content
TapPass

Agents

Register and manage AI agents.

POST /agents

Section titled “POST /agents”

Register a new agent.

Terminal window
curl -X POST http://localhost:9620/agents \
  -H "Authorization: Bearer tp_admin_..." \
  -H "Content-Type: application/json" \
  -d '{"agent_id": "my-agent", "framework": "crewai"}'

Returns an API key (shown once).

GET /agents

Section titled “GET /agents”

List all agents in the org.

GET /agents/{agent_id}

Section titled “GET /agents/{agent_id}”

Get agent details including health score, trust tier, and pipeline assignment.

GET /agents/{agent_id}/health

Section titled “GET /agents/{agent_id}/health”

Health score (0–100) across 5 dimensions: compliance, data safety, security, pact adherence, efficiency.

GET /agents/{agent_id}/drift

Section titled “GET /agents/{agent_id}/drift”

Behavioral drift detection across 8 signals.

PUT /agents/{agent_id}/pact

Section titled “PUT /agents/{agent_id}/pact”

Set a behavioral pact. See the pacts guide.

DELETE /agents/{agent_id}

Section titled “DELETE /agents/{agent_id}”

Deactivate an agent.