Skip to main content
CodivDocs

Authentication

Authenticate with the CodivDocs API.

The CodivDocs API uses API keys for authentication. Include your key in the Authorization header.

Getting an API key

  1. Go to Settings → API Keys in the dashboard

  2. Click Create API Key

  3. Copy the key — it's only shown once

Making requests

curl https://api.codivdocs.com/v1/projects \
  -H "Authorization: Bearer sk_live_..."

API key scopes

ScopeDescription
projects:readList and get projects
projects:writeCreate, update, delete projects
pages:readList and get pages
pages:writeCreate, update, delete pages
deployments:readList deployments
deployments:triggerTrigger manual deployments

Rate limits

  • Free plan — 60 requests/minute

  • Pro plan — 600 requests/minute

  • Business plan — 6000 requests/minute

Rate limit headers are included in every response:

X-RateLimit-Limit: 600
X-RateLimit-Remaining: 599
X-RateLimit-Reset: 1680000000

Last updated April 12, 2026