curl -X PATCH https://api.wirebox.sh/api/v1/identities/eva \
-H "Authorization: Bearer $WIREBOX_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"display_name": "Eva Senior Support",
"description": "Escalated support and billing queries"
}'
{
"id": "ident_01J8ABC123XYZ",
"agent_handle": "eva",
"display_name": "Eva Senior Support",
"description": "Escalated support and billing queries",
"mailbox_address": "eva@wireboxmail.com",
"created_at": "2026-09-11T10:00:00Z",
"updated_at": "2026-09-11T10:30:00Z"
}
Agent Identities
Update Agent Identity
Update display name or description for an existing agent identity.
PATCH
/
api
/
v1
/
identities
/
{handle}
curl -X PATCH https://api.wirebox.sh/api/v1/identities/eva \
-H "Authorization: Bearer $WIREBOX_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"display_name": "Eva Senior Support",
"description": "Escalated support and billing queries"
}'
{
"id": "ident_01J8ABC123XYZ",
"agent_handle": "eva",
"display_name": "Eva Senior Support",
"description": "Escalated support and billing queries",
"mailbox_address": "eva@wireboxmail.com",
"created_at": "2026-09-11T10:00:00Z",
"updated_at": "2026-09-11T10:30:00Z"
}
Path Parameters
string
required
The agent handle (e.g.
eva).Body Parameters
string
Updated display name.
string
Updated description.
curl -X PATCH https://api.wirebox.sh/api/v1/identities/eva \
-H "Authorization: Bearer $WIREBOX_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"display_name": "Eva Senior Support",
"description": "Escalated support and billing queries"
}'
{
"id": "ident_01J8ABC123XYZ",
"agent_handle": "eva",
"display_name": "Eva Senior Support",
"description": "Escalated support and billing queries",
"mailbox_address": "eva@wireboxmail.com",
"created_at": "2026-09-11T10:00:00Z",
"updated_at": "2026-09-11T10:30:00Z"
}