Tokens
A token is a single-use credential for deploying. Use tokens to grant temporary deploy access without sharing your API key.
Properties
| Property | Description |
|---|---|
token |
Short identifier for management |
labels |
Tags for organization (e.g. ci, staging) |
created |
Creation timestamp |
expires |
Expiration time (optional TTL) |
used |
When the token was last used |
ip |
Locked to a specific IP address (optional) |
Tokens vs API Keys
| API Key | Token | |
|---|---|---|
| Lifetime | Persistent | Expires (optional TTL) |
| Usage | Unlimited | Single-use - consumed on deploy |
| Scope | Full account access | Deploy only |
| Per account | One | Unlimited |
| IP lock | No | Optional |
Precedence: When both are present, the token overrides the API key for that request.
Use Cases
CI/CD - Create a token with a short TTL for each pipeline run. It deploys once and expires.
Collaborators - Share a token instead of your API key. It can only be used once.
Automation - Scoped, auditable, disposable credentials for any tool that deploys on your behalf.
Operations
| Operation | Description |
|---|---|
| Create | Generate a new token with optional TTL and labels |
| List | All active tokens on your account |
| Remove | Revoke a token |