---
title: "Changes to Create Agent Tool"
method: POST
path: "/agents/{agent_id}/tools"
---

# Changes to Create Agent Tool

`POST /agents/{agent_id}/tools`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 11 of 44 revisions.

- **2025-07-01** `e680900fd043` — 1 breaking, 3 info
- **2025-05-12** `3b58badc86fa` — 2 info
- **2025-05-12** `088c2ebb8988` — 4 info
- **2025-03-20** `14e6e11ab9b7` — 4 breaking
- **2025-03-14** `4e3835be6609` — 2 info
- **2025-03-13** `88911baf2b4b` — 2 breaking, 1 warning, 3 info
- **2025-03-03** `1f91c7da5438` — 2 breaking, 6 info
- **2025-02-17** `d71538f9a51a` — 1 breaking, 1 info
- **2025-01-27** `f87931a479bd` — 1 warning, 12 info
- **2025-01-16** `ea124be3fdbc` — 1 breaking
- **2025-01-16** `a707ace7212c` — 1 info

## Changes

- **2025-07-01** `e680900fd043` — 1 breaking, 3 info
  - removed `#/components/schemas/ApiCallDef` from the `api_call` request property `anyOf` list
  - added `#/components/schemas/ApiCallDef-Input` to the `api_call` request property `anyOf` list
  - added `#/components/schemas/ApiCallDef-Output` to the `api_call` response property `anyOf` list for the response status `201`
  - removed `#/components/schemas/ApiCallDef` from the `api_call` response property `anyOf` list for the response status `201`
- **2025-05-12** `3b58badc86fa` — 2 info
  - added the new optional request property `api_call/anyOf[subschema #1: ApiCallDef]/secrets`
  - added the optional property `api_call/anyOf[subschema #1: ApiCallDef]/secrets` to the response with the `201` status
- **2025-05-12** `088c2ebb8988` — 4 info
  - added the new optional request property `api_call/anyOf[subschema #1: ApiCallDef]/include_response_content`
  - added `#/components/schemas/MailgunIntegrationDef` to the `integration` request property `anyOf` list
  - added the optional property `api_call/anyOf[subschema #1: ApiCallDef]/include_response_content` to the response with the `201` status
  - added `#/components/schemas/MailgunIntegrationDef` to the `integration` response property `anyOf` list for the response status `201`
- **2025-03-20** `14e6e11ab9b7` — 4 breaking
  - request property `integration/anyOf[subschema #21: AlgoliaIntegrationDef]/arguments/anyOf[subschema #1: AlgoliaSearchArguments]/attributes_to_retrieve` list-of-types was narrowed by removing types `object` from media type `application/json`
  - the `integration/anyOf[subschema #21: AlgoliaIntegrationDef]/arguments/anyOf[subschema #1: AlgoliaSearchArguments]/attributes_to_retrieve/anyOf[subschema #1]/` request property type/format changed from `object`/`` to `array`/``
  - response property `integration/anyOf[subschema #21: AlgoliaIntegrationDef]/arguments/anyOf[subschema #1: AlgoliaSearchArguments]/attributes_to_retrieve` list-of-types was widened by adding types `array` to media type `application/json` of response `201`
  - the `integration/anyOf[subschema #21: AlgoliaIntegrationDef]/arguments/anyOf[subschema #1: AlgoliaSearchArguments]/attributes_to_retrieve/anyOf[subschema #1]/` response's property type/format changed from `object`/`` to `array`/`` for status `201`
- **2025-03-14** `4e3835be6609` — 2 info
  - added `#/components/schemas/AlgoliaIntegrationDef` to the `integration` request property `anyOf` list
  - added `#/components/schemas/AlgoliaIntegrationDef` to the `integration` response property `anyOf` list for the response status `201`
- **2025-03-13** `88911baf2b4b` — 2 breaking, 1 warning, 3 info
  - added the new required request property `integration/anyOf[subschema #2: BraveIntegrationDef]/setup/anyOf[subschema #1: BraveSearchSetup]/brave_api_key`
  - removed the required property `integration/anyOf[subschema #2: BraveIntegrationDef]/setup/anyOf[subschema #1: BraveSearchSetup]/api_key` from the response with the `201` status
  - removed the request property `integration/anyOf[subschema #2: BraveIntegrationDef]/setup/anyOf[subschema #1: BraveSearchSetup]/api_key`
  - added `#/components/schemas/UnstructuredIntegrationDef` to the `integration` request property `anyOf` list
  - added `#/components/schemas/UnstructuredIntegrationDef` to the `integration` response property `anyOf` list for the response status `201`
  - added the required property `integration/anyOf[subschema #2: BraveIntegrationDef]/setup/anyOf[subschema #1: BraveSearchSetup]/brave_api_key` to the response with the `201` status
- **2025-03-03** `1f91c7da5438` — 2 breaking, 6 info
  - removed `#/components/schemas/ApiCallDef-Input` from the `api_call` request property `anyOf` list
  - removed `#/components/schemas/SpiderIntegrationDef-Input` from the `integration` request property `anyOf` list
  - added `#/components/schemas/ApiCallDef` to the `api_call` request property `anyOf` list
  - added `#/components/schemas/SpiderIntegrationDef` to the `integration` request property `anyOf` list
  - added `#/components/schemas/ApiCallDef` to the `api_call` response property `anyOf` list for the response status `201`
  - added `#/components/schemas/SpiderIntegrationDef` to the `integration` response property `anyOf` list for the response status `201`
  - removed `#/components/schemas/ApiCallDef-Output` from the `api_call` response property `anyOf` list for the response status `201`
  - removed `#/components/schemas/SpiderIntegrationDef-Output` from the `integration` response property `anyOf` list for the response status `201`
- **2025-02-17** `d71538f9a51a` — 1 breaking, 1 info
  - response property `integration/anyOf[subschema #16: FfmpegIntegrationDef]/arguments/anyOf[subschema #1: FfmpegSearchArguments]/file` list-of-types was widened by adding types `array` to media type `application/json` of response `201`
  - request property `integration/anyOf[subschema #16: FfmpegIntegrationDef]/arguments/anyOf[subschema #1: FfmpegSearchArguments]/file` list-of-types was widened by adding types `array` to media type `application/json`
- **2025-01-27** `f87931a479bd` — 1 warning, 12 info
  - removed the optional property `jobs` from the response with the `201` status
  - added the optional property `api_call` to the response with the `201` status
  - added the optional property `bash_20241022` to the response with the `201` status
  - added the optional property `computer_20241022` to the response with the `201` status
  - added the optional property `description` to the response with the `201` status
  - added the optional property `function` to the response with the `201` status
  - added the optional property `integration` to the response with the `201` status
  - added the optional property `system` to the response with the `201` status
  - added the optional property `text_editor_20241022` to the response with the `201` status
  - added the required property `name` to the response with the `201` status
  - added the required property `type` to the response with the `201` status
  - added the required property `updated_at` to the response with the `201` status
  - the response required property `id` became read-only for the status `201`
- **2025-01-16** `ea124be3fdbc` — 1 breaking
  - removed `#/components/schemas/BrowserbaseGetSessionConnectUrlIntegrationDef` from the `integration` request property `anyOf` list
- **2025-01-16** `a707ace7212c` — 1 info
  - added `#/components/schemas/BrowserbaseGetSessionConnectUrlIntegrationDef` to the `integration` request property `anyOf` list

---

[Operation](https://skmtc.dev/julep-ai/apis/julep-agents-api/docs/agents/:agent_id/tools/post.md) · [API](https://skmtc.dev/julep-ai/apis/julep-agents-api.md) · [Page](https://skmtc.dev/julep-ai/apis/julep-agents-api/changes/agents/:agent_id/tools/post)