Liste todas as respostas com paginação

Recupera uma lista paginada de todas as respostas dos agentes para o usuário autenticado.

GET /api/v1/llm/responses

Python (SDK)

Python

from mka1 import SDK


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

    res = sdk.llm.responses.list(after="resp_abc123", before="resp_xyz789", limit=25, order="desc")

    # Handle response
    print(res)

200

{
  "object": "list",
  "data": [
    {
      "id": "resp_abc123",
      "object": "response",
      "created_at": 1735689600,
      "completed_at": 1735689601,
      "status": "completed",
      "error": null,
      "incomplete_details": null,
      "background": false,
      "instructions": null,
      "max_output_tokens": null,
      "max_tool_calls": 30,
      "metadata": {
        "status": "reviewed",
        "reviewer": "john_doe"
      },
      "model": "meetkai:functionary-urdu-mini-pak",
      "output": [
        {
          "type": "message",
          "id": "msg_abc123",
          "role": "assistant",
          "content": [
            {
              "type": "output_text",
              "text": "The capital of France is Paris.",
              "annotations": []
            }
          ],
          "status": "completed"
        }
      ],
      "output_text": "The capital of France is Paris.",
      "parallel_tool_calls": true,
      "previous_response_id": null,
      "reasoning": {
        "effort": null,
        "summary": null
      },
      "service_tier": "auto",
      "store": true,
      "text": {
        "format": {
          "type": "text"
        },
        "verbosity": "medium"
      },
      "tool_choice": "auto",
      "tools": [],
      "truncation": "auto",
      "usage": {
        "input_tokens": 8,
        "input_tokens_details": {
          "cached_tokens": 0
        },
        "output_tokens": 7,
        "output_tokens_details": {
          "reasoning_tokens": 0
        },
        "total_tokens": 15
      },
      "user": null
    }
  ],
  "first_id": "resp_abc123",
  "last_id": "resp_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 consulta

after · string

Um ID de resposta para usar como um cursor para paginação. Retorna respostas que vêm após este ID na lista. Usado para paginação baseada em cursor para buscar páginas subsequentes.

Exemplo:

"resp_abc123"

before · string

Um ID de resposta a ser usado como um cursor para paginação. Retorna respostas que vêm antes deste ID na lista. Usado para paginação baseada em cursor para buscar páginas anteriores.

Exemplo:

"resp_xyz789"

limit · integer · padrão: 20

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

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

Exemplo:

25

order · enum<string> · padrão: desc

A ordem para retornar as respostas é pela data de criação. 'asc' retorna as respostas mais antigas primeiro, 'desc' retorna as respostas mais novas primeiro. O padrão é 'desc' (novas primeiro).

Opções disponíveis: asc, desc

Exemplo:

"desc"

Resposta

200 - application/json

Lista paginada de respostas para o usuário autenticado.

Objeto de lista paginada contendo respostas com metadados de paginação baseados em cursor.

object · any · obrigatório

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

data · object[] · obrigatório

Array de objetos de resposta. Cada resposta contém seu status, modelo, entrada/saída, logs de uso de ferramentas, metadados e informações de conclusão.

Show child attributes

has_more · boolean · obrigatório

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

first_id · string

O ID da primeira resposta na página atual. Usado como um ponto de referência para paginação.

last_id · string

O ID da última resposta na página atual. Usado como um cursor para buscar a próxima página.