The subdomain in API requests
Admin API requests go to your workspace’s own host:{partner} with your workspace’s slug (lowercase letters, digits, and
hyphens). The API verifies that the organization inside your bearer token
matches the workspace the subdomain resolves to — a mismatched token gets a
403, even if it’s otherwise valid. You can’t reach one partner’s data
through another partner’s domain.
Reserved subdomains —
www, app, api, admin, auth, static,
assets, cdn, mail — are never assignable as partner slugs.Why a domain per partner?
Pinning each workspace to its own host gives isolation at the transport layer, not just in application code:- Dashboard sessions are host-only cookies — a session on
acme.mytraddal.comis physically unavailable toglobex.mytraddal.com. - API tokens carry the organization; the subdomain must agree with it.
- Row-level security in the database scopes every query to the organization, as a final backstop.