Chat

Get a chat

Retrieve a single conversation, including all of its messages ordered chronologically.

Required permission: chats_read

get/api/v2/projects/{slug}/chats/{chat_uuid}/

Request

  • Base URL: https://app.biel.ai
  • URL: https://app.biel.ai/api/v2/projects/{slug}/chats/{chat_uuid}/
  • Auth: API key in header Authorization

Path parameters

slugstring required

Project slug identifier.

chat_uuidstring uuid required

UUID of the chat to retrieve.

Response

Chat retrieved successfully

uuidstring uuid required

Chat UUID.

status'ACTIVE' | 'ARCHIVED' | 'DELETED' required

Chat lifecycle status.

urlstring nullable

URL where the chat was initiated, as supplied when the message was sent.

emailstring nullable

Email or identifier supplied when the message was sent, for analytics tracking.

metadatastring nullable

Channel tag supplied when the message was sent (for example, web, mcp, slack).

countrystring nullable

ISO-3166 alpha-2 country code resolved server-side from the originating IP.

created_atstring date-time required

ISO-8601 timestamp of chat creation.

updated_atstring date-time required

ISO-8601 timestamp of last activity in the chat.

project_slugstring required

Slug of the project the chat belongs to.

Changes

No recorded changes to this operation across all 1 revision of this API.