Update agent
Endpoint
Section titled “Endpoint”PATCH /v1/agents/{id}
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) |
Request Body
Section titled “Request Body”{ "label": "Marketing Automation Bot", "description": "Handles automated email campaigns and newsletter distribution"}cURL Example
Section titled “cURL Example”curl -X PATCH "https://api.sapiom.ai/v1/agents/{id}" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "label": "Marketing Automation Bot", "description": "Handles automated email campaigns and newsletter distribution"}'Response
Section titled “Response”Error Responses
Section titled “Error Responses”| Status | Code | Description |
|---|---|---|
| 400 | - | Invalid request data or agent not found |
| 401 | - | Unauthorized - invalid or missing JWT token |
| 403 | - | Forbidden - insufficient permissions |
| 404 | - | Agent not found |
See API Introduction for error handling details.