Listar funciones de webhook
GET /v1/tools
List the webhook tools of your company, with secret values masked.
GET
Listar funciones de webhook
Lists the webhook tools an agent can call. Each one is an HTTPS endpoint of yours: you describe what it does, the model decides when to call it, and Keebai makes the request.
Header and query-string values come back masked as
***; the keys stay visible so you can see the shape of the request. See webhook security.
Endpoint
Required scope
agents:read
Headers
Query parameters
Example request
Response
200 OK
401 Unauthorized
Missing, invalid, revoked, or expired token.403 Forbidden
The token does not have theagents:read scope.
502 Bad Gateway
The agent service is unreachable.Operational notes
- Tools are company-wide, not project-scoped. Unlike agents and their sections, two tokens on two projects of the same company see the same list. A name collision is a company-level collision.
- Only webhook tools appear here. Keebai also has calendar and ecommerce tools that it generates itself; none of them are exposed, and asking for one by id returns
404. See why. - A tool held by an agent cannot be deleted. Deleting returns
409while any agent still holds its id, and the error names them. context.bodyis not masked. It is the request template the model fills in, not a place credentials normally live, and hiding it would remove the main reason to read a tool.totalis a real count: the upstream returns the full set, so the page is sliced here.
Authorizations
Personal Access Token con prefijo kbai_pk_. Generar desde el portal con permiso developer.manage_tokens.
Query Parameters
Required range:
1 <= x <= 200Required range:
x >= 0Devuelve solo las funciones activas.