Manage API Keys

API keys authenticate programmatic access to ZAM. Each key carries a set of scopes that limit what it can do.

Your first key

When you create a wallet (zam wallet create), you receive an API key with all scopes. This is your admin key. For production use, create additional keys with narrower scopes.

Create a key

CLI
API
Dashboard

zam api-keys create

The CLI prompts for a name and lets you select scopes from a checklist. It prints the full key once.

curl -X POST https://api.zeroclick.am/v1/api-keys \
  -H "Content-Type: application/json" \
  -H "x-zam-api-key: zam_your_key_here" \
  -d '{
    "name": "production-agent",
    "scopes": ["order:create", "order:read", "provider:read"]
  }'

The response includes plaintextKey. Copy it now. ZAM stores only the hash; the plaintext never appears again.

{
  "id": "KEY_ID",
  "name": "production-agent",
  "keyPrefix": "zam_a1b2c3d4",
  "plaintextKey": "zam_a1b2c3d4e5f6...",
  "scopes": ["order:create", "order:read", "provider:read"]
}

Key format

All keys start with zam_ followed by 40 hex characters. The prefix zam_a1b2c3d4 (first 8 characters after zam_) appears in listings and logs so you can identify keys without exposing the full value.

Scopes

Grant the minimum scopes each key needs:

Use case	Scopes
Agent that only activates listings	`order:create`, `order:read`
Agent that also browses own listings	Add `provider:read`
Service that publishes listings	`provider:create`, `provider:read`, `provider:update`
Admin key	All scopes

Revoke a key

CLI
API
Dashboard

zam api-keys delete KEY_ID

curl -X DELETE https://api.zeroclick.am/v1/api-keys/KEY_ID \
  -H "x-zam-api-key: zam_your_key_here"

Revoked keys stop working immediately.

Environment variables

Both the CLI and API client accept the ZAM_API_KEY environment variable, which takes precedence over any stored configuration:

export ZAM_API_KEY=zam_your_key_here

Getting Started

Buy on ZAM

Sell on ZAM

Account

Tools

Your first key

Create a key

Key format

Scopes

Revoke a key

Environment variables

Getting Started

Buy on ZAM

Sell on ZAM

Account

Tools

​Your first key

​Create a key

​Key format

​Scopes

​Revoke a key

​Environment variables

Your first key

Create a key

Key format

Scopes

Revoke a key

Environment variables