Retrieve a conversation item

Get a single item from a conversation with the given IDs.

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?"
}

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

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

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 · string string · Input text content item · object · Input image content item · object · Input file content item · object · Input audio content item · object · object · object[] · 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

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

Show child attributes