Skip to main content

​
API keys

Civic AI API keys are scoped to your organization, not to an individual user. Any request made with a key acts on your org’s data (pipelines, pursuits) with the identity of the admin who created the key.

​
Creating a key

  1. Sign in to civiccontracts.com as an org admin.
  2. Go to Settings → Organization and open the API keys tab.
  3. Click Create API key, give it a name (e.g. “Zapier integration”), and copy the key.
The full key (civic_…) is shown exactly once at creation. Store it in a secrets manager — only the short prefix is visible afterwards.

​
Using a key

Pass the key on every request, either as a Bearer token:
or via the X-API-Key header:

​
Revoking a key

Admins can revoke a key from the same API keys tab. Revocation is immediate and permanent — requests with a revoked key return 401.

​
Errors

​
Rate limits

Requests are limited per key (currently 120 requests/minute). Standard RateLimit-* headers are included on every response. Contact info@civiccontracts.com for higher throughput.