Your workspace
Open in
Your workspace is your own account with APIs.Dev: your products and team, your plan and take, your verification and your Stripe connection.
Every move is a Build plane Verb, and the move to Live is a person's. Filled: what your Customers see. The point marks the money you are paid.
What a workspace holds
A workspace is the scope above your products. One plan covers every product in it, and every act on it is a Build plane Verb.
| Family | Verbs | What it does |
|---|---|---|
| The workspace | Workspace.get, Workspace.close | Its state, plan, take, verification level and Stripe connection; it closes once every product is closed or transferred |
| Plan and take | Workspace.upgrade, Workspace.downgrade | One of the four plans on the price list; an upgrade's take applies from the next charge, a downgrade's at the period's end |
| Allowances and spend caps | Allowance.list, SpendCap.set, TopUp.create | Each meter against its allowance; past it, usage bills at cost up to the cap, which stops model calls and Workflow steps, never a paying Customer's call |
| Statements | Statement.list | Each month: the plan, the take charge by charge, and usage past the allowance |
| Stripe | StripeAccount.connect | The account every Customer pays into, connected once and checked before the move to Live |
| Verification | Workspace.verify | Who answers for the sales, checked in levels; each level lets the workspace sell more |
| Your team | Teammate.invite, Token.create and the rest | People and agents under your Roles; agents never count toward a plan's people |
| Client accounts | ClientAccount.create, ClientAccount.handoff | A client's own place on its own Stripe; a handoff keeps the product here with a statement per client, or moves it by transfer |
| Each product's end | Product.sunset, Product.transfer, Product.export | A product's life: sunset, close, transfer and export |
Example
Your coding agent reads the workspace before it proposes the move to Live.
HTTP/1.1 200 OK
Content-Type:That is GET https:, npx apis.dev workspaces get in the CLI, and getWorkspace over MCP.
States and levels
Each state is one the workspace's owner sees in the console, the CLI and Workspace.get, with the move that leaves it.
| Thing | States | What moves it |
|---|---|---|
| A workspace | signed_up, verified, live, past_due, suspended, closed | Sign-up; verification; the first product's move to Live; a failed plan charge, with 14 days of grace; a suspension and its cure; Workspace.close |
| A Stripe connection | none, onboarding, restricted, connected, disconnected | StripeAccount.connect, then Stripe's own checks; a restricted account takes no Live charge until Stripe lifts it |
| A verification level | email, identity, business | A checked email; a person's identity, checked through Stripe; then the business's registration and tax details |
| A client account | open, handed_off, closed | ClientAccount.create; a handoff, kept or moved |
| A spend cap | under, warned, reached, then under when the period turns | Alerts at 50, 80 and 100 percent; at the cap, only usage past the allowance stops |
| Level | What it lets the workspace do |
|---|---|
email | Build, deploy to Test, and call every Interface with a Test key |
identity | Go Live, take payments within the limits Stripe sets a new account, and receive payouts |
business | Sell past those limits, run suppliers in a Marketplace or a Service API, open client accounts, and print "verified": on every offer card and receipt |
Going Live, and what stops a workspace
The move to Live is always made by a person on your team, on evidence the deploy plan prints first.
| Evidence | What it shows |
|---|---|
| A passing check and plan | Every Verb priced, at or above cost, with no breaking change left |
Stripe connected | Charges and payouts are on for your account |
A verification level of identity or above | Who answers for the sales |
| One Test call per Verb | Each Verb answers as its docs print it |
| Published terms and refund rule | What the offer card and every receipt bind |
The approver holds your team's owner or admin Role. An agent proposes the move and it waits as Pending, so Environment.promote runs once on a person's grant.
A workspace sells anything the law allows that the terms do not exclude.
| Cause | What stops | What keeps running | The cure |
|---|---|---|---|
| A plan charge unpaid past its grace | Publishing a new Version | Every product, and every paying Customer's call | Pay the statement |
| A lapsed verification | Payouts | Serving and sales | Verify again |
| Fraud, abuse or a breach of the terms | New sales and new sign-ups | Existing Customers, their records and their exports | The evidence the notice names, reviewed by a person |
Every suspension names its reason and its cure, and writes an Event. A person at APIs.Dev reviews it, and nothing is deleted.
What you, your clients and your Customers meet
- You. One plan and one statement for every product, the take line by line, and a cap on anything that bills past the allowance.
- Your coding agent. It builds, deploys to Test and proposes the move to Live, which waits for you. Payouts, transfers and closing are reserved to a person.
- A client. Its own account on its own Stripe, a statement of what its products used, and a handoff when you finish.
- Customers. Your brand only, and your verified identity on each offer card and receipt. A billing problem of yours never stops their calls.
A workspace is the one account behind every product you sell, and every act on it is a Verb your agent can call.
The Build and Operator planes
Every act a console offers you is a Verb on the platform API first, so your team, your CLI and your agents run the product with no UI.
Data governance
How a product treats the data it holds: classes on fields, controller and processor, a generated DPA, people's requests, customer-held keys and the data chain.