Sign in
Conversations

List archived conversations

Retrieve all archived conversations for the authenticated user.

Overview:

Archived conversations are hidden from the main list but preserved for reference. This endpoint returns only conversations where isArchived: true and archivedBy is set. Results include conversations the caller owns and those shared with them.

Filtering and sorting:

Results can be narrowed using search, shared, startDate, endDate, and conversationId. Sorting is controlled by sortBy and sortOrder. Pagination is controlled by page and limit.

Unarchiving:

Use PATCH /conversations/{conversationId}/unarchive to restore a conversation to the active list.

get/conversations/show/archives

Query parameters

pageinteger

Page number (1-indexed)

limitinteger

Items per page

sortBy'createdAt' | 'lastActivityAt' | 'title'

Field to sort by

sortOrder'asc' | 'desc'

Sort direction

searchstring

Case-insensitive substring match against title and message content (max 1000 chars)

sharedboolean

Filter by shared status

startDatestring date-time

Include conversations created on or after this timestamp

endDatestring date-time

Include conversations created on or before this timestamp

conversationIdstring objectId

Restrict results to a single conversation by identifier

Response

List of archived conversations

Example response

{
  "conversations": [
    {
      "title": "Q4 Financial Report Discussion"
    }
  ]
}

Changes

Changed in 3 of the 15 revisions of this API.113

  • 5798f431973a12See the full diff
    • ●

      added the new tool_call enum value to the //////// response property for the response status

      response-property-enum-value-added

    • ○

      added the optional property //////// to the response with the status

      response-optional-property-added

    • ○

      added the optional property //////// to the response with the status

      response-optional-property-added

    This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 8255239599bf1See the full diff
    • ○

      added the optional property //////// to the response with the status

      response-optional-property-added

    This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 911a57b55d181See the full diff
    • ▲

      the response property //////// became nullable for the status

      response-property-became-nullable