FlagdeckFlagdeck
Pricing
Docs
Get Started

Documentation

Authentication

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

Organization API keys

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-key header. See the SDK docs.

Scopes

Every key is granted a set of scopes, and each endpoint requires one. A request whose key lacks the required scope returns 403.

ScopeGrants
org:read / org:writeRead or update the organization
projects:read / projects:writeRead or manage projects
flags:read / flags:writeRead or manage flags
environments:read / environments:writeRead or manage environments
webhooks:read / webhooks:writeRead or manage webhooks
members:read / members:writeRead or manage team members
api-keys:read / api-keys:writeRead or manage API keys
audit:readRead the audit log
billing:read / billing:writeRead or manage billing

Pagination

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"

Errors

StatusMeaning
401Missing or invalid API key
403The key lacks the required scope
404The resource does not exist in your organization
429Rate limit exceeded