List paginated input items for a response

Retrieves a paginated list of all input items provided when creating the specified agent response.

GET /api/v1/llm/responses/{response_id}/input_items

Python (SDK)

Python

from mka1 import SDK


with SDK(
    bearer_auth="<YOUR_BEARER_TOKEN_HERE>",
) as sdk:

    res = sdk.llm.responses.list_input_items(response_id="resp_abc123", after="item_abc123", include=[
        "file_search_call.results",
    ], limit=50, order="asc")

    # Handle response
    print(res)

200

{
  "object": "list",
  "data": [
    {
      "type": "message",
      "id": "msg_user_abc123",
      "role": "user",
      "content": "What is the capital of France?"
    }
  ],
  "first_id": "msg_user_abc123",
  "last_id": "msg_user_abc123",
  "has_more": false
}

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

response_id · string · required

The unique identifier of the response, formatted as 'resp_' or 'resp-' followed by alphanumeric characters.

Pattern: ^resp[-_][a-zA-Z0-9]+$

Query Parameters

after · string

An item ID to use as a cursor for pagination. Returns items that come after this ID in the list. Used for cursor-based pagination to fetch subsequent pages.

Example:

"item_abc123"

include · enum<string>[]

Additional fields to include in the input items. Allows requesting specific nested data like web search sources, code interpreter outputs, computer screenshots, file search results, input images, output logprobs, or reasoning content. These fields may have performance or cost implications.

Available options: web_search_call.action.sources, code_interpreter_call.outputs, computer_call_output.output.image_url, file_search_call.results, message.input_image.image_url, message.output_text.logprobs, reasoning.encrypted_content

Example:

["file_search_call.results"]

limit · integer · default: 20

The maximum number of input items to return per page. Must be between 1 and 100. Defaults to 20 items.

Required range: 1 <= x <= 100

Example:

50

order · enum<string>

The order to return the input items in. 'asc' returns oldest items first, 'desc' returns newest items first. Defaults to 'desc' (newest first).

Available options: asc, desc

Example:

"asc"

Response

200 - application/json

Paginated list of input items for the specified response.

Paginated list object containing input items for a response with cursor-based pagination metadata.

object · any · required

The object type, always 'list' for paginated list responses.

data · (Input message item · object | Output message item · object | Output audio item · object | File search call item · object | Computer call item · object | Computer call output item · object | Web search call item · object | Function call item · object | Function call output item · object | Reasoning item · object | Image generation call item · object | Code interpreter call item · object | Local shell call item · object | Local shell call output item · object | Shell call item · object | Shell call output item · object | MCP list tools item · object | MCP approval request item · object | MCP approval response item · object | MCP call item · object | Custom tool call item · object | Custom tool call output item · object | Item reference item · object | Compaction item · object)[] · required

Array of input items (messages, prompts, instructions) that were provided when creating the response. Each item contains its type, content, role, and metadata.

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

Input message item

Output message item

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

Compaction item

Show child attributes

has_more · boolean · required

Indicates whether there are more items available beyond the current page. True if additional pages exist, false otherwise.

first_id · string

The ID of the first item in the current page. Used as a reference point for pagination.

last_id · string

The ID of the last item in the current page. Used as a cursor for fetching the next page.