Skip to main content
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 the agents: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 409 while any agent still holds its id, and the error names them.
  • context.body is 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.
  • total is a real count: the upstream returns the full set, so the page is sliced here.

Authorizations

Authorization
string
header
required

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

Query Parameters

limit
number
default:50
Required range: 1 <= x <= 200
offset
number
default:0
Required range: x >= 0
active_only
boolean
default:false

Devuelve solo las funciones activas.

Response

200 - application/json
total
number
required
limit
number
required
offset
number
required
data
object[]
required