Skip to main content
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
obrigatório

The unique ID of the message.

Exemplo:

"msg_aa87e2b1112a455b8deabed784372198"

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.