Revisar Chats

Aprende a listar, consultar y gestionar tus conversaciones con la API de Arkangel AI.

Listar Conversaciones

Endpoint

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

Ejemplo

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

Parámetros de Consulta

Parámetro	Tipo	Descripción
limit	number	Número máximo de resultados (máx: 100)
offset	number	Número de resultados a saltar
start_date	string	Fecha de inicio (ISO 8601)
end_date	string	Fecha de fin (ISO 8601)

Respuesta

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

Obtener una Conversación

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

Respuesta

{
  "id": "conv_abc123",
  "title": "Consulta sobre diabetes",
  "messages": [
    {
      "id": "msg_001",
      "role": "user",
      "content": "¿Qué es la diabetes tipo 2?",
      "created_at": "2026-01-19T10:00:00Z"
    },
    {
      "id": "msg_002",
      "role": "assistant",
      "content": "La diabetes tipo 2 es una condición crónica...",
      "sources": [...],
      "created_at": "2026-01-19T10:00:05Z"
    }
  ],
  "created_at": "2026-01-19T10:00:00Z",
  "updated_at": "2026-01-19T10:30:00Z"
}

Buscar en Conversaciones

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

Parámetros de Búsqueda

Parámetro	Tipo	Descripción
q	string	Término de búsqueda
limit	number	Número máximo de resultados

Actualizar una Conversación

Puedes actualizar el título de una conversación:

curl -X PATCH https://api.arkangelai.com/v1/conversations/conv_abc123 \
  -H "Authorization: Bearer tu_clave_api" \
  -H "Content-Type: application/json" \
  -d '{"title": "Consulta diabetes - Paciente A"}'

Eliminar una Conversación

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

Nota: Esta acción es irreversible. Todos los mensajes de la conversación serán eliminados.

Exportar Conversación

Exporta una conversación en diferentes formatos:

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

Formatos Disponibles

Formato	Descripción
json	Datos estructurados
pdf	Documento PDF
txt	Texto plano

Ejemplo Completo

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

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

// Obtener detalles de una conversación
async function getConversation(conversationId) {
  const response = await fetch(
    `https://api.arkangelai.com/v1/conversations/${conversationId}`,
    {
      headers: {
        'Authorization': 'Bearer tu_clave_api'
      }
    }
  );

  return response.json();
}

Próximos Pasos

• Revisar Historial - Consulta el historial completo de uso
• Referencia HTTP - Códigos de estado y errores