Skip to main content
GET
Python (SDK)

Authorizations

Authorization
string
header
required

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

Headers

X-On-Behalf-Of
string

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

Path Parameters

conversation_id
string
required

The ID of the conversation

item_id
string
required

The ID of the item

Response

200 - application/json

OK

Input message item: A message with role and content. Use this for user, assistant, system, or developer turns in structured inputs.

role
enum<string>
required

The role of the message sender (user, assistant, system, or developer).

Available options:
user,
assistant,
system,
developer
content
required

The message content. Can be a simple text string or an array of multimodal content items (text, images, files, audio).

id
string
default:msg_aa87e2b1112a455b8deabed784372198
required

The unique ID of the message.

type
any

The item type identifier. Always 'message' for message items.

status
enum<string>

The processing status of this message. Optional - indicates if the message is in_progress, completed, or incomplete.

Available options:
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.