curl -X POST https://api.treeship.dev/v1/keys/request \
  -H "Content-Type: application/json" \
  -d '{"email": "you@example.com"}'

{
  "message": "Verification code sent to you@example.com",
  "expires_in": 600
}

curl -X POST https://api.treeship.dev/v1/keys/verify \
  -H "Content-Type: application/json" \
  -d '{"email": "you@example.com", "code": "123456"}'

{
  "api_key": "ts_live_a1b2c3d4e5f6...",
  "key_id": "key_abc123",
  "created_at": "2026-02-23T10:00:00Z"
}

curl -X POST https://api.treeship.dev/v1/attest \
  -H "Authorization: Bearer ts_live_..." \
  -H "Content-Type: application/json" \
  -d '{"agent_slug": "my-agent", "action": "...", "inputs_hash": "..."}'

from treeship_sdk import Treeship

# From environment variable (recommended)
ts = Treeship()  # reads TREESHIP_API_KEY

# Or explicit
ts = Treeship(api_key="ts_live_...")

# Environment variable
export TREESHIP_API_KEY=ts_live_...
treeship attest --action "..." --inputs-hash "..."

# Or configure once
treeship config set api-key ts_live_...

curl https://api.treeship.dev/v1/keys/info \
  -H "Authorization: Bearer $TREESHIP_API_KEY"

{
  "key_id": "key_abc123",
  "email": "you@example.com",
  "created_at": "2026-02-23T10:00:00Z",
  "attestations_today": 42,
  "rate_limit": 1000
}

curl -X DELETE https://api.treeship.dev/v1/keys \
  -H "Authorization: Bearer $TREESHIP_API_KEY"

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 958
X-RateLimit-Reset: 1640995200

{
  "detail": "Invalid API key"
}