org

Vend a short-TTL token confined to this one workspace (create-or-get; shown once) [org admin or manager token]

Vend a short-lived token scoped to exactly one workspace (docs/designs/workspace-tenancy.md: the per-tenant credential). Creates the workspace if the slug is new (create-or-get; cap_usd applies only then - state a budget when each workspace is a tenant or an experiment). The vended token is a gmnt_ bearer for both doors carrying infra scope in that one workspace, expiring after ttl_hours (default 4, max 168); it can never manage workspaces, vend, see the rest of the org, or list/reference org secrets, so vending only NARROWS reach - the token is strictly weaker than the credential you hold - hand it to the session that should be confined there (e.g. one end user's agent). Shown once, not listed on /team; expired rows are swept. Org admins, or a manager service token.

post/preview/org/workspaces/{slug}/tokens

Request

  • Base URL: https://autoresearch.sfcompute.com
  • URL: https://autoresearch.sfcompute.com/preview/org/workspaces/{slug}/tokens
  • Auth: HTTP bearer

Path parameters

slugstring required

The workspace slug the token is confined to (created if new - create-or-get).

Query parameters

workspacestring

Act in this workspace (its slug). Omitted: the token's bound workspace, then the organization's default. Never ambient - there is no switch-workspace mutation on this door.

Request body

cap_usdnumber double nullable

Monthly spend cap in USD, applied only when this call CREATES the workspace. State a budget when each workspace is a tenant.

orgstring nullable

Organization (uuid or name); omitted = your active org.

ttl_hoursinteger nullable

Hours until the vended token expires: 1-168 (default 4).

Response

The capability's JSON result.

objectstring

The resource type, when the result is one resource.

Changes

No recorded changes to this operation across all 1 revision of this API.