Authentication

​

Get your API key

1. Sign up at app.artifacta.io/signup
2. Complete onboarding — a key is auto-generated for you
3. Or create additional keys at app.artifacta.io/dashboard/keys

​

Key format

ak_live_<32 alphanumeric characters>

​

Authenticate the CLI

export ARTIFACTA_API_KEY="ak_live_abc123..."

artifacta auth login
# Enter your API key: ak_live_abc123...
# ✓ Authenticated as tenant "acme-corp"

echo "$ARTIFACTA_API_KEY" | artifacta auth login

artifacta auth login --key ak_live_abc123

​

Authenticate the Python SDK

from artifacta import Client

# Option 1: Auto-detect from environment or config file
client = Client()
# Reads ARTIFACTA_API_KEY from env, then ~/.config/artifacta/config.toml

# Option 2: Explicit key
client = Client(api_key="ak_live_abc123")

​

Authenticate the REST API

curl https://api.artifacta.io/v1/artifacts \
  -H "Authorization: Bearer ak_live_abc123"

​

Verify authentication

artifacta whoami

Tenant:  acme-corp
Plan:    free
Key:     ...k9f7 (last 4)
Usage:   0 / 10,000 requests this month
Storage: 0 B / 1 GB

info = client.whoami()
print(info.tenant_name)  # "acme-corp"
print(info.plan)         # "free"

​

Key limits

​

Security notes

• Keys are hashed (SHA-256) before storage — Artifacta never stores your full key
• A revoked key is immediately unusable
• Keys do not expire — revoke manually when no longer needed
• All keys have full tenant access (no per-key permission scopes in V1)