Chat

List chats

List chats for a project. Results are paginated and ordered by created_at.

Required permission: chats_read

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

Request

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

Path parameters

slugstring required

Project slug identifier.

Query parameters

limitinteger

Maximum number of items to return per page.

offsetinteger

Number of items to skip from the start of the list.

order'asc' | 'desc'

Sort direction for created_at. Defaults to newest first.

fromstring date

Only include chats created on or after this date (ISO-8601, YYYY-MM-DD).

tostring date

Only include chats created on or before this date (ISO-8601, YYYY-MM-DD).

metadatastring

Filter by the metadata tag set in POST /api/v2/projects/{slug}/chats/ (for example, web, mcp, slack).

Response

Chats listed successfully

countinteger required

Total number of chats matching the query.

nextstring uri nullable

URL of the next page, or null if this is the last page.

previousstring uri nullable

URL of the previous page, or null if this is the first page.

Changes

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