REST: List input items

Returns a list of input items for a given response.

HTTP request

GET https://ai.api.cloud.yandex.net/v1/responses/{response_id}/input_items
        

Path parameters

Field

Description

response_id

string

Required field. The ID of the response to retrieve input items for.

Query parameters

Field

Description

limit

integer

A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 20.

order

enum

The order to return the input items in. Default is desc. - asc: Return the input items in ascending order. - desc: Return the input items in descending order.

  • asc
  • desc

after

string

An item ID to list items after, used in pagination.

include[]

enum

Additional fields to include in the response. See the include parameter for Response creation above for more information.

[CURRENTLY NOT SUPPORTED]

  • file_search_call.results
  • web_search_call.results
  • web_search_call.action.sources
  • message.input_image.image_url
  • computer_call_output.output.image_url
  • code_interpreter_call.outputs
  • reasoning.encrypted_content
  • message.output_text.logprobs

Response

HTTP Code: 200

OK

Response schema: application/json

{
          "object": "list",
          "data": [
            {
              "<anyOf>": [
                "unknown",
                {
                  "id": "string",
                  "type": "string",
                  "role": "string",
                  "content": [
                    {
                      "<anyOf>": [
                        {
                          "type": "string",
                          "text": "string",
                          "annotations": [
                            {
                              "<anyOf>": [
                                {
                                  "type": "string",
                                  "file_id": "string",
                                  "index": "integer",
                                  "filename": "string"
                                },
                                {
                                  "type": "string",
                                  "url": "string",
                                  "start_index": "integer",
                                  "end_index": "integer",
                                  "title": "string"
                                },
                                {
                                  "type": "string",
                                  "container_id": "string",
                                  "file_id": "string",
                                  "start_index": "integer",
                                  "end_index": "integer",
                                  "filename": "string"
                                },
                                {
                                  "type": "string",
                                  "file_id": "string",
                                  "index": "integer"
                                }
                              ]
                            }
                          ],
                          "logprobs": [
                            {
                              "token": "string",
                              "logprob": "number",
                              "bytes": [
                                "integer"
                              ],
                              "top_logprobs": [
                                {
                                  "token": "string",
                                  "logprob": "number",
                                  "bytes": [
                                    "integer"
                                  ]
                                }
                              ]
                            }
                          ]
                        },
                        {
                          "type": "string",
                          "refusal": "string"
                        }
                      ]
                    }
                  ],
                  "status": "string"
                },
                {
                  "id": "string",
                  "type": "string",
                  "status": "string",
                  "queries": [
                    "string"
                  ],
                  "results": "unknown"
                },
                {
                  "type": "string",
                  "id": "string",
                  "call_id": "string",
                  "action": "unknown",
                  "pending_safety_checks": [
                    {
                      "id": "string",
                      "code": "unknown",
                      "message": "unknown"
                    }
                  ],
                  "status": "string"
                },
                "unknown",
                {
                  "id": "string",
                  "type": "string",
                  "status": "string",
                  "action": {
                    "<anyOf>": [
                      {
                        "type": "string",
                        "query": "string",
                        "sources": [
                          {
                            "type": "string",
                            "url": "string"
                          }
                        ]
                      },
                      {
                        "type": "string",
                        "url": "string"
                      },
                      {
                        "type": "string",
                        "url": "string",
                        "pattern": "string"
                      }
                    ]
                  }
                },
                "unknown",
                "unknown",
                {
                  "type": "string",
                  "id": "string",
                  "status": "string",
                  "result": "unknown"
                },
                {
                  "type": "string",
                  "id": "string",
                  "status": "string",
                  "container_id": "string",
                  "code": "unknown",
                  "outputs": "unknown"
                },
                {
                  "type": "string",
                  "id": "string",
                  "call_id": "string",
                  "action": {
                    "type": "string",
                    "command": [
                      "string"
                    ],
                    "timeout_ms": "unknown",
                    "working_directory": "unknown",
                    "env": {
                      "string": "string"
                    },
                    "user": "unknown"
                  },
                  "status": "string"
                },
                {
                  "type": "string",
                  "id": "string",
                  "output": "string",
                  "status": "unknown"
                },
                {
                  "type": "string",
                  "id": "string",
                  "call_id": "string",
                  "action": {
                    "commands": [
                      "string"
                    ],
                    "timeout_ms": "unknown",
                    "max_output_length": "unknown"
                  },
                  "status": "string",
                  "created_by": "string"
                },
                {
                  "type": "string",
                  "id": "string",
                  "call_id": "string",
                  "output": [
                    {
                      "stdout": "string",
                      "stderr": "string",
                      "outcome": "unknown",
                      "created_by": "string"
                    }
                  ],
                  "max_output_length": "unknown",
                  "created_by": "string"
                },
                {
                  "type": "string",
                  "id": "string",
                  "call_id": "string",
                  "status": "string",
                  "operation": "unknown",
                  "created_by": "string"
                },
                {
                  "type": "string",
                  "id": "string",
                  "call_id": "string",
                  "status": "string",
                  "output": "unknown",
                  "created_by": "string"
                },
                {
                  "type": "string",
                  "id": "string",
                  "server_label": "string",
                  "tools": [
                    {
                      "name": "string",
                      "description": "unknown",
                      "input_schema": {},
                      "annotations": "unknown"
                    }
                  ],
                  "error": "unknown"
                },
                {
                  "type": "string",
                  "id": "string",
                  "server_label": "string",
                  "name": "string",
                  "arguments": "string"
                },
                {
                  "type": "string",
                  "id": "string",
                  "approval_request_id": "string",
                  "approve": "boolean",
                  "reason": "unknown"
                },
                {
                  "type": "string",
                  "id": "string",
                  "server_label": "string",
                  "name": "string",
                  "arguments": "string",
                  "output": "unknown",
                  "error": "unknown",
                  "status": "string",
                  "approval_request_id": "unknown"
                }
              ]
            }
          ],
          "has_more": "boolean",
          "first_id": "string",
          "last_id": "string"
        }
        

A list of Response items.

Field

Description

object

list (const)

Required field. The type of object returned, must be list.

data[]

unknown

Required field. Content item used to generate a response.

has_more

boolean

Required field. Whether there are more items available.

first_id

string

Required field. The ID of the first item in the list.

last_id

string

Required field. The ID of the last item in the list.

Предыдущая
Следующая