Get Tool Configuration API Definition
The Get Tool Configuration API enables you to retrieve the details of a specific tool configuration by its ID, including its settings and argument overrides. Organizations use this API to inspect configuration details, compare different versions, and understand how tool configurations are structured before reusing them in other agents.
Get Tool Configuration Request and Response
To get a tool configuration, send a GET request to /v2/tools/{tool_id}/configurations/{configuration_id}. You can specify the following optional query parameters:
version(integer, optional): Specific version to retrieve (defaults to the latest version).
The response includes the complete configuration definition, including all settings, metadata, and version information.
Example Request
EXAMPLE REQUEST
1
Example Response
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 version parameter or malformed request |
| 401 | unauthorized | Invalid or missing API key |
| 403 | forbidden | Insufficient permissions for accessing tool configurations |
| 404 | not_found | Tool, configuration, or specified version not found |
| 429 | rate_limit_exceeded | Request rate limit exceeded |