API Keys

Overview

API keys grant administrative capabilities to backend services, CI/CD runners, and cron jobs.

Creating & Scoping Keys

Create scoped keys via API:

curl -X POST https://asiyst.com/api/v1/api-keys \
  -H "Authorization: Bearer $ASIYST_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "GitHub CI Key",
    "scopes": ["knowledge:write", "deploy:write"],
    "expiresIn": "90d"
  }'

Revoking Keys via API

curl -X DELETE https://asiyst.com/api/v1/api-keys/key_12345 \
  -H "Authorization: Bearer $ASIYST_API_TOKEN"