latestOpenAPI 3.1.02026-08-221163801019.2 KB

f0f28319e448

Conversation

Get conversations

Retrieve conversations in an organization based on supplied filters.

Permissions

This endpoint may be impacted by the following permissions:

  • The final_message field in the response is only non-empty if the authenticated user has the Conversation.GetMessage permission on the final message.
  • The version_set_info field in the response is only non-empty if the authenticated user has the Service.GetVersionSet permission on the version set.
  • Only conversations for which the user has the Conversation.GetConversation permission are returned.
get/v1/{organization}/conversation/

Path parameters

organizationstring required

Query parameters

user_idstring[]

The identifier of the user whose conversations to retrieve.

The identifier of the user whose conversations to retrieve.

service_idstring[]

The identifier of the service whose conversation to retrieve.

The identifier of the service whose conversation to retrieve.

is_finishedboolean nullable

Whether the conversation is finished.

Whether the conversation is finished.

idstring[]

The ID of the conversation to retrieve.

The ID of the conversation to retrieve.

limitinteger

The maximum number of conversations to retrieve.

The maximum number of conversations to retrieve.

continuation_tokeninteger

The continuation token returned from the previous response to retrieve the next set of conversations.

The continuation token returned from the previous response to retrieve the next set of conversations.

sort_bystring[]

The field to sort the conversations by. Supported fields are created_at. Specify a + before the field name to indicate ascending sorting and - for descending sorting. Multiple fields can be specified to break ties.

The field to sort the conversations by. Supported fields are created_at. Specify a + before the field name to indicate ascending sorting and - for descending sorting. Multiple fields can be specified to break ties.

tagstring[]

The tags of the dynamic behavior sets. Must be specified using the syntax key:value, which means to match all sets with the given key and value pair among its tags. If value is *, it means the value does not matter. If value is empty, it matches against when the value is None.

The tags of the dynamic behavior sets. Must be specified using the syntax key:value, which means to match all sets with the given key and value pair among its tags. If value is *, it means the value does not matter. If value is empty, it matches against when the value is None.

Headers

x-mongo-cluster-namestring nullable

The Mongo cluster name to perform this request in. This is usually not needed unless the organization does not exist yet in the Amigo organization infra config database.

The Mongo cluster name to perform this request in. This is usually not needed unless the organization does not exist yet in the Amigo organization infra config database.

Sec-WebSocket-Protocolstring[]

Response

Succeeded.

has_moreboolean required

Whether there are more conversations to retrieve.

continuation_tokeninteger nullable required

A token to supply to the next request to retrieve the next page of conversations. Only populated if has_more is True.