Liste os itens de entrada paginados para uma resposta

Recupera uma lista paginada de todos os itens de entrada fornecidos ao criar a resposta do agente especificado.

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
}

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

response_id · string · obrigatório

O identificador único da resposta, formatado como 'resp_' ou 'resp-' seguido por caracteres alfanuméricos.

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

Parâmetros de consulta

after · string

Um ID de item para usar como um cursor para paginação. Retorna itens que vêm depois desse ID na lista. Usado para paginação baseada em cursor para buscar páginas subsequentes.

Exemplo:

"item_abc123"

include · enum<string>[]

Campos adicionais para incluir nos itens de entrada. Permite solicitar dados aninhados específicos, como fontes de pesquisa na web, saídas do intérprete de código, capturas de tela do computador, resultados de busca de arquivos, imagens de entrada, logprobs de saída ou conteúdos de raciocínio. Esses campos podem ter implicações de desempenho ou custo.

Opções disponíveis: 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

Exemplo:

["file_search_call.results"]

limit · integer · padrão: 20

O número máximo de itens de entrada a ser retornado por página. Deve ser entre 1 e 100. O padrão é 20 itens.

Intervalo obrigatório: 1 <= x <= 100

Exemplo:

50

order · enum<string>

A ordem para retornar os itens de entrada. 'asc' retorna os itens mais antigos primeiro, 'desc' retorna os itens mais novos primeiro. O padrão é 'desc' (mais novos primeiro).

Opções disponíveis: asc, desc

Exemplo:

"asc"

Resposta

200 - application/json

Lista paginada de itens de entrada para a resposta especificada.

Objeto de lista paginada contendo itens de entrada para uma resposta com metadados de paginação baseada em cursor.

object · any · obrigatório

O tipo de objeto, sempre 'lista' para respostas de lista paginada.

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)[] · obrigatório

Array de itens de entrada (mensagens, solicitações, instruções) que foram fornecidos ao criar a resposta. Cada item contém seu tipo, conteúdo, função e metadados.

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.

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 · obrigatório

Indica se há mais itens disponíveis além da página atual. Verdadeiro se páginas adicionais existirem, falso caso contrário.

first_id · string

O ID do primeiro item na página atual. Usado como um ponto de referência para paginação.

last_id · string

O ID do último item na página atual. Usado como um cursor para buscar a próxima página.