Approvers
Configure the default approver list for human-in-the-loop authorization flows.
Overview
The Approvers API manages your organization's default approver list. Approvers are email addresses of people who can approve or reject agent actions in human approval flows. All endpoints require admin privileges.
List Approvers
GET /api/v1/approvers
Authorization: Bearer aira_live_xxxxxReturns the current list of default approver email addresses for your organization. Requires admin privileges.
Example Response
{
"approvers": [
"alice@example.com",
"bob@example.com"
],
"request_id": "req_01J8X..."
}Response Fields
| Field | Type | Description |
|---|---|---|
approvers | array | List of approver email addresses |
request_id | string | Unique request identifier for support reference |
Add Approver
POST /api/v1/approvers
Authorization: Bearer aira_live_xxxxxAdds an email address to the default approver list. Returns 409 Conflict if the email is already an approver. Requires admin privileges.
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
email | string | Yes | A valid email address to add as an approver |
Example Request
curl -X POST https://api.aira.com/api/v1/approvers \
-H "Authorization: Bearer aira_live_xxxxx" \
-H "Content-Type: application/json" \
-d '{ "email": "alice@example.com" }'Example Response
{
"approvers": [
"alice@example.com"
],
"request_id": "req_01J8X..."
}Response Fields
| Field | Type | Description |
|---|---|---|
approvers | array | The updated list of all approver email addresses |
request_id | string | Unique request identifier for support reference |
Error Responses
| Status | Code | Description |
|---|---|---|
409 | Conflict | The email address is already in the approver list |
Remove Approver
DELETE /api/v1/approvers/{email}
Authorization: Bearer aira_live_xxxxxRemoves an email address from the default approver list. Returns 404 Not Found if the email is not in the list. Requires admin privileges. Returns 204 No Content on success.
Path Parameters
| Parameter | Type | Description |
|---|---|---|
email | string | The approver email address to remove |
Example Request
curl -X DELETE https://api.aira.com/api/v1/approvers/alice@example.com \
-H "Authorization: Bearer aira_live_xxxxx"A successful deletion returns 204 No Content with an empty response body.
Error Responses
| Status | Code | Description |
|---|---|---|
404 | Not Found | The email address is not in the approver list |