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://api.scout.macrocontent.dev/v1/usage \
  -H "Authorization: Bearer sk_scout_…"

API keys

Early-access keys look like sk_scout_…, share one credit wallet on your Macrocontent account, and inherit the rate limit of your tier. The Scout console for self-serve key creation is not public yet.

Rate limits

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.

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).