support_tickets_read
Arguments
String
Forward pagination cursor — returns tickets after it.
[ID!]
Tickets assigned to any of these team members, at most 100.
assigneeIds, assigneeTypes and includeUnassigned match as one OR.Tickets with any of these kinds of assignee. Matches with
assigneeIds and includeUnassigned as one OR.String
Backward pagination cursor — returns tickets before it.
On any of these channels.
ID
The customer’s id or legacy id. Requires customers_read.
[ID!]
Has none of these tags, at most 100.
Int
Forward pagination: returns the first N tickets (max 100, default 25). Use with
after; mutually exclusive with last/before.Boolean
Also match tickets with no assignee. Matches with
assigneeIds and assigneeTypes as one OR.Int
Backward pagination: returns the last N tickets (max 100, default 25). Use with
before; mutually exclusive with first/after.Default LAST_RESPONSE_AT, newest first.
String
The inbox search: message and subject words, the customer’s name, email or phone, order numbers. At most 200 characters. Keeps the
orderBy order.Boolean
Reverses the order of
orderBy. Tickets with no value for it stay last either way.Any of these. Omitted or empty: every status.
[ID!]
Has any of these tags, at most 100.
Returns
required
A paginated list of SupportTicket items.
Show fields
Show fields
required
The list of edges (each a node plus its pagination
cursor).Show fields
Show fields
String!
required
Opaque cursor for this item; pass to
after/before to page from here.required
The item at this edge.
Show fields
Show fields
The team member the ticket is assigned to. Null unless
assigneeType is TEAM_MEMBER, and null when they’ve left the team.Requires: support_tickets_readWhat kind of assignee the ticket has. Null when unassigned.
required
Every channel the ticket’s threads are on, each once, in no set order. Detached threads are left out, as in
threads.Why the ticket was closed. Null unless
status is CLOSED.How the customer seems to feel, from the AI’s read of the ticket. Null until it has one.
String
The text of the team’s most recently edited unsent reply, on any of the ticket’s threads. Null when there’s no draft.
ID!
required
The id of this ticket.
required
The tickets merged directly into this one, oldest first.Requires:
support_tickets_readShow fields
Show fields
Arguments
String
Forward pagination cursor — returns tickets after it.
String
Backward pagination cursor — returns tickets before it.
Int
Forward pagination: returns the first N tickets (max 100, default 25). Use with
after; mutually exclusive with last/before.Int
Backward pagination: returns the last N tickets (max 100, default 25). Use with
before; mutually exclusive with first/after.required
The ticket’s messages, oldest first, internal notes included. Messages of tickets merged into it stay on those tickets. A thread can hold messages from other tickets, which this leaves out;
thread.messages has them all.Requires: support_tickets_readShow fields
Show fields
Arguments
String
Forward pagination cursor — returns messages after it.
String
Backward pagination cursor — returns messages before it.
Int
Forward pagination: returns the first N messages (max 100, default 25). Use with
after; mutually exclusive with last/before.Int
Backward pagination: returns the last N messages (max 100, default 25). Use with
before; mutually exclusive with first/after.required
How urgent the ticket is.
required
Where the ticket is in its lifecycle.
String
The AI’s summary of the ticket. Null until one has been written.
required
The tags on the ticket, ordered by name.Requires:
support_tickets_readShow fields
Show fields
Arguments
String
Forward pagination cursor — returns tags after it.
String
Backward pagination cursor — returns tags before it.
Int
Forward pagination: returns the first N tags (max 100, default 25). Use with
after; mutually exclusive with last/before.Int
Backward pagination: returns the last N tags (max 100, default 25). Use with
before; mutually exclusive with first/after.required
The threads the ticket’s conversation is on, oldest first.Requires:
support_tickets_readShow fields
Show fields
Arguments
String
Forward pagination cursor — returns threads after it.
String
Backward pagination cursor — returns threads before it.
Int
Forward pagination: returns the first N threads (max 100, default 25). Use with
after; mutually exclusive with last/before.Int
Backward pagination: returns the last N threads (max 100, default 25). Use with
before; mutually exclusive with first/after.Int
The ticket number the help desk shows, unique within the store. Null for some older tickets.
required
What happened on the ticket, oldest first.Requires:
support_tickets_readShow fields
Show fields
Arguments
String
Forward pagination cursor — returns events after it.
String
Backward pagination cursor — returns events before it.
Int
Forward pagination: returns the first N events (max 100, default 25). Use with
after; mutually exclusive with last/before.Int
Backward pagination: returns the last N events (max 100, default 25). Use with
before; mutually exclusive with first/after.Boolean!
required
Whether the customer wrote after the team last read the ticket. False when the customer hasn’t written.
required
The nodes in this page, without the edge/cursor wrapper — a convenience over
edges.Show fields
Show fields
The team member the ticket is assigned to. Null unless
assigneeType is TEAM_MEMBER, and null when they’ve left the team.Requires: support_tickets_readShow fields
Show fields
String
Email address. Null when the user has none.
ID!
required
m_us_… id, the same id the app and MCP tools use.
String
Display name. Null when the user hasn’t set one.
required
The agent’s live shift status, worked out when the request runs.Requires:
support_config_readrequired
The agent’s support working hours. An agent with no saved schedule returns enabled false.Requires:
team_members_manageWhat kind of assignee the ticket has. Null when unassigned.
required
Every channel the ticket’s threads are on, each once, in no set order. Detached threads are left out, as in
threads.Why the ticket was closed. Null unless
status is CLOSED.How the customer seems to feel, from the AI’s read of the ticket. Null until it has one.
String
The text of the team’s most recently edited unsent reply, on any of the ticket’s threads. Null when there’s no draft.
ID!
required
The id of this ticket.
required
The tickets merged directly into this one, oldest first.Requires:
support_tickets_readShow fields
Show fields
Arguments
String
Forward pagination cursor — returns tickets after it.
String
Backward pagination cursor — returns tickets before it.
Int
Forward pagination: returns the first N tickets (max 100, default 25). Use with
after; mutually exclusive with last/before.Int
Backward pagination: returns the last N tickets (max 100, default 25). Use with
before; mutually exclusive with first/after.required
The ticket’s messages, oldest first, internal notes included. Messages of tickets merged into it stay on those tickets. A thread can hold messages from other tickets, which this leaves out;
thread.messages has them all.Requires: support_tickets_readShow fields
Show fields
ArgumentsFields
String
Forward pagination cursor — returns messages after it.
String
Backward pagination cursor — returns messages before it.
Int
Forward pagination: returns the first N messages (max 100, default 25). Use with
after; mutually exclusive with last/before.Int
Backward pagination: returns the last N messages (max 100, default 25). Use with
before; mutually exclusive with first/after.required
The list of edges (each a node plus its pagination
cursor).required
The nodes in this page, without the edge/cursor wrapper — a convenience over
edges.required
How urgent the ticket is.
required
Where the ticket is in its lifecycle.
String
The AI’s summary of the ticket. Null until one has been written.
required
The tags on the ticket, ordered by name.Requires:
support_tickets_readShow fields
Show fields
ArgumentsFields
String
Forward pagination cursor — returns tags after it.
String
Backward pagination cursor — returns tags before it.
Int
Forward pagination: returns the first N tags (max 100, default 25). Use with
after; mutually exclusive with last/before.Int
Backward pagination: returns the last N tags (max 100, default 25). Use with
before; mutually exclusive with first/after.required
The list of edges (each a node plus its pagination
cursor).required
The nodes in this page, without the edge/cursor wrapper — a convenience over
edges.required
The threads the ticket’s conversation is on, oldest first.Requires:
support_tickets_readShow fields
Show fields
ArgumentsFields
String
Forward pagination cursor — returns threads after it.
String
Backward pagination cursor — returns threads before it.
Int
Forward pagination: returns the first N threads (max 100, default 25). Use with
after; mutually exclusive with last/before.Int
Backward pagination: returns the last N threads (max 100, default 25). Use with
before; mutually exclusive with first/after.required
The list of edges (each a node plus its pagination
cursor).required
The nodes in this page, without the edge/cursor wrapper — a convenience over
edges.Int
The ticket number the help desk shows, unique within the store. Null for some older tickets.
required
What happened on the ticket, oldest first.Requires:
support_tickets_readShow fields
Show fields
ArgumentsFields
String
Forward pagination cursor — returns events after it.
String
Backward pagination cursor — returns events before it.
Int
Forward pagination: returns the first N events (max 100, default 25). Use with
after; mutually exclusive with last/before.Int
Backward pagination: returns the last N events (max 100, default 25). Use with
before; mutually exclusive with first/after.required
The list of edges (each a node plus its pagination
cursor).required
The nodes in this page, without the edge/cursor wrapper — a convenience over
edges.Boolean!
required
Whether the customer wrote after the team last read the ticket. False when the customer hasn’t written.
Pagination metadata for the current page.
Show fields
Show fields
String
Cursor of the last edge in this page; pass to
after to page forward.Boolean!
required
Whether more items exist after this page (drives forward pagination with
first/after).Boolean!
required
Whether more items exist before this page (drives backward pagination with
last/before).String
Cursor of the first edge in this page; pass to
before to page backward.Example
query {
supportTickets(after: "...", assigneeIds: "...", assigneeTypes: AI_AGENT, before: "...", channels: ATTENTIVE, closedAfter: "...", closedBefore: "...", createdAfter: "...", createdBefore: "...", customerId: "...", excludedTagIds: "...", first: 10, includeUnassigned: true, last: 10, lastResponseAfter: "...", lastResponseBefore: "...", orderBy: CLOSED_AT, query: "...", reverse: true, statuses: ARCHIVED, tagIds: "...") {
nodes {
assigneeType
channels
closureReason
createdAt
customerSentiment
draftPreview
id
lastCustomerMessageAt
# ...
}
pageInfo { hasNextPage endCursor }
}
}