Skip to main content
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 the agents: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, not 403. 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 with agents:write. The stored value is never returned by any endpoint.
  • is_active: false means the model will not be offered the tool, but the configuration is intact. It is the reversible way to switch one off.
  • type is always webhook on this surface, and is included so the field is not silently absent from a contract that upstream considers polymorphic.

Authorizations

Authorization
string
header
required

Personal Access Token con prefijo kbai_pk_. Generar desde el portal con permiso developer.manage_tokens.

Path Parameters

id
string
required

Response

200 - application/json
tool
object
required