Skip to main content
GET
Obtener una funcion de webhook
Returns one webhook function. Same shape as an entry in the list, with header and query-string values masked. The field worth coming here for is used_by_blocks: it tells you which blocks reference the function, which is what you need before deleting it.

Endpoint

Required scope

assistants: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 assistants:read scope.

404 Not Found

No function with that id in the token’s company, or the id belongs to a function that is not a webhook.

502 Bad Gateway

The assistant service is unreachable.

Operational notes

  • A non-webhook function 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 assistants:write. The stored value is never returned by any endpoint.
  • is_active: false means the model will not be offered the function, 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
function
object
required