Back to Documentation

Review Chats

Manage and review your conversations through the API

by Arkangel AI Team•1 min read

Learn how to list, query, and manage your conversations with the Arkangel AI API.

List Conversations

Endpoint

GET https://api.arkangelai.com/v1/conversations

Example

curl https://api.arkangelai.com/v1/conversations \
  -H "Authorization: Bearer your_api_key"

Query Parameters

Parameter Type Description
limit number Maximum number of results (max: 100)
offset number Number of results to skip
start_date string Start date (ISO 8601)
end_date string End date (ISO 8601)

Response

{
  "conversations": [
    {
      "id": "conv_abc123",
      "title": "Diabetes inquiry",
      "message_count": 5,
      "created_at": "2026-01-19T10:00:00Z",
      "updated_at": "2026-01-19T10:30:00Z"
    }
  ],
  "total": 42,
  "has_more": true
}

Get a Conversation

curl https://api.arkangelai.com/v1/conversations/conv_abc123 \
  -H "Authorization: Bearer your_api_key"

Response

{
  "id": "conv_abc123",
  "title": "Diabetes inquiry",
  "messages": [
    {
      "id": "msg_001",
      "role": "user",
      "content": "What is type 2 diabetes?",
      "created_at": "2026-01-19T10:00:00Z"
    },
    {
      "id": "msg_002",
      "role": "assistant",
      "content": "Type 2 diabetes is a chronic condition...",
      "sources": [...],
      "created_at": "2026-01-19T10:00:05Z"
    }
  ],
  "created_at": "2026-01-19T10:00:00Z",
  "updated_at": "2026-01-19T10:30:00Z"
}

Search Conversations

curl "https://api.arkangelai.com/v1/conversations/search?q=diabetes" \
  -H "Authorization: Bearer your_api_key"

Search Parameters

Parameter Type Description
q string Search term
limit number Maximum number of results

Update a Conversation

You can update the title of a conversation:

curl -X PATCH https://api.arkangelai.com/v1/conversations/conv_abc123 \
  -H "Authorization: Bearer your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"title": "Diabetes inquiry - Patient A"}'

Delete a Conversation

curl -X DELETE https://api.arkangelai.com/v1/conversations/conv_abc123 \
  -H "Authorization: Bearer your_api_key"

Note: This action is irreversible. All messages in the conversation will be deleted.

Export Conversation

Export a conversation in different formats:

curl "https://api.arkangelai.com/v1/conversations/conv_abc123/export?format=pdf" \
  -H "Authorization: Bearer your_api_key" \
  -o conversation.pdf

Available Formats

Format Description
json Structured data
pdf PDF document
txt Plain text

Complete Example

// List recent conversations
async function getRecentConversations() {
  const response = await fetch(
    'https://api.arkangelai.com/v1/conversations?limit=10',
    {
      headers: {
        'Authorization': 'Bearer your_api_key'
      }
    }
  );

  const data = await response.json();
  return data.conversations;
}

// Get conversation details
async function getConversation(conversationId) {
  const response = await fetch(
    `https://api.arkangelai.com/v1/conversations/${conversationId}`,
    {
      headers: {
        'Authorization': 'Bearer your_api_key'
      }
    }
  );

  return response.json();
}

Next Steps