Skip to main content
GET
/
api
/
v1
/
llm
/
conversations
/
{conversation_id}
/
items
/
{item_id}
Python (SDK)
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)
{
  "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>.

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

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