---
title: "Update Agent Tool"
method: PUT
path: "/agents/{agent_id}/tools/{tool_id}"
tags: ["agents"]
---

# Update Agent Tool

`PUT /agents/{agent_id}/tools/{tool_id}`

## Path parameters

- `agent_id` string, uuid, required
- `tool_id` string, uuid, required

## Request body

- UpdateToolRequest — Payload for updating a tool
  - `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

## Response `200`

Successful Response

- Tool
  - `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
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `id` string, uuid, required

## 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)