org

Create-or-get a workspace ({workspace} in body; cap_usd applies on create) [org admin or manager token]

Create a workspace (or get it if the slug already exists - create-or-get, safe to retry). A workspace is the compute boundary inside your org: nodes and jobs belong to one, names are unique per workspace, and its spend cap bounds everything in it. Pass cap_usd to set a monthly budget at creation (recommended when scripting per-tenant or per-experiment workspaces); without it the org cap is the only wall. Org admins, or a manager service token.

put/preview/org/workspaces

Request

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

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 (an existing workspace's cap is set_workspace_cap's job). Omitted = uncapped at this layer; the org cap is the outer wall.

orgstring nullable

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

workspacestring required

The workspace slug: 1-40 chars of lowercase letters, digits, and hyphens. Create-or-get: an existing slug is returned, not an error.

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.