Links Beam API
HTTP REST for creating, listing, editing, and deleting beaming links — plus free extra generators who share your cap.
HTTP for beaming links
The Links Beam API is how you create, list, edit, and delete gift / checkout links without opening the dashboard. It lives on the Accounts Toolkit — plain HTTPS JSON — not the WebSocket AutoSecure engine.
Base: https://sten.wtf/api/v1/beam. Auth: Authorization: Bearer sk_... from Settings → API Keys. WebSocket access is not required.
Licence gate
The holder needs an active sten licence and a Links licence. Same rules as the Links page: a bot is required to create, the live cap is two links per bot slot (minimum two), and a link lasts 1, 2, or 4 hours.
GET /api/v1/beam/me is the first call. It returns both licences, remaining slots, and the bot indexes you pass as bot_id.
Generate Links permission (like Claim)
Extra generators are a toggle on the bot, next to Claim. Open the bot → Users, add their Discord ID (or edit someone already there), and turn on Generate Links. They do not need AutoSecure or Links. They are not billed. Links they create count against your cap.
They sign in to sten.wtf with Discord, make an API key, and call this API. GET /me returns role: 'generator'. Turn the toggle off to cut access. Role Access can grant the same toggle to a Discord role; the HTTP API only sees people added as bot users.
Give this to an agent
Fetch the machine doc
GET https://sten.wtf/api/v1/beam/agents.md — no key. That file is the source of truth for paths, bodies, and errors.
Catalog, then me
GET /catalog (public) then GET /me with the key. Do not invent hosts or types.
Create, return the gift URL
POST /links. Hand humans data.url, not the checkout hop, unless they asked for Tebex.
Full reference also sits on the API reference Toolkit tab.
Map
GET /me— identity, licences, limits, botsGET /catalog— types, hosts, durations, store rulesGET|POST /links— list / createGET|PATCH|DELETE /links/{code}— one link. PATCH is hosts and store look onlyGET /agents.md— this API as markdown
