List a stored response's input items

GET

/responses/{response_id}/input_items

curl --request GET \
  --url 'https://api.katara.com/v1/responses/example/input_items?order=asc' \
  --header 'Authorization: Bearer <token>'

• Test and Live. The key decides which network a request is served on.

The input items of a stored response, newest first unless order is asc, under the same rule as reading it.

Authorizations

• bearerAuth
• None

Parameters

Path Parameters

response_id

required

string

/^resp_[A-Za-z0-9_-]{1,120}$/

The id of a stored response.

Query Parameters

order

string

default: desc

Allowed values: asc desc

Responses

200

The items, in one page.

Media typeapplication/json

object

object

required

string

Allowed value: list

data

required

Array<object>

A message (role user, assistant, system or developer, with string or typed content), or a typed item: function_call, function_call_output (string or a list of parts), custom_tool_call, custom_tool_call_output, reasoning, web_search_call, tool_search_call, tool_search_output, additional_tools, agent_message, or an item_reference to an item of a stored response. Replayed web_search_call items and encrypted_content are dropped.

object

type

string

id

string

role

string

Allowed values: user assistant system developer

content

One of:

string

string

Array<object>

Array<object>

input_text, output_text and refusal; input_image with image_url or file_id; input_file with file_id or file_data; input_audio; and summary_text and reasoning_text in reasoning items. Files are uploaded through /v1/files.

object

type

required

string

text

string

image_url

string

file_id

string

file_data

string

key

additional properties

any

call_id

string

name

string

arguments

JSON argument document encoded as text.

string

output

key

additional properties

any

has_more

required

boolean

first_id

string | null

last_id

string | null

Example

{
  "object": "list",
  "data": [
    {
      "role": "user"
    }
  ],
  "has_more": false
}

404

The response is missing, expired, deleted or someone else’s (response_not_found).

Media typeapplication/json

object

error

required

object

type

string

code

required

Stable error code.

string

message

required

Explanation for the caller.

string

param

string | null

Example^generated

{
  "error": {
    "type": "example",
    "code": "example",
    "message": "example",
    "param": "example"
  }
}