API Reference

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Responses

Create Responses

POST/v1/responses

Retrieve Responses

GET/v1/responses/{response_id}

Cancel Responses

POST/v1/responses/{response_id}/cancel

ModelsExpand Collapse

ActionClick = object { button, type, x, y }

A click action.

button: "left" or "right" or "wheel" or 2 more

One of the following:

"left"

"right"

"wheel"

"back"

"forward"

type: "click"

x: number

y: number

ActionDoubleClick = object { type, x, y }

A double click action.

type: "double_click"

x: number

y: number

ActionDrag = object { path, type }

A drag action.

path: array of object { x, y }

x: number

y: number

type: "drag"

ActionFind = object { pattern, type, url }

Action type "find": Searches for a pattern within a loaded page.

pattern: string

type: "find"

url: string

ActionKeypress = object { keys, type }

A collection of keypresses the model would like to perform.

keys: array of string

type: "keypress"

ActionMove = object { type, x, y }

A mouse move action.

type: "move"

x: number

y: number

ActionOpenPage = object { type, url }

Action type "open_page" - Opens a specific URL from search results.

type: "open_page"

url: string

ActionScreenshot = object { type }

A screenshot action.

type: "screenshot"

ActionScroll = object { scroll_x, scroll_y, type, 2 more }

A scroll action.

scroll_x: number

scroll_y: number

type: "scroll"

x: number

y: number

ActionSearchSource = object { type, url }

A source used in the search.

type: "url"

url: string

ActionType = object { text, type }

An action to type in text.

text: string

type: "type"

ActionWait = object { type }

A wait action.

type: "wait"

AnnotationContainerFileCitation = object { container_id, end_index, file_id, 3 more }

A citation for a container file used to generate a model response.

container_id: string

end_index: number

file_id: string

filename: string

start_index: number

type: "container_file_citation"

AnnotationFileCitation = object { file_id, filename, index, type }

A citation to a file.

file_id: string

filename: string

index: number

type: "file_citation"

AnnotationFilePath = object { file_id, index, type }

A path to a file.

file_id: string

index: number

type: "file_path"

AnnotationURLCitation = object { end_index, start_index, title, 2 more }

A citation for a web resource used to generate a model response.

end_index: number

start_index: number

title: string

type: "url_citation"

url: string

Logprob = object { token, bytes, logprob, top_logprobs }

The log probability of a token.

token: string

bytes: array of number

logprob: number

top_logprobs: array of object { token, bytes, logprob }

token: string

bytes: array of number

logprob: number

McpApprovalRequest = object { id, arguments, name, 2 more }

A request for human approval of a tool invocation.

id: string

arguments: string

name: string

server_label: string

type: "mcp_approval_request"

OutputImage = object { type, url }

The image output from the code interpreter.

type: "image"

url: string

OutputLogs = object { logs, type }

The logs output from the code interpreter.

logs: string

type: "logs"

ResponseInputFileParam = object { type, file_data, file_id, 2 more }

A file input to the model.

type: "input_file"

file_data: optional string

file_id: optional string

file_url: optional string

filename: optional string

ResponseInputImageParam = object { detail, type, file_id, image_url }

An image input to the model.

Learn about image inputs.

detail: "low" or "high" or "auto"

One of the following:

"low"

"high"

"auto"

type: "input_image"

file_id: optional string

image_url: optional string

ResponseInputTextParam = object { text, type }

A text input to the model.

text: string

type: "input_text"

Summary = object { text, type }

A summary text from the model.

text: string

type: "summary_text"