sten.wtf
Docs
Reference

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.

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, bots
  • GET /catalog — types, hosts, durations, store rules
  • GET|POST /links — list / create
  • GET|PATCH|DELETE /links/{code} — one link. PATCH is hosts and store look only
  • GET /agents.md — this API as markdown