Documentation
Flags live under a project. All endpoints require flags:read or flags:write.
GET /v1/projects/{projectId}/flags (scope: flags:read)
Supports page, limit and search.
GET /v1/projects/{projectId}/flags/{key} (scope: flags:read)
POST /v1/projects/{projectId}/flags (scope: flags:write)
| Field | Type | Required | Default |
|---|---|---|---|
key | string, lowercase dot/hyphen segments (checkout.new-banner) | yes | |
name | string | yes | |
description | string | no | |
valueType | boolean | string | number | json | no | boolean |
defaultValue | matches valueType | no | |
status | active | inactive | no | active |
bash
curl -X POST https://api.flagdeck.com/v1/projects/PROJECT_ID/flags \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "key": "checkout.new-banner", "name": "New checkout banner" }'
New flags are created disabled in every environment.
PATCH /v1/projects/{projectId}/flags/{key} (scope: flags:write)
POST /v1/projects/{projectId}/flags/{key}/toggle (scope: flags:write)
POST /v1/projects/{projectId}/flags/{key}/archive (scope: flags:write)
POST /v1/projects/{projectId}/flags/{key}/duplicate (scope: flags:write)
DELETE /v1/projects/{projectId}/flags/{key} (scope: flags:write)