Create an API Key
Create a Staso API key from the dashboard and export it as STASO_API_KEY so the Python SDK can authenticate.
export STASO_API_KEY=ak_...Steps
- Sign up. Go to staso.ai and sign in with Google or GitHub OAuth.
- Your first organization is created automatically. A default workspace is created inside it — you can rename both later.
- Open Settings → API Keys in the dashboard.
- Create a key. Give it a name (e.g.
prod-backend) and choose a scope (see below). Only workspace members with thecreate_api_keyspermission can issue keys. - Copy the raw key. The raw value is shown exactly once. Store it as
STASO_API_KEYin your environment, secret manager, or.envfile. After that the dashboard only shows the key prefix.
Scope choices
API keys are scoped at creation time and the scope cannot be changed later. Pick based on what the key needs to write to.
| Scope | What it can do | Use when |
|---|---|---|
full_org | Writes to any workspace in the organization. | One key per service that spans multiple workspaces. |
workspace_scoped | Writes only to the workspaces you select at creation time. | Isolating environments, teams, or customers. |
Default to workspace_scoped unless you have a concrete reason to span the org. See organizations and workspaces for the data model.
Rotating keys
You can deactivate a key at any time from Settings → API Keys. Deactivated keys stop accepting ingest immediately. Create a new key, roll it out, then deactivate the old one — there's no rotation downtime.
Plan note
A new organization starts on no_plan. Ingest is blocked until you upgrade. Upgrade from the billing page before running a production agent — see pricing and the API keys platform guide for details.
Next
Head to the Quickstart to initialize the SDK with your new key.