Retour à la documentation

Consulter les Chats

Gérez et consultez vos conversations via l'API

par Arkangel AI Team•1 min de lecture

Apprenez à lister, interroger et gérer vos conversations avec l'API Arkangel AI.

Lister les Conversations

Point d'Accès

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

Exemple

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

Paramètres de Requête

Paramètre Type Description
limit number Nombre maximum de résultats (max : 100)
offset number Nombre de résultats à ignorer
start_date string Date de début (ISO 8601)
end_date string Date de fin (ISO 8601)

Réponse

{
  "conversations": [
    {
      "id": "conv_abc123",
      "title": "Question sur le diabète",
      "message_count": 5,
      "created_at": "2026-01-19T10:00:00Z",
      "updated_at": "2026-01-19T10:30:00Z"
    }
  ],
  "total": 42,
  "has_more": true
}

Obtenir une Conversation

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

Réponse

{
  "id": "conv_abc123",
  "title": "Question sur le diabète",
  "messages": [
    {
      "id": "msg_001",
      "role": "user",
      "content": "Qu'est-ce que le diabète de type 2 ?",
      "created_at": "2026-01-19T10:00:00Z"
    },
    {
      "id": "msg_002",
      "role": "assistant",
      "content": "Le diabète de type 2 est une condition chronique...",
      "sources": [...],
      "created_at": "2026-01-19T10:00:05Z"
    }
  ],
  "created_at": "2026-01-19T10:00:00Z",
  "updated_at": "2026-01-19T10:30:00Z"
}

Rechercher dans les Conversations

curl "https://api.arkangelai.com/v1/conversations/search?q=diabète" \
  -H "Authorization: Bearer votre_cle_api"

Paramètres de Recherche

Paramètre Type Description
q string Terme de recherche
limit number Nombre maximum de résultats

Mettre à Jour une Conversation

Vous pouvez mettre à jour le titre d'une conversation :

curl -X PATCH https://api.arkangelai.com/v1/conversations/conv_abc123 \
  -H "Authorization: Bearer votre_cle_api" \
  -H "Content-Type: application/json" \
  -d '{"title": "Question diabète - Patient A"}'

Supprimer une Conversation

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

Note : Cette action est irréversible. Tous les messages de la conversation seront supprimés.

Exporter une Conversation

Exportez une conversation dans différents formats :

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

Formats Disponibles

Format Description
json Données structurées
pdf Document PDF
txt Texte brut

Exemple Complet

// Lister les conversations récentes
async function getRecentConversations() {
  const response = await fetch(
    'https://api.arkangelai.com/v1/conversations?limit=10',
    {
      headers: {
        'Authorization': 'Bearer votre_cle_api'
      }
    }
  );

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

// Obtenir les détails d'une conversation
async function getConversation(conversationId) {
  const response = await fetch(
    `https://api.arkangelai.com/v1/conversations/${conversationId}`,
    {
      headers: {
        'Authorization': 'Bearer votre_cle_api'
      }
    }
  );

  return response.json();
}

Prochaines Étapes