orgs

Create a new organization with you as admin ({name} in body); prepaid at a zero balance, your active org unchanged [org:write; a person, not a service token]

Create a team: a new organization with you as its admin, for work with other people (any person; not a service token). Your personal organization is the one made at signup, for you alone. Invite people to the team with invite_member(email, org). A team has its own members, workspaces and balance: prepaid, starting at zero, with no free credit and no card. buy_credits(org, amount_usd) answers with a payment link for its first credit, and the answer's fund_url is the same payment on the web. That payment saves a card; after it, buy_credits(org) charges the card and set_auto_topup(org) works. Your active organization does not change. The tools that take org (billing, members, workspaces, caps: invite_member(org), create_workspace(org)) act in it when you pass it. Nodes, jobs and sandboxes go where this connection acts: to start them in the new organization, call switch_active_org on a connection not opened in a specific organization, or connect again and choose it. Refused while you are admin of 10 or more organizations.

post/preview/orgs

Request

  • Base URL: https://autoresearch.sfcompute.com
  • URL: https://autoresearch.sfcompute.com/preview/orgs
  • 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

namestring required

The new team's name: 1-80 characters, not one of the organizations you already belong to (other org tools take it as the org selector).

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.