Scout

Authentication

Every /v1 route requires a Scout API key. Pass it as a Bearer token or X-Scout-Key header. Tier sets both credits and rate limits.

Headers

http

Authorization: Bearer sk_scout_…
# or
X-Scout-Key: sk_scout_…

bash

curl https://scout.macrocontent.dev/v1/usage \
  -H "Authorization: Bearer sk_scout_…"

Key types

Kind	Prefix / source	Notes
Account key	`sk_scout_…` from My Account	Debits the account credit wallet; rate limit from tier
Env key	`SCOUT_API_KEYS` JSON	Legacy / ops; no account wallet debit
Internal	`SCOUT_INTERNAL_API_KEY`	Unlimited, domain-verify bypass, `evaluate` allowed — Macro dogfood

Rate limits (account keys)

Limits are requests per minute per account wallet (shared across keys), separate from credits. Exceeding the limit returns 429 RATE_LIMITED (retryable). Empty credits return 402 CREDITS_EXHAUSTED — not 429.

Tier	Approx. rate limit
Free	~30 / min
Basic	~120 / min
Pro	~250 / min

Plan credits and packs: Tiers & credits.

Create a key (console)

Open My Account → Scout → API keys, create a key, and copy the secret once. Keys share one wallet with your Macrocontent account.

Keep keys secret

Scout keys are server secrets. Do not put them in frontend bundles or public repos.

Authorize in Swagger

Open Swagger UI, click Authorize, paste the key (Bearer scheme or X-Scout-Key).