API Overview
Agent Sessions API
Parameters full description
Note
You can find below the full description of Parameters for each POST/GET/DELETE methods and also what parameters you can expect from the API responses.
If you want to play with the API, please see the Agent sessions API playground.
If you want to play with the API, please see the Agent sessions API playground.
POST - Create a new agentSession
POST - Create a new agentSession
Parameters:
agentUid String
Uid of the agent to link toexternalUserId String
User Id from external systemuserEmail String
email address format user identifier. Deprecated. Prefer using externalId instead.tags String[]
Array of tags (max 10). You will be able to view reports based grouping or filtering of activity according to the tags applied when creating the session.contextUids String[]
Array of existing context Uids (max 30)mcpserverUids String[]
Array of existing mcpserver Uids (max 5)GET - Query the list of agentSessions
GET - Query the list of agentSessions
Parameters:
startAfter - Querying for “the next page” String
Use thestartAfter parameter and provide the createdAt string of the last agent session in the current results set
When there are no more results you will receive an empty array in the response and a 404 status codeexternalUserId String
Filter results to a specific externalUserIduserEmail String
Filter results to a specific email address format user identifier. Deprecated. Prefer using externalId.contextUid String
Filter results to a specific contextUidagentUid String
Filter results to a specific agentUidDELETE - Delete an agentSession by providing its uid
DELETE - Delete an agentSession by providing its uid
RESPONSE DATA
RESPONSE DATA
You will get the same response data when calling POST or GET.Note: When retrieving a collection of agentSessions, the response will be an array of objects.