Recuperar um item de conversa

Obtenha um único item de uma conversa com os IDs fornecidos.

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

Python (SDK)

Python

from mka1 import SDK


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

    res = sdk.llm.conversations.get_item(conversation_id="conv_abc123", item_id="item_abc123")

    # Handle response
    print(res)

200

{
  "id": "item_abc123",
  "response_id": "resp_abc123",
  "type": "message",
  "role": "user",
  "content": "What is the weather today?"
}

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

item_id · string · obrigatório

A ID do item

Resposta

200 - application/json

OK

Input message item

Output message item

File search call item

Computer call item

Computer call output item

Web search call item

Function call item

Function call output item

Reasoning item

Image generation call item

Code interpreter call item

Local shell call item

Local shell call output item

Shell call item

Shell call output item

MCP list tools item

MCP approval request item

MCP approval response item

MCP call item

Custom tool call item

Custom tool call output item

Item reference item

Item de mensagem de entrada: Uma mensagem com papel e conteúdo. Use isso para turnos de usuário, assistente, sistema ou desenvolvedor em entradas estruturadas.

role · enum<string> · obrigatório

O papel do remetente da mensagem (usuário, assistente, sistema ou desenvolvedor).

Opções disponíveis: user, assistant, system, developer

content · string string · Input text content item · object · Input image content item · object · Input file content item · object · Input audio content item · object · object · object[] · obrigatório

O conteúdo da mensagem. Pode ser uma simples string de texto ou um array de itens de conteúdo multimodal (texto, imagens, arquivos, áudio).

id · string · padrão: msg_aa87e2b1112a455b8deabed784372198 · obrigatório

O ID único da mensagem.

type · any

O identificador do tipo de item. Sempre 'mensagem' para itens de mensagem.

status · enum<string>

O status de processamento desta mensagem. Opcional - indica se a mensagem está em_andamento, concluída ou incompleta.

Opções disponíveis: in_progress, completed, incomplete

response_id · string | null

O ID da resposta que criou este item, se houver.

metadata · object

Metadados da resposta que criou este item, se houver.

Show child attributes