Conversations

List archived conversations

Changed on Oct 28, 2026

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 (isShared and the caller listed in sharedWith). Deleted and agent conversations are never listed. Each item carries its messages.

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.

Query parameters not listed here are dropped by the validator and ignored, including projectId, which GET /conversations accepts.

Unarchiving:

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

get/conversations/show/archives

Request

Base URL
https://app.pipeshub.com/api/v1
URL
https://app.pipeshub.com/api/v1/conversations/show/archives
Auth
- HTTP bearer
- or OAuth 2
  Authorization code: /api/v1/oauth2/authorize
  Client credentials
  Token URL: /api/v1/oauth2/token scopes: conversation:read

Query parameters

pagenumber

Page number (1-indexed). The validator accepts any number, so a fraction such as 1.5 is not refused; it is truncated (1.5 reads as page 1).

limitnumber

Items per page. A fraction is not refused; it is truncated (5.5 reads as 5).

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). A value holding markup is refused by the controller with 400 HTTP_BAD_REQUEST.

shared'true' | 'false' | '1' | '0'

When set, filters by isShared. Accepts exactly true, false, 1 or 0.

startDatestring date-time

Include conversations created on or after this instant. Must be a full ISO 8601 date-time with Z or a numeric offset; a bare date is refused.

endDatestring date-time

Include conversations created on or before this instant. Must be a full ISO 8601 date-time with Z or a numeric offset; a bare date is refused.

conversationIdstring objectId

Restrict results to a single conversation by identifier

Response

List of archived conversations

Changes

Oct 28, 2026dbb5e203b445 Revision changes
- breaking
  the query request parameter shared was restricted to a list of enum values
- breaking
  added the pattern ^[0-9a-fA-F]{24}$ to the query request parameter conversationId
- breaking
  added the pattern ^\d{4}-\d{2}-\d{2}T([01]\d|2[0-3]):[0-5]\d:[0-5]\d(\.\d+)?(Z|[+-]\d{2}:?\d{2})$ to the query request parameter endDate
- breaking
  added the pattern ^\d{4}-\d{2}-\d{2}T([01]\d|2[0-3]):[0-5]\d:[0-5]\d(\.\d+)?(Z|[+-]\d{2}:?\d{2})$ to the query request parameter startDate
- breaking
  the ////////// response's property type changed from object to no type for status
- breaking
  the ////////// response's property type changed from object to no type for status
- breaking
  the ////////// response's property type changed from object to no type for status
- breaking
  the ////////// response's property type changed from object to no type for status
- breaking
  the ////////// response's property type changed from object to no type for status
- breaking
  the ///////// response's property type changed from object to no type for status
- warning
  removed the optional property /////////// from the response with the status
- warning
  removed the optional property /////////// from the response with the status
- warning
  removed the optional property /////////// from the response with the status
- warning
  removed the optional property /////////// from the response with the status
- warning
  removed the optional property /////////// from the response with the status
- warning
  removed the optional property /////////// from the response with the status
- warning
  removed the optional property /////////// from the response with the status
- warning
  removed the optional property /////////// from the response with the status
- warning
  removed the optional property /////////// from the response with the status
- warning
  removed the optional property /////////// from the response with the status
- warning
  removed the optional property /////////// from the response with the status
- warning
  removed the optional property /////////// from the response with the status
- warning
  removed the optional property /////////// from the response with the status
- warning
  removed the optional property /////////// from the response with the status
- warning
  removed the optional property /////////// from the response with the status
- warning
  removed the optional property /////////// from the response with the status
- warning
  removed the optional property /////////// from the response with the status
- warning
  removed the optional property /////////// from the response with the status
- warning
  removed the optional property /////////// from the response with the status
- warning
  removed the optional property /////////// from the response with the status
- warning
  removed the optional property /////////// from the response with the status
- warning
  removed the optional property /////////// from the response with the status
- warning
  removed the optional property /////////// from the response with the status
- warning
  removed the optional property /////////// from the response with the status
- warning
  removed the optional property /////////// from the response with the status
- warning
  removed the optional property /////////// from the response with the status
- warning
  removed the optional property /////////// from the response with the status
- warning
  removed the optional property /////////// from the response with the status
- warning
  removed the optional property /////////// from the response with the status
- warning
  removed the optional property /////////// from the response with the status
- warning
  removed the optional property /////////// from the response with the status
- warning
  removed the optional property /////////// from the response with the status
- warning
  removed the optional property /////////// from the response with the status
- warning
  removed the optional property /////////// from the response with the status
- warning
  removed the optional property /////////// from the response with the status
- warning
  removed the optional property ////////// from the response with the status
- warning
  removed the optional property ////////// from the response with the status
- warning
  removed the optional property ////////// from the response with the status
- warning
  removed the optional property ////////// from the response with the status
- warning
  removed the optional property ////////// from the response with the status
- warning
  removed the optional property ////////// from the response with the status
- info
  added the new enum value 0 to the query request parameter shared
- info
  added the new enum value 1 to the query request parameter shared
- info
  added the new enum value false to the query request parameter shared
- info
  added the new enum value true to the query request parameter shared
- info
  for the query request parameter limit, the type was generalized from integer to number
- info
  for the query request parameter page, the type was generalized from integer to number
- info
  for the query request parameter shared, the type was generalized from boolean to string
- info
  added the media type application/json for the response with the status
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added the optional property ////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property ////////// to the response with the status
- info
  added the optional property ///////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added to the ////////// response property anyOf list for the response status
- info
  added to the ////////// response property anyOf list for the response status
- info
  added to the ////////// response property anyOf list for the response status
- info
  added to the ////////// response property anyOf list for the response status
- info
  added to the ////////// response property anyOf list for the response status
- info
  added to the ///////// response property anyOf list for the response status
- info
  added subschema #1 to the ///////// response property anyOf list for the response status
Oct 26, 2026fc76aa045994 Revision changes
- info
  added the optional property ////// to the response with the status

Operation history (7 revisions)

List archived conversations

Request

Query parameters

Response 200OK

Changes

Response