Recuperar uma conversa

Obtenha uma conversa pelo ID.

GET /api/v1/llm/conversations/{conversation_id}

Python (SDK)

Python

from mka1 import SDK


with SDK(
    bearer_auth="<YOUR_BEARER_TOKEN_HERE>",
) as sdk:

    res = sdk.llm.conversations.get(conversation_id="conv_abc123")

    # Handle response
    print(res)

200

{
  "id": "conv_abc123",
  "object": "conversation",
  "created_at": 1704067200,
  "metadata": {
    "session_id": "sess_abc123",
    "user_type": "premium"
  }
}

Autorizações

Authorization · string · header · obrigatório

Gateway auth: send Authorization: Bearer <mka1-api-key>. For multi-user server-side integrations, you can also send X-On-Behalf-Of: <external-user-id>.

Cabeçalhos

X-On-Behalf-Of · string

Optional external end-user identifier forwarded by the API gateway.

Parâmetros de caminho

conversation_id · string · obrigatório

O ID da conversa

Resposta

200 - application/json

OK

id · string · obrigatório

O ID único da conversa

object · any · obrigatório

O tipo de objeto, sempre 'conversa'

created_at · number · obrigatório

Timestamp Unix de quando a conversa foi criada

metadata · object

Show child attributes

identity · string

Identidade do proprietário da conversa. Pode ser um hash SHA256 ou userId:externalUserId bruto, dependendo do MODO_DE_IDENTIDADE.