Documentation
The Flagdeck management API lets you manage your organization, projects, flags, environments, webhooks, team members and billing programmatically. It is the same API the dashboard uses.
Base URL:
code
https://api.flagdeck.com
Management requests authenticate with an organization API key, created in your dashboard under Settings → API. Pass it as a bearer token:
bash
curl https://api.flagdeck.com/v1/projects \
-H "Authorization: Bearer YOUR_API_KEY"
Keys are prefixed with fdk_ and are shown only once at creation. Store them
securely and never expose them in client-side code.
Evaluating flags in your application uses a different credential: a project/environment SDK key passed as the
x-api-keyheader. See the SDK docs.
Every key is granted a set of scopes, and each endpoint requires one. A request
whose key lacks the required scope returns 403.
| Scope | Grants |
|---|---|
org:read / org:write | Read or update the organization |
projects:read / projects:write | Read or manage projects |
flags:read / flags:write | Read or manage flags |
environments:read / environments:write | Read or manage environments |
webhooks:read / webhooks:write | Read or manage webhooks |
members:read / members:write | Read or manage team members |
api-keys:read / api-keys:write | Read or manage API keys |
audit:read | Read the audit log |
billing:read / billing:write | Read or manage billing |
List endpoints accept page (default 1), limit (default 20, max 100) and
search query parameters.
bash
curl "https://api.flagdeck.com/v1/projects/PROJECT_ID/flags?page=2&limit=50&search=checkout" \
-H "Authorization: Bearer YOUR_API_KEY"
| Status | Meaning |
|---|---|
401 | Missing or invalid API key |
403 | The key lacks the required scope |
404 | The resource does not exist in your organization |
429 | Rate limit exceeded |