Update Tool Configuration API Definition
The Update Tool Configuration API enables you to update an existing tool configuration's settings and argument overrides while preserving previous versions for rollback capabilities. Organizations use this API to refine tool behavior, adjust parameters based on performance feedback, and maintain configuration evolution while ensuring agents can continue operating with previous versions if needed.
Update Tool Configuration Request and Response
To update a tool configuration, send a PATCH request to /v2/tools/{tool_id}/configurations/{configuration_id}. You specify the following parameters in the request body:
name(string, optional): Updated human-readable name for the configuration.description(string, optional): Updated description of the configuration's purpose.argument_override(object, optional): Updated argument overrides for the tool.query_configuration(object, optional): Updated query configuration for corpora search tools.metadata(object, optional): Updated metadata for tracking and organization.enabled(boolean, optional): Whether the configuration should be enabled.
The response includes the full definition of the updated configuration with an incremented version number, while preserving all previous versions.
Example Request
1
Example Response
1
Error Responses
The API returns standard HTTP error codes with detailed error information:
| HTTP Code | Error Code | Description |
|---|---|---|
| 400 | invalid_request | Invalid argument overrides or malformed request structure |
| 401 | unauthorized | Invalid or missing API key |
| 403 | forbidden | Insufficient permissions for updating tool configurations |
| 404 | not_found | Tool or tool configuration not found |
| 409 | conflict | Configuration name conflicts with existing configuration |
| 429 | rate_limit_exceeded | Configuration update rate limit exceeded |