Suspend Agent
Suspend an active agent to immediately block all new transactions.
POST/agents/{agent_id}/suspend
Suspend an active agent. Suspended agents cannot execute transactions.
Requires API key authentication
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| agent_id | string | required | The agent’s unique identifier |
Suspending an agent immediately blocks all new transactions. Existing pending transactions will be rejected.
Response
Returns the agent object with the updated status.
Response — 200 OK
{ "id": "agent_7f3k9x2m", "name": "Trading Agent Alpha", "fingerprint": "sha256:a1b2c3d4e5f6...", "environment": "production", "status": "suspended", "authorized_actions": ["execute_trades"], "spending_limit": 50000, "currency": "USD", "org_id": "org_abc123", "owner_id": "user_xyz789", "created_at": "2025-01-15T10:30:00Z", "suspended_at": "2025-03-20T16:45:00Z"}Examples
BASH
curl -X POST https://api.alsorn.com/agents/agent_7f3k9x2m/suspend \ -H "Authorization: Bearer YOUR_API_KEY"