List All Project Chats

Retrieve all chat conversations for a specific project. This endpoint returns metadata about all chats without the actual message content.

Endpoint

GET/listAllProjectChats

Get a list of all chat conversations associated with your project, including chat IDs, creation timestamps, and last updated information.

https://chat-api.atriai.chat/listAllProjectChats

Authentication

Type:

Bearer Token

Header:

Authorization

Your project-specific API key for the Chat service

Query Parameters

No query parameters are needed for this endpoint

Validation Rules

The following validation rules apply to the request:

Valid API key required

A valid API key must be provided to authenticate and determine the project context

Project access only

Only chats belonging to the authenticated project will be returned

Response Schema

The API returns a JSON object with the following structure:

chatsarray[object]

Array of chat objects containing chat metadata

chats[].idstring

Unique identifier for the chat conversation

chats[].created_atstring

ISO timestamp when the chat was created

chats[].last_updated_atstring

ISO timestamp when the chat was last modified

chats[].consumer_idstring

Consumer identifier associated with the chat (if applicable)

Usage Examples

Common usage patterns for the List All Project Chats endpoint:

List Chats

Get all conversations for your project

GET https://chat-api.atriai.chat/listAllProjectChats

Response Example

Example response for a successful request:

{
  "chats": [
    {
      "id": "chat_20240711_143052_abc123",
      "created_at": "2024-07-11T14:30:52.123Z",
      "last_updated_at": "2024-07-11T15:45:20.456Z",
      "consumer_id": "user_12345"
    },
    {
      "id": "chat_20240711_160225_def456",
      "created_at": "2024-07-11T16:02:25.789Z",
      "last_updated_at": "2024-07-11T16:15:10.123Z",
      "consumer_id": "user_67890"
    }
  ]
}

Common Use Cases

Typical scenarios where this endpoint is useful:

Dashboard displays showing conversation history
Administrative interfaces for chat management
Analytics and reporting on chat volume
Bulk operations on chat conversations
Debugging and troubleshooting chat issues

Try it out

Select a language to see how to make a request to the AI Chat API

cURL Request

curl -L 'https://chat-api.atriai.chat/listAllProjectChats' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer YOUR_API_KEY'

API Key Required

Replace YOUR_API_KEY with your actual api key to authenticate requests.