Authentication

How to authenticate with the DevNest API.

Authentication

All DevNest API requests require a valid API key passed as a Bearer token.

Getting an API key

API keys are available to clients on active retainer contracts. To generate a key:

  1. Log in to your client portal
  2. Navigate to Settings → API Keys
  3. Click Generate New Key
  4. Copy the key immediately. It won't be shown again

Using your API key

Pass the key in the Authorization header of every request:

curl https://api.devnest.tech/v1/projects \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Key scopes

Keys can be scoped to limit access:

ScopeDescription
read:projectsList and view projects
read:invoicesView invoices and billing
read:deliverablesAccess deliverable downloads
write:feedbackSubmit feedback on deliverables

Revoking keys

You can revoke a key at any time from the API Keys settings page. Revoked keys return 401 Unauthorized immediately.