Pular para o conteúdo principal
GET
Python (SDK)

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

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
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

The unique ID of the message.

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

The ID of the response that created this item, if any.

metadata
object | null

Metadata from the response that created this item, if any.