Pause agent
Endpoint
Section titled “Endpoint”POST /v1/agents/{id}/pause
Authentication
Section titled “Authentication”Requires Bearer token authentication.
Path Parameters
Section titled “Path Parameters”| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Agent ID (UUID or numeric ID like AG-001) |
cURL Example
Section titled “cURL Example”curl -X POST "https://api.sapiom.ai/v1/agents/:id/pause" \ -H "Authorization: Bearer YOUR_API_KEY"Response
Section titled “Response”Error Responses
Section titled “Error Responses”| Status | Code | Description |
|---|---|---|
| 400 | - | Agent not found or not in active status |
| 401 | - | Unauthorized - invalid or missing JWT token |
| 403 | - | Forbidden - insufficient permissions |
| 404 | - | Agent not found |
See Error Codes for full reference.