Skip to main content
MUTATION
conversationsChangeStatus(_ids: [String]!, status: ConversationStatus!, snoozedUntil: Date): [Conversation]

Arguments

_ids
[String]!
required

List of conversation IDs to update

status
ConversationStatus!
required

New status for the conversations

snoozedUntil
Date

Optional auto-reopen datetime (only used when status is 'snoozed'). Conversation will auto-reopen after this time.

Returns

[Conversation]
_id
String!
content
String

The latest text content or snippet of the conversation.

integrationId
String

The integration (channel) this conversation originated from.

customerId
String

The customer participating in this conversation.

departmentId
String

The department this conversation is routed to.

userId
String

The user/agent who created or owns this conversation.

assignedUserId
String

The user/agent currently assigned to handle this conversation.

participatedUserIds
[String]

User IDs of agents participating in this conversation.

readUserIds
[String]

User IDs of agents who have read this conversation.

createdAt
Date

When this conversation was created.

updatedAt
Date

When this conversation was last updated.

slaTime
Float

SLA elapsed idle time in minutes (time since customer started waiting for a response).

slaConfig
Float

Configured SLA threshold in minutes.

idleTime
Float

Idle time in minutes (deprecated — use slaTime).

idleTimeConfig
Float

Configured idle time threshold in minutes (deprecated — use slaConfig).

isCustomerRespondedLast
Boolean

Whether the customer sent the most recent message.

lastCustomerMessageAt
Date

Timestamp of the last customer message.

lastUserMessageAt
Date

Timestamp of the last agent message.

customerWaitingStartTime
Date

When the customer started waiting for a response.

averageResponseTime
Float

Average agent response time in seconds.

totalResponseTime
Float

Total cumulative response time in seconds.

responseCount
Int

Number of agent responses in this conversation.

status
String

Current workflow status: 'open', 'closed', 'pending', 'snoozed', or 'bot'.

snoozedUntil
Date

When a snoozed conversation will auto-reopen (null if indefinite or not snoozed).

messageCount
Int

Total number of messages in this conversation.

number
Int

Auto-incremented conversation number for display.

tagIds
[String]

Tag IDs applied to this conversation.

messages
[ConversationMessage]

The most recent message in this conversation, resolved from the appropriate service (inbox, whatsapp, facebook, etc.).

tags
[Tag]

Resolved tags applied to this conversation.

customer
Customer

The customer associated with this conversation.

integration
Integration

The integration (channel) this conversation came from.

user
User

The user/agent who owns this conversation.

assignedUser
User

The agent currently assigned to this conversation.

assignedDepartment
Department

The department this conversation is routed to.

participatedUsers
[User]

Users participating in this conversation.

readUsers
[User]

Users who have read this conversation.

participatorCount
Int

Number of participants in this conversation.

customFieldsData
JSON
Mutation
Variables
Response
Last modified on August 8, 2026

Related topics

conversationResolveAllconversationsConversationStatusStatusChangedPayloadconversationMessageUpdate