Sign in
workspace

Get User Workspace Conversations

Retrieve conversations for a workspace where the current user is:

  • The creator of the conversation, or
  • Listed in the ConvoUsers table.

Return conversation metadata including:

  • External ID
  • Title
  • Last updated date
  • Number of messages
  • Whether the current user is the creator
get/api/workspace/{workspace_ext_id}/conversations

Path parameters

workspace_ext_idstring required

Headers

workspace-keystring

Response

Successful Response

external_idstring required
titlestring nullable required
created_by_ext_idstring required
updated_by_ext_idstring nullable
created_atstring date-time required
updated_atstring date-time required
is_sharedboolean
message_countinteger required

Changes

Changed in 3 of the 34 revisions of this API.14

  • aa4b06f8dede12See the full diff
    • ▲

      removed the required property items/is_creator from the response with the 200 status

      response-required-property-removed

    • ○

      added the optional property items/updated_by_ext_id to the response with the 200 status

      response-optional-property-added

    • ○

      added the required property items/created_by_ext_id to the response with the 200 status

      response-required-property-added

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

  • 7073d86523861See the full diff
    • ○

      added the new optional header request parameter workspace-key

      new-optional-request-parameter

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

  • 43c12480eb1b1See the full diff
    • ○

      added the required property items/created_at to the response with the 200 status

      response-required-property-added

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