FE pipeline: Give your oracle tools

Web app as of 2026-10-15

API layer: API pipeline: Give your oracle tools

Goal: give your oracle tools — your own HTTP endpoints and the keys they need — in the web app or the Telegram Mini App.

Steps

1. Store the key. Cabinet → Secrets → New:

• Key name: secret_<name>_<role>, e.g. secret_shop_api_token (only a-z, 0-9, _; starts with secret_, 8–64 characters).
• Value: the key itself. It is never shown again.
• Host: "the key is only ever sent to this host".
• Target workspaces: pick at least one.
• Create.

2. Describe the endpoint. Cabinet → API Endpoints → New:

• Title and Content: what it does and when the oracle should use it.
• Method (GET / POST / PATCH / PUT / DELETE), Path (a full URL, or /… with Domain), Operation id (the tool's name, e.g. orders_status).
• Put the key into the path or text as {{secret_shop_api_token}}.
• Create.

3. Attach. Open your agenda → API endpoints and Secrets → pick both → Save.

What you see

• Secrets lists each key by name and host only; the value never comes back.
• Someone you share an endpoint with can edit its text, but not where it sends or which keys it uses.