Jump to
Agent Identity API
An Agent Identity is a logical grouping of communication channels (email, phone) that an AI agent operates under. Each identity has a unique handle within your organization, and you can assign a mailbox and/or phone number to it — giving your agent a unified presence across channels.
API base URL:
https://api.inkbox.ai/api/v1/identitiesQuick start
Create an account and get your service token from the Inkbox console:
Get service tokenAll API requests require authentication using a service token:
X-Service-Token: YOUR_SERVICE_TOKENIdentities
Create identity
POSTCreate a new agent identity with a unique handle
/api/v1/identitiesList identities
GETList all identities for your organization
/api/v1/identitiesGet identity
GETGet a single identity with its linked channels
/api/v1/identities/{agent_handle}Update identity
PATCHUpdate an identity's handle or status
/api/v1/identities/{agent_handle}Delete identity
DELETEDelete an identity and unlink its channels
/api/v1/identities/{agent_handle}Channel assignment
Assign mailbox
POSTLink a mailbox to an identity
/api/v1/identities/{agent_handle}/mailboxUnlink mailbox
DELETERemove the mailbox from an identity
/api/v1/identities/{agent_handle}/mailboxAssign phone number
POSTLink a phone number to an identity
/api/v1/identities/{agent_handle}/phone_numberUnlink phone number
DELETERemove the phone number from an identity
/api/v1/identities/{agent_handle}/phone_number