- Workspace
- Its members share its API keys, its prepaid balance and its usage
- Keys
- Start with
dn_live_, are shown once, and work with both models and every endpoint - Roles
- Owner, Admin, Developer and Billing
- Test keys
- None: every key is live and billed (see Plans). Try requests in the playground
- Where
- Console: Home, Playground, Usage, API keys, Billing and Settings
Workspaces#
A workspace is the unit of access and billing. Everyone in it shares its API keys, its prepaid balance and its usage charts, and every request any of its keys sends is drawn from the one balance. Rate limits are the workspace's too, shared by all its keys; a key may carry its own lower limits, so one device or service cannot use up the rest (see Rate limits). Rename a workspace under Settings; the name, 2 to 40 characters, shows in the sidebar and on receipts. Under Settings an Owner or Admin can also turn off DecisionNode Flash fallback (the fallback policy never), so a DecisionNode request is never answered by DecisionNode Flash when DecisionNode has no ready capacity, but gets a 529 to retry instead (see No ready capacity).
Members and roles#
| Role | May |
|---|---|
| Owner | Everything, including deleting the workspace |
| Admin | Manage keys, members, billing, settings and boosters |
| Developer | Create and revoke keys, read usage, fine-tune and deploy models |
| Billing | Manage the balance, auto reload and invoices |
- Invite people by email under Settings, with the role they need. Give developers the Developer role and the finance team Billing.
- Change a role at any time from the members list.
- Removing a member ends their access to the workspace at once. Keys they created keep working until you revoke them, so revoke a person's keys when they leave, or rotate them as below.
API keys#
- Create a key under API keys, choose What this key can do (its kind: Full access, Decisions only, Manage device keys or Publishable), and give it a name of up to 48 characters, such as the service that will use it. The full secret is shown once, when you create it. Store it in your secret manager or in the
DECISIONNODE_API_KEYenvironment variable straight away: afterwards the console keeps only its last four characters. - A key reaches what its kind allows. A Full access key works with both models,
/v1/decide, sessions, batch jobs, collections,/v1/modelsand per-key usage; a Decisions-only key only decides and lists the models, and searches collections only with May search your face collections ticked; a Publishable key only decides. Those two may carry their own rate limits and a daily spend cap, always on for a Publishable key. A Manage device keys key only makes, changes and revokes Decisions-only keys and reads keys' usage. The kind is set when the key is made. Batches and sessions belong to the key that created them. - Track use. The keys table shows who created each key, when, and when it was last used. Search by name, id or last four.
- Revoke a key from its row. Revoking is immediate and cannot be undone: the next call with it gets
401, and a session stream it connects closes with code4401. - Rate limits of your workspace are on the Rate limits tab.
Rotating a key#
Rotate a key when someone who held it leaves, when it may have leaked, or on your own schedule. Two keys can be live at once, so rotation needs no downtime:
- 1.Create a new key, named for the service and the date.
- 2.Deploy it: put it in your secret manager and roll your service so every instance reads it.
- 3.Check the switch: the old key's last used stops moving, and Usage filtered by key shows traffic only on the new one.
- 4.Let what belongs to the old key finish: its open sessions, and the results of its batch jobs, which only the key that created them can read.
- 5.Revoke the old key.
Usage#
Usage charts spend, input tokens and requests for the workspace, and says how it pays: from your prepaid balance, or, on a dedicated workspace, billed on your monthly invoice. Filter by model (or all models), by key (revoked keys included), and by range: 24 hours, 7 days or 30 days, read hourly (up to 7 days) or daily (7 days or more). Spend is input tokens at each model's price, or your agreed rates, and booster calls: what your workspace is charged, the same as your invoice and per-key usage (at agreed rates, a couple of minutes behind). Output is free. In code, usage.input_tokens on each response is exactly what that request billed.
Boosters and fine-tuning#
Boosters lists the boosters your requests may name, what each reads and costs, and a switch for each. Every booster is on for a new workspace; an Owner or Admin turns one off or on, and the change applies within a second. Fine-tuning holds your fine-tuned models: their datasets, training runs, scorecards and deployments. Every member can see both pages; Owners, Admins and Developers can train, deploy and cancel a run. To label past requests, an Owner or Admin turns on Keep requests for labelling: answered requests are then kept for 30 days in the workspace's storage location (see Label your history).
Start#
Start is where a workspace without a plan begins: after sign-up, an Owner, Admin or Billing member chooses how it starts before the rest of the console opens. Starter and Business start at once, monthly or yearly, without a trial. A Developer of a workspace with no plan sees that the workspace has no plan, and asks its owner. A workspace whose trial was cancelled or whose plan ended comes back to this step. See Plans.
Plan#
Plan shows the workspace's plan. During the trial: the days left, the usage of the trial's cap, and the date and amount it converts at, with Start (unavailable) now, Switch to Starter and Cancel trial. On a plan: the allowance used this period and the day it resets, today's booster test calls and what the plan includes. Every member can see it; an Owner, Admin or Billing member upgrades at once, downgrades or cancels at the period end, and undoes a waiting change with Keep my plan. Where a plan limits what you are doing, a booster outside it, a knowledge base or a batch job below Pro, fine-tuning below Business, a key or member past the count, the console says which plan includes it and what it costs each time you try. A Developer gets Ask your workspace owner, which sends the request to the Owners, Admins and Billing members, on their Plan page and in a daily email, with a message to copy as well. See Plans.
Billing#
Billing holds the balance, top-ups, auto reload and one receipt per payment. What a request costs and how the balance works is on Pricing and billing.
Deleting a workspace#
Only the Owner can delete a workspace, under Settings, by typing its name to confirm. Every key stops working at once, the remaining balance is forfeited, and it cannot be undone. Download what you need first: receipts, usage, and the results of any batch jobs.
Creating a key means you accept the Terms of Service and the Acceptable Use Policy on behalf of your organisation.