Obtener una funcion de webhook
GET /v1/tools/{id}
Get one webhook tool with its request shape and its parameters.
GET
Obtener una funcion de webhook
Returns one webhook tool. Same shape as an entry in the list, with header and query-string values masked.
The parameters are the part worth reading: their names and descriptions are what the model sees when it decides whether to call the tool.
Endpoint
Required scope
agents:read
Headers
Path parameters
Example request
Response
200 OK
401 Unauthorized
Missing, invalid, revoked, or expired token.403 Forbidden
The token does not have theagents:read scope.
404 Not Found
No tool with that id in the token’s company, or the id belongs to a tool that is not a webhook.502 Bad Gateway
The agent service is unreachable.Operational notes
- A non-webhook tool reads as
404, not403. An id you cannot manage is deliberately indistinguishable from one that does not exist. - The masked values are not a permissions thing. Every caller sees
***, including one withagents:write. The stored value is never returned by any endpoint. is_active: falsemeans the model will not be offered the tool, but the configuration is intact. It is the reversible way to switch one off.typeis alwayswebhookon this surface, and is included so the field is not silently absent from a contract that upstream considers polymorphic.