Skip to navigation

List workspace tickets

List agent issues across every agent in the workspace, ordered by most recently created first. Use this to build a workspace-wide view (for example, issues assigned to the caller). Supports the same filters, sorting and search as the per-agent endpoint. Issues for agents the caller cannot access are omitted.

Headers

xi-api-keystringOptional

Query parameters

page_sizeintegerOptional1-100Defaults to 100
How many agent issues to return. Can not exceed 100.
agent_idstring or nullOptional
Only issues for this agent.
statusenum or nullOptional
Filter agent issues by status.
Allowed values:
sourceslist of enums or nullOptional

Filter agent issues by how they were raised (qa, agent, manual). Repeat the parameter to filter by multiple sources.

Allowed values:
prioritieslist of enums or nullOptional
Filter agent issues by priority. Repeat the parameter to filter by multiple priorities.
Allowed values:
sort_byenumOptional

Order by most recently created, by priority (most urgent first, then most recently created), by most recently reported (the newest report merged into the agent issue, else its creation), or by report count (most reports merged into the agent issue first, then most recently created).

Allowed values:
owner_user_idstring or nullOptional

Filter agent issues by creator. Use ‘agent’ for agent-raised issues.

assignee_user_idstring or nullOptional
Filter agent issues by assignee. Use 'unassigned' for issues with no assignee.
labelstring or nullOptional
Filter agent issues by an exact label.
merged_into_ticket_idstring or nullOptional
Filter agent issues merged into this issue.
searchstring or nullOptional<=200 characters

Case-insensitive free-text search across the agent issue’s title, description, comments, and turn comments.

cursorstring or nullOptional
Used for fetching next page. Cursor is returned in the response.

Response

Successful Response
agent_conversation_ticketslist of objects
has_moreboolean
next_cursorstring or nullOptional

Errors

422
Unprocessable Entity Error