// api reference

Build on the
FlagDrop API.

RESTful API for managing projects, flags, environments, segments, and config push. All endpoints return JSON.

// authenticationauth.methods()

Two auth methods.

Clerk JWT

For dashboard and browser-based clients. Include the JWT in the Authorization header.

Authorization: Bearer <clerk_jwt>

API Key

For server-to-server and CI/CD. Scoped per project with configurable permissions.

X-API-Key: fdrop_sk_...

PROJECTS

GET/api/v1/projectsList all projects

POST/api/v1/projectsCreate a project

GET/api/v1/projects/:idGet project details

PATCH/api/v1/projects/:idUpdate a project

DELETE/api/v1/projects/:idDelete a project

FLAGS

GET/api/v1/projects/:id/flagsList flags in a project

POST/api/v1/projects/:id/flagsCreate a flag

GET/api/v1/flags/:idGet flag details

PATCH/api/v1/flags/:idUpdate a flag

DELETE/api/v1/flags/:idDelete a flag

POST/api/v1/flags/:id/toggleToggle flag state

ENVIRONMENTS

GET/api/v1/projects/:id/environmentsList environments

POST/api/v1/projects/:id/environmentsCreate an environment

PATCH/api/v1/environments/:idUpdate an environment

DELETE/api/v1/environments/:idDelete an environment

SEGMENTS

GET/api/v1/projects/:id/segmentsList segments

POST/api/v1/projects/:id/segmentsCreate a segment

PATCH/api/v1/segments/:idUpdate a segment

DELETE/api/v1/segments/:idDelete a segment

CONFIG PUSH

POST/api/v1/environments/:id/pushPush config to cloud storage

GET/api/v1/environments/:id/push/statusGet last push status