---
title: "Your workspace"
url: /trust/account
---

# Your workspace

> Your own account with APIs.Dev: plan and take, allowances and spend caps, verification, the Stripe connection, going Live, suspension and client accounts.

Your workspace is your own account with APIs.Dev: your products and team, your plan and take, your verification and your Stripe connection.

**From sign-up to the first sale.** You sign in with GitHub.

1. Signed up: on Free.
2. Stripe (connect): connected. Or restricted: until Stripe.
3. Verified (evidence): a level. Or more evidence: named.
4. Go Live (the plan prints): a person approves. Or refused: with its cure.
5. Live (approved): the first sale.
6. Statement (plan and take): each month.

Every move is a Build plane Verb, and the move to Live is a person's.

## 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](/trust/planes.md#build) 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](/pricing.md); 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](/workflow.md) 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](/trust/planes.md#build) | 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](/lifecycle.md#end) |
| Each product's end | `Product.sunset`, `Product.transfer`, `Product.export` | [A product's life](/lifecycle.md#end): sunset, close, transfer and export |

### Example
Your coding agent reads the workspace before it proposes the move to Live.

```http title="Response"
HTTP/1.1 200 OK
Content-Type: application/json
X-Cost: price=0, currency="USD"
X-Request-Id: req_6c0b3e9a71d24f58b1e3

{
  "id": "ws_leads",
  "state": "verified",
  "plan": { "name": "Launch", "take": 0.01, "renews": "2026-11-27" },
  "verified": "identity",
  "stripe": "connected",
  "people": 2,
  "allowances": { "calls": { "used": 41200, "of": 5000000 } },
  "spendCaps": { "steps": { "month": 25, "state": "under" } },
  "products": [{ "name": "leads", "state": "test", "host": "leads.io.sb" }]
}
```

That is `GET https://apis.dev/v1/workspace`, `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](/every-product.md) 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](/patterns/service-api.md), open client accounts, and print `"verified": "business"` 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](/reference/contract.md#documents) 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](/terms.md) do not exclude.

| Cause | What stops | What keeps running | The cure |
| --- | --- | --- | --- |
| A plan charge unpaid past its grace | Publishing a new [Version](/reference/platform.md#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.