---
title: "Render"
method: POST
path: "/sessions/{session_id}/render"
tags: ["sessions", "render"]
---

# Render

`POST /sessions/{session_id}/render`

Renders a chat input.

Routes to different implementations based on feature flags:
- If auto_run_tools_chat feature flag is enabled, uses the new auto-tools implementation
- Otherwise, uses the legacy implementation

Parameters:
    developer (Developer): The developer associated with the chat session.
    session_id (UUID): The unique identifier of the chat session.
    chat_input (ChatInput): The chat input data.

Returns:
    RenderResponse: The rendered chat input.

## Path parameters

- `session_id` string, uuid, required

## Request body

- ChatInput
  - `messages` MessageInput[], required
    - `role` 'user' | 'assistant' | 'system' | 'tool', required
    - `tool_call_id` string, nullable
    - `content` union
      - string
      - string[]
      - union[]
        - union
          - AgentsApiAutogenChatContent
            - `text` string, required
            - `type` 'text'
          - ContentModel7
            - `image_url` ImageUrl, required — The image URL
              - …
            - `type` 'image_url'
          - AgentsApiAutogenChatContentModelInput — Anthropic image content part
            - `tool_use_id` string, required
            - `type` 'tool_result'
            - `content` union, required
              - …
    - `name` string, nullable
    - `tool_calls` union[], nullable
      - union
        - ChosenFunctionCall
          - `type` 'function'
          - `function` FunctionCallOption, required
            - `name` string, required
            - `arguments` string, nullable
          - `integration` unknown
          - `system` unknown
          - `api_call` unknown
          - `computer_20241022` ChosenComputer20241022
            - `action` 'key' | 'type' | 'cursor_position' | 'mouse_move' | 'left_click' | 'right_click' | 'middle_click' | 'double_click' | 'screenshot', required
            - `text` string, nullable
            - `coordinate` integer[], nullable
          - `text_editor_20241022` ChosenTextEditor20241022
            - `command` 'str_replace' | 'insert' | 'view' | 'undo_edit', required
            - `path` string, required
            - `file_text` string, nullable
            - `insert_line` integer, nullable
            - `new_str` string, nullable
            - `old_str` string, nullable
            - `view_range` integer[], nullable
          - `bash_20241022` ChosenBash20241022
            - `command` string, nullable
            - `restart` boolean
          - `id` string, nullable
        - ChosenComputer20241022
          - `action` 'key' | 'type' | 'cursor_position' | 'mouse_move' | 'left_click' | 'right_click' | 'middle_click' | 'double_click' | 'screenshot', required
          - `text` string, nullable
          - `coordinate` integer[], nullable
        - ChosenTextEditor20241022
          - `command` 'str_replace' | 'insert' | 'view' | 'undo_edit', required
          - `path` string, required
          - `file_text` string, nullable
          - `insert_line` integer, nullable
          - `new_str` string, nullable
          - `old_str` string, nullable
          - `view_range` integer[], nullable
        - ChosenBash20241022
          - `command` string, nullable
          - `restart` boolean
  - `tools` AgentsApiAutogenToolsCreateToolRequestInput[], nullable
    - `name` string, required
    - `type` 'function' | 'integration' | 'system' | 'api_call' | 'computer_20241022' | 'text_editor_20241022' | 'bash_20241022', required
    - `description` string, nullable
    - `function` FunctionDef — Function definition
      - `name` unknown
      - `description` unknown
      - `parameters` object, nullable
    - `integration` union
      - DummyIntegrationDef
        - `provider` 'dummy'
        - `method` string, nullable
        - `setup` unknown
        - `arguments` unknown
      - BraveIntegrationDef — Brave integration definition
        - `provider` 'brave'
        - `method` string, nullable
        - `setup` BraveSearchSetup — Integration definition for Brave Search
          - `brave_api_key` string, required
        - `arguments` BraveSearchArguments — Arguments for Brave Search
          - `query` string, required
      - EmailIntegrationDef — Email integration definition
        - `provider` 'email'
        - `method` string, nullable
        - `setup` EmailSetup — Setup parameters for Email integration
          - `host` string, required
          - `port` integer, required
          - `user` string, required
          - `password` string, required
        - `arguments` EmailArguments — Arguments for Email sending
          - `to` string, required
          - `from` string, required
          - `subject` string, required
          - `body` string, required
      - SpiderIntegrationDef — Spider integration definition
        - `provider` 'spider'
        - `method` 'crawl' | 'links' | 'screenshot' | 'search', nullable
        - `setup` SpiderSetup — Setup parameters for Spider integration
          - `spider_api_key` string, required
        - `arguments` SpiderFetchArguments — Arguments for Spider integration
          - `url` string, uri, required
          - `content_type` 'application/json' | 'text/csv' | 'application/xml' | 'application/jsonl'
          - `params` object, nullable
      - WikipediaIntegrationDef — Wikipedia integration definition
        - `provider` 'wikipedia'
        - `method` string, nullable
        - `setup` unknown
        - `arguments` WikipediaSearchArguments — Arguments for Wikipedia Search
          - `query` string, required
          - `load_max_docs` integer
      - WeatherIntegrationDef — Weather integration definition
        - `provider` 'weather'
        - `method` string, nullable
        - `setup` WeatherSetup — Integration definition for Weather
          - `openweathermap_api_key` string, required
        - `arguments` WeatherGetArguments — Arguments for Weather
          - `location` string, required
      - MailgunIntegrationDef — Mailgun integration definition
        - `provider` 'mailgun'
        - `method` 'send_email', nullable
        - `setup` MailgunSetup — Setup parameters for Mailgun integration
          - `api_key` string, required
        - `arguments` MailgunSendEmailArguments — Arguments for mailgun.send_email method
          - `to` string, required
          - `from` string, required
          - `subject` string, required
          - `body` string, required
          - `cc` string, nullable
          - `bcc` string, nullable
      - BrowserbaseContextIntegrationDef — browserbase context provider
        - `provider` 'browserbase'
        - `method` 'create_context'
        - `setup` BrowserbaseSetup — The setup parameters for the browserbase integration
          - `api_key` string, required
          - `project_id` string, required
          - `api_url` string, nullable
          - `connect_url` string, nullable
        - `arguments` BrowserbaseContextArguments
          - `projectId` string, required
      - BrowserbaseExtensionIntegrationDef — browserbase extension provider
        - `provider` 'browserbase'
        - `method` 'install_extension_from_github', nullable
        - `setup` BrowserbaseSetup — The setup parameters for the browserbase integration
          - `api_key` string, required
          - `project_id` string, required
          - `api_url` string, nullable
          - `connect_url` string, nullable
        - `arguments` BrowserbaseExtensionArguments
          - `repositoryName` string, required
          - `ref` string, nullable
      - BrowserbaseListSessionsIntegrationDef — browserbase list sessions integration definition
        - `provider` 'browserbase'
        - `method` 'list_sessions'
        - `setup` BrowserbaseSetup — The setup parameters for the browserbase integration
          - `api_key` string, required
          - `project_id` string, required
          - `api_url` string, nullable
          - `connect_url` string, nullable
        - `arguments` BrowserbaseListSessionsArguments
          - `status` 'RUNNING' | 'ERROR' | 'TIMED_OUT' | 'COMPLETED', nullable
      - BrowserbaseCreateSessionIntegrationDef — browserbase create session integration definition
        - `provider` 'browserbase'
        - `method` 'create_session'
        - `setup` BrowserbaseSetup — The setup parameters for the browserbase integration
          - `api_key` string, required
          - `project_id` string, required
          - `api_url` string, nullable
          - `connect_url` string, nullable
        - `arguments` BrowserbaseCreateSessionArguments
          - `projectId` string, nullable
          - `extensionId` string, nullable
          - `browserSettings` object
          - `timeout` integer
          - `keepAlive` boolean
          - `proxies` union
            - boolean
            - object[]
              - …
      - BrowserbaseGetSessionIntegrationDef — browserbase get session integration definition
        - `provider` 'browserbase'
        - `method` 'get_session'
        - `setup` BrowserbaseSetup — The setup parameters for the browserbase integration
          - `api_key` string, required
          - `project_id` string, required
          - `api_url` string, nullable
          - `connect_url` string, nullable
        - `arguments` BrowserbaseGetSessionArguments
          - `id` string, required
      - BrowserbaseCompleteSessionIntegrationDef — browserbase complete session integration definition
        - `provider` 'browserbase'
        - `method` 'complete_session'
        - `setup` BrowserbaseSetup — The setup parameters for the browserbase integration
          - `api_key` string, required
          - `project_id` string, required
          - `api_url` string, nullable
          - `connect_url` string, nullable
        - `arguments` BrowserbaseCompleteSessionArguments
          - `id` string, required
          - `status` 'REQUEST_RELEASE'
      - BrowserbaseGetSessionLiveUrlsIntegrationDef — browserbase get session live urls integration definition
        - `provider` 'browserbase'
        - `method` 'get_live_urls'
        - `setup` BrowserbaseSetup — The setup parameters for the browserbase integration
          - `api_key` string, required
          - `project_id` string, required
          - `api_url` string, nullable
          - `connect_url` string, nullable
        - `arguments` BrowserbaseGetSessionLiveUrlsArguments
          - `id` string, required
      - RemoteBrowserIntegrationDef — The integration definition for the remote browser
        - `provider` 'remote_browser'
        - `method` 'perform_action'
        - `setup` RemoteBrowserSetup, required — The setup parameters for the remote browser
          - `connect_url` string, nullable
          - `width` integer, nullable
          - `height` integer, nullable
        - `arguments` RemoteBrowserArguments — The arguments for the remote browser
          - `connect_url` string, nullable
          - `action` 'key' | 'type' | 'mouse_move' | 'left_click' | 'left_click_drag' | 'right_click' | 'middle_click' | 'double_click' | 'screenshot' | 'cursor_position' | 'navigate' | 'refresh', required
          - `text` string, nullable
          - `coordinate` unknown[], nullable
            - unknown
      - LlamaParseIntegrationDef — LlamaParse integration definition
        - `provider` 'llama_parse'
        - `method` string, nullable
        - `setup` LlamaParseSetup — Setup parameters for LlamaParse integration
          - `llamaparse_api_key` string, required
          - `params` object, nullable
        - `arguments` LlamaParseFetchArguments — Arguments for LlamaParse integration
          - `filename` string, nullable
          - `file` union, required
            - string
            - string[]
          - `params` object, nullable
          - `base64` boolean
      - FfmpegIntegrationDef — Ffmpeg integration definition
        - `provider` 'ffmpeg'
        - `method` string, nullable
        - `setup` unknown
        - `arguments` FfmpegSearchArguments — Arguments for Ffmpeg CMD
          - `cmd` string, required
          - `file` union
            - string
            - string[]
      - CloudinaryUploadIntegrationDef — Cloudinary upload integration definition
        - `provider` 'cloudinary'
        - `method` 'media_upload'
        - `setup` CloudinarySetup — Setup parameters for Cloudinary integration
          - `cloudinary_api_key` string, required
          - `cloudinary_api_secret` string, required
          - `cloudinary_cloud_name` string, required
          - `params` object, nullable
        - `arguments` CloudinaryUploadArguments — Arguments for Cloudinary media upload
          - `file` string, required
          - `return_base64` boolean
          - `public_id` string, nullable
          - `upload_params` object, nullable
      - CloudinaryEditIntegrationDef — Cloudinary edit integration definition
        - `provider` 'cloudinary'
        - `method` 'media_edit'
        - `setup` CloudinarySetup — Setup parameters for Cloudinary integration
          - `cloudinary_api_key` string, required
          - `cloudinary_api_secret` string, required
          - `cloudinary_cloud_name` string, required
          - `params` object, nullable
        - `arguments` CloudinaryEditArguments — Arguments for Cloudinary media edit
          - `public_id` string, required
          - `transformation` object[], required
          - `return_base64` boolean
      - ArxivIntegrationDef — Arxiv integration definition
        - `provider` 'arxiv'
        - `method` string, nullable
        - `setup` unknown
        - `arguments` ArxivSearchArguments — Arguments for Arxiv Search
          - `query` string, required
          - `id_list` string[], nullable
          - `max_results` integer
          - `download_pdf` boolean
          - `sort_by` 'relevance' | 'lastUpdatedDate' | 'submittedDate'
          - `sort_order` 'ascending' | 'descending'
      - UnstructuredIntegrationDef — Unstructured integration definition
        - `provider` 'unstructured'
        - `method` string, nullable
        - `setup` UnstructuredSetup — Setup parameters for Unstructured integration
          - `unstructured_api_key` string, required
          - `server_url` string, nullable
          - `server` string, nullable
          - `url_params` object, nullable
          - `retry_config` object, nullable
          - `timeout_ms` integer, nullable
        - `arguments` UnstructuredPartitionArguments — Arguments for Unstructured partition integration
          - `filename` string, nullable
          - `file` string, required
          - `partition_params` object, nullable
      - AlgoliaIntegrationDef — Algolia integration definition
        - `provider` 'algolia'
        - `method` string, nullable
        - `setup` AlgoliaSetup — Integration definition for Algolia
          - `algolia_application_id` string, required
          - `algolia_api_key` string, required
        - `arguments` AlgoliaSearchArguments — Arguments for Algolia Search
          - `index_name` string, required
          - `query` string, required
          - `attributes_to_retrieve` string[], nullable
          - `hits_per_page` integer
    - `system` SystemDef — System definition
      - `resource` 'agent' | 'user' | 'task' | 'execution' | 'doc' | 'session' | 'job', required
      - `operation` 'create' | 'update' | 'patch' | 'create_or_update' | 'embed' | 'change_status' | 'search' | 'chat' | 'history' | 'delete' | 'get' | 'list', required
      - `resource_id` string, uuid, nullable
      - `subresource` 'tool' | 'doc' | 'execution' | 'transition', nullable
      - `arguments` object, nullable
    - `api_call` ApiCallDefInput — API call definition
      - `method` 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH' | 'HEAD' | 'OPTIONS' | 'CONNECT' | 'TRACE', required
      - `url` string, uri, required
      - `schema` object, nullable
      - `headers` object, nullable
      - `secrets` object, nullable
      - `content` string, nullable
      - `data` object, nullable
      - `files` object, nullable
      - `json` object, nullable
      - `cookies` object, nullable
      - `params` union
        - string
        - object
      - `params_schema` ParameterSchemaInput — JSON Schema for API call parameters
        - `type` string
        - `properties` object, required
        - `required` string[]
        - `additionalProperties` boolean, nullable
      - `follow_redirects` boolean, nullable
      - `timeout` integer, nullable
      - `include_response_content` boolean
    - `computer_20241022` Computer20241022Def — Anthropic new tools
      - `type` 'computer_20241022'
      - `name` string
      - `display_width_px` integer
      - `display_height_px` integer
      - `display_number` integer
    - `text_editor_20241022` TextEditor20241022Def
      - `type` 'text_editor_20241022'
      - `name` string
    - `bash_20241022` Bash20241022Def
      - `type` 'bash_20241022'
      - `name` string
  - `tool_choice` union
    - 'auto' | 'none'
    - NamedToolChoice
      - `function` FunctionCallOption
        - `name` string, required
        - `arguments` string, nullable
  - `remember` boolean
  - `recall` boolean
  - `save` boolean
  - `model` string, nullable
  - `stream` boolean
  - `stop` string[]
  - `seed` integer, nullable
  - `max_tokens` integer, nullable
  - `logit_bias` object, nullable
  - `response_format` union
    - SimpleCompletionResponseFormat
      - `type` 'text' | 'json_object'
    - SchemaCompletionResponseFormat
      - `type` 'json_schema'
      - `json_schema` object, required
  - `agent` string, uuid, nullable
  - `repetition_penalty` number, nullable
  - `length_penalty` number, nullable
  - `min_p` number, nullable
  - `frequency_penalty` number, nullable
  - `presence_penalty` number, nullable
  - `temperature` number, nullable
  - `top_p` number, nullable
  - `metadata` object, nullable
  - `auto_run_tools` boolean
  - `recall_tools` boolean

## Response `200`

Successful Response

- RenderResponse
  - `messages` MessageOutput[], required
    - `role` 'user' | 'assistant' | 'system' | 'tool', required
    - `tool_call_id` string, nullable
    - `content` union
      - string
      - string[]
      - union[]
        - union
          - ContentOutput
            - `text` string, required
            - `type` 'text'
          - ContentModel7
            - `image_url` ImageUrl, required — The image URL
              - …
            - `type` 'image_url'
          - AgentsApiAutogenChatContentModelOutput — Anthropic image content part
            - `tool_use_id` string, required
            - `type` 'tool_result'
            - `content` union, required
              - …
    - `name` string, nullable
    - `tool_calls` union[], nullable
      - union
        - ChosenFunctionCall
          - `type` 'function'
          - `function` FunctionCallOption, required
            - `name` string, required
            - `arguments` string, nullable
          - `integration` unknown
          - `system` unknown
          - `api_call` unknown
          - `computer_20241022` ChosenComputer20241022
            - `action` 'key' | 'type' | 'cursor_position' | 'mouse_move' | 'left_click' | 'right_click' | 'middle_click' | 'double_click' | 'screenshot', required
            - `text` string, nullable
            - `coordinate` integer[], nullable
          - `text_editor_20241022` ChosenTextEditor20241022
            - `command` 'str_replace' | 'insert' | 'view' | 'undo_edit', required
            - `path` string, required
            - `file_text` string, nullable
            - `insert_line` integer, nullable
            - `new_str` string, nullable
            - `old_str` string, nullable
            - `view_range` integer[], nullable
          - `bash_20241022` ChosenBash20241022
            - `command` string, nullable
            - `restart` boolean
          - `id` string, nullable
        - ChosenComputer20241022
          - `action` 'key' | 'type' | 'cursor_position' | 'mouse_move' | 'left_click' | 'right_click' | 'middle_click' | 'double_click' | 'screenshot', required
          - `text` string, nullable
          - `coordinate` integer[], nullable
        - ChosenTextEditor20241022
          - `command` 'str_replace' | 'insert' | 'view' | 'undo_edit', required
          - `path` string, required
          - `file_text` string, nullable
          - `insert_line` integer, nullable
          - `new_str` string, nullable
          - `old_str` string, nullable
          - `view_range` integer[], nullable
        - ChosenBash20241022
          - `command` string, nullable
          - `restart` boolean
  - `tools` CreateToolRequestOutput[], nullable
    - `name` string, required
    - `type` 'function' | 'integration' | 'system' | 'api_call' | 'computer_20241022' | 'text_editor_20241022' | 'bash_20241022', required
    - `description` string, nullable
    - `function` FunctionDef — Function definition
      - `name` unknown
      - `description` unknown
      - `parameters` object, nullable
    - `integration` union
      - DummyIntegrationDef
        - `provider` 'dummy'
        - `method` string, nullable
        - `setup` unknown
        - `arguments` unknown
      - BraveIntegrationDef — Brave integration definition
        - `provider` 'brave'
        - `method` string, nullable
        - `setup` BraveSearchSetup — Integration definition for Brave Search
          - `brave_api_key` string, required
        - `arguments` BraveSearchArguments — Arguments for Brave Search
          - `query` string, required
      - EmailIntegrationDef — Email integration definition
        - `provider` 'email'
        - `method` string, nullable
        - `setup` EmailSetup — Setup parameters for Email integration
          - `host` string, required
          - `port` integer, required
          - `user` string, required
          - `password` string, required
        - `arguments` EmailArguments — Arguments for Email sending
          - `to` string, required
          - `from` string, required
          - `subject` string, required
          - `body` string, required
      - SpiderIntegrationDef — Spider integration definition
        - `provider` 'spider'
        - `method` 'crawl' | 'links' | 'screenshot' | 'search', nullable
        - `setup` SpiderSetup — Setup parameters for Spider integration
          - `spider_api_key` string, required
        - `arguments` SpiderFetchArguments — Arguments for Spider integration
          - `url` string, uri, required
          - `content_type` 'application/json' | 'text/csv' | 'application/xml' | 'application/jsonl'
          - `params` object, nullable
      - WikipediaIntegrationDef — Wikipedia integration definition
        - `provider` 'wikipedia'
        - `method` string, nullable
        - `setup` unknown
        - `arguments` WikipediaSearchArguments — Arguments for Wikipedia Search
          - `query` string, required
          - `load_max_docs` integer
      - WeatherIntegrationDef — Weather integration definition
        - `provider` 'weather'
        - `method` string, nullable
        - `setup` WeatherSetup — Integration definition for Weather
          - `openweathermap_api_key` string, required
        - `arguments` WeatherGetArguments — Arguments for Weather
          - `location` string, required
      - MailgunIntegrationDef — Mailgun integration definition
        - `provider` 'mailgun'
        - `method` 'send_email', nullable
        - `setup` MailgunSetup — Setup parameters for Mailgun integration
          - `api_key` string, required
        - `arguments` MailgunSendEmailArguments — Arguments for mailgun.send_email method
          - `to` string, required
          - `from` string, required
          - `subject` string, required
          - `body` string, required
          - `cc` string, nullable
          - `bcc` string, nullable
      - BrowserbaseContextIntegrationDef — browserbase context provider
        - `provider` 'browserbase'
        - `method` 'create_context'
        - `setup` BrowserbaseSetup — The setup parameters for the browserbase integration
          - `api_key` string, required
          - `project_id` string, required
          - `api_url` string, nullable
          - `connect_url` string, nullable
        - `arguments` BrowserbaseContextArguments
          - `projectId` string, required
      - BrowserbaseExtensionIntegrationDef — browserbase extension provider
        - `provider` 'browserbase'
        - `method` 'install_extension_from_github', nullable
        - `setup` BrowserbaseSetup — The setup parameters for the browserbase integration
          - `api_key` string, required
          - `project_id` string, required
          - `api_url` string, nullable
          - `connect_url` string, nullable
        - `arguments` BrowserbaseExtensionArguments
          - `repositoryName` string, required
          - `ref` string, nullable
      - BrowserbaseListSessionsIntegrationDef — browserbase list sessions integration definition
        - `provider` 'browserbase'
        - `method` 'list_sessions'
        - `setup` BrowserbaseSetup — The setup parameters for the browserbase integration
          - `api_key` string, required
          - `project_id` string, required
          - `api_url` string, nullable
          - `connect_url` string, nullable
        - `arguments` BrowserbaseListSessionsArguments
          - `status` 'RUNNING' | 'ERROR' | 'TIMED_OUT' | 'COMPLETED', nullable
      - BrowserbaseCreateSessionIntegrationDef — browserbase create session integration definition
        - `provider` 'browserbase'
        - `method` 'create_session'
        - `setup` BrowserbaseSetup — The setup parameters for the browserbase integration
          - `api_key` string, required
          - `project_id` string, required
          - `api_url` string, nullable
          - `connect_url` string, nullable
        - `arguments` BrowserbaseCreateSessionArguments
          - `projectId` string, nullable
          - `extensionId` string, nullable
          - `browserSettings` object
          - `timeout` integer
          - `keepAlive` boolean
          - `proxies` union
            - boolean
            - object[]
              - …
      - BrowserbaseGetSessionIntegrationDef — browserbase get session integration definition
        - `provider` 'browserbase'
        - `method` 'get_session'
        - `setup` BrowserbaseSetup — The setup parameters for the browserbase integration
          - `api_key` string, required
          - `project_id` string, required
          - `api_url` string, nullable
          - `connect_url` string, nullable
        - `arguments` BrowserbaseGetSessionArguments
          - `id` string, required
      - BrowserbaseCompleteSessionIntegrationDef — browserbase complete session integration definition
        - `provider` 'browserbase'
        - `method` 'complete_session'
        - `setup` BrowserbaseSetup — The setup parameters for the browserbase integration
          - `api_key` string, required
          - `project_id` string, required
          - `api_url` string, nullable
          - `connect_url` string, nullable
        - `arguments` BrowserbaseCompleteSessionArguments
          - `id` string, required
          - `status` 'REQUEST_RELEASE'
      - BrowserbaseGetSessionLiveUrlsIntegrationDef — browserbase get session live urls integration definition
        - `provider` 'browserbase'
        - `method` 'get_live_urls'
        - `setup` BrowserbaseSetup — The setup parameters for the browserbase integration
          - `api_key` string, required
          - `project_id` string, required
          - `api_url` string, nullable
          - `connect_url` string, nullable
        - `arguments` BrowserbaseGetSessionLiveUrlsArguments
          - `id` string, required
      - RemoteBrowserIntegrationDef — The integration definition for the remote browser
        - `provider` 'remote_browser'
        - `method` 'perform_action'
        - `setup` RemoteBrowserSetup, required — The setup parameters for the remote browser
          - `connect_url` string, nullable
          - `width` integer, nullable
          - `height` integer, nullable
        - `arguments` RemoteBrowserArguments — The arguments for the remote browser
          - `connect_url` string, nullable
          - `action` 'key' | 'type' | 'mouse_move' | 'left_click' | 'left_click_drag' | 'right_click' | 'middle_click' | 'double_click' | 'screenshot' | 'cursor_position' | 'navigate' | 'refresh', required
          - `text` string, nullable
          - `coordinate` unknown[], nullable
            - unknown
      - LlamaParseIntegrationDef — LlamaParse integration definition
        - `provider` 'llama_parse'
        - `method` string, nullable
        - `setup` LlamaParseSetup — Setup parameters for LlamaParse integration
          - `llamaparse_api_key` string, required
          - `params` object, nullable
        - `arguments` LlamaParseFetchArguments — Arguments for LlamaParse integration
          - `filename` string, nullable
          - `file` union, required
            - string
            - string[]
          - `params` object, nullable
          - `base64` boolean
      - FfmpegIntegrationDef — Ffmpeg integration definition
        - `provider` 'ffmpeg'
        - `method` string, nullable
        - `setup` unknown
        - `arguments` FfmpegSearchArguments — Arguments for Ffmpeg CMD
          - `cmd` string, required
          - `file` union
            - string
            - string[]
      - CloudinaryUploadIntegrationDef — Cloudinary upload integration definition
        - `provider` 'cloudinary'
        - `method` 'media_upload'
        - `setup` CloudinarySetup — Setup parameters for Cloudinary integration
          - `cloudinary_api_key` string, required
          - `cloudinary_api_secret` string, required
          - `cloudinary_cloud_name` string, required
          - `params` object, nullable
        - `arguments` CloudinaryUploadArguments — Arguments for Cloudinary media upload
          - `file` string, required
          - `return_base64` boolean
          - `public_id` string, nullable
          - `upload_params` object, nullable
      - CloudinaryEditIntegrationDef — Cloudinary edit integration definition
        - `provider` 'cloudinary'
        - `method` 'media_edit'
        - `setup` CloudinarySetup — Setup parameters for Cloudinary integration
          - `cloudinary_api_key` string, required
          - `cloudinary_api_secret` string, required
          - `cloudinary_cloud_name` string, required
          - `params` object, nullable
        - `arguments` CloudinaryEditArguments — Arguments for Cloudinary media edit
          - `public_id` string, required
          - `transformation` object[], required
          - `return_base64` boolean
      - ArxivIntegrationDef — Arxiv integration definition
        - `provider` 'arxiv'
        - `method` string, nullable
        - `setup` unknown
        - `arguments` ArxivSearchArguments — Arguments for Arxiv Search
          - `query` string, required
          - `id_list` string[], nullable
          - `max_results` integer
          - `download_pdf` boolean
          - `sort_by` 'relevance' | 'lastUpdatedDate' | 'submittedDate'
          - `sort_order` 'ascending' | 'descending'
      - UnstructuredIntegrationDef — Unstructured integration definition
        - `provider` 'unstructured'
        - `method` string, nullable
        - `setup` UnstructuredSetup — Setup parameters for Unstructured integration
          - `unstructured_api_key` string, required
          - `server_url` string, nullable
          - `server` string, nullable
          - `url_params` object, nullable
          - `retry_config` object, nullable
          - `timeout_ms` integer, nullable
        - `arguments` UnstructuredPartitionArguments — Arguments for Unstructured partition integration
          - `filename` string, nullable
          - `file` string, required
          - `partition_params` object, nullable
      - AlgoliaIntegrationDef — Algolia integration definition
        - `provider` 'algolia'
        - `method` string, nullable
        - `setup` AlgoliaSetup — Integration definition for Algolia
          - `algolia_application_id` string, required
          - `algolia_api_key` string, required
        - `arguments` AlgoliaSearchArguments — Arguments for Algolia Search
          - `index_name` string, required
          - `query` string, required
          - `attributes_to_retrieve` string[], nullable
          - `hits_per_page` integer
    - `system` SystemDef — System definition
      - `resource` 'agent' | 'user' | 'task' | 'execution' | 'doc' | 'session' | 'job', required
      - `operation` 'create' | 'update' | 'patch' | 'create_or_update' | 'embed' | 'change_status' | 'search' | 'chat' | 'history' | 'delete' | 'get' | 'list', required
      - `resource_id` string, uuid, nullable
      - `subresource` 'tool' | 'doc' | 'execution' | 'transition', nullable
      - `arguments` object, nullable
    - `api_call` ApiCallDefOutput — API call definition
      - `method` 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH' | 'HEAD' | 'OPTIONS' | 'CONNECT' | 'TRACE', required
      - `url` string, uri, required
      - `schema` object, nullable
      - `headers` object, nullable
      - `secrets` object, nullable
      - `content` string, nullable
      - `data` object, nullable
      - `files` object, nullable
      - `json` object, nullable
      - `cookies` object, nullable
      - `params` union
        - string
        - object
      - `params_schema` ParameterSchemaOutput — JSON Schema for API call parameters
        - `type` string
        - `properties` object, required
        - `required` string[]
        - `additionalProperties` boolean, nullable
      - `follow_redirects` boolean, nullable
      - `timeout` integer, nullable
      - `include_response_content` boolean
    - `computer_20241022` Computer20241022Def — Anthropic new tools
      - `type` 'computer_20241022'
      - `name` string
      - `display_width_px` integer
      - `display_height_px` integer
      - `display_number` integer
    - `text_editor_20241022` TextEditor20241022Def
      - `type` 'text_editor_20241022'
      - `name` string
    - `bash_20241022` Bash20241022Def
      - `type` 'bash_20241022'
      - `name` string
  - `tool_choice` union
    - 'auto' | 'none'
    - NamedToolChoice
      - `function` FunctionCallOption
        - `name` string, required
        - `arguments` string, nullable
  - `docs` DocReference[]
    - `metadata` object, nullable
    - `owner` DocOwner, required
      - `id` string, uuid, required
      - `role` 'user' | 'agent', required
    - `id` string, uuid, required
    - `title` string, nullable
    - `snippet` Snippet, required
      - `index` integer, required
      - `content` string, required
      - `embedding` number[], nullable
    - `distance` number, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/julep-ai/apis/julep-agents-api.md) · [All operations](https://skmtc.net/julep-ai/apis/julep-agents-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/julep-ai/julep-agents-api/versions/21c8182519ef/schema)