Review Chats

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

• Review History - View complete usage history
• HTTP Reference - Status codes and errors