Use LaunchDarkly to list, create, update, toggle, and delete feature flags, and inspect their environment-specific status. Toggling uses LaunchDarkly's semantic patch API.
Read projects, environments, segments, members, and audit logs to find targeting context or review changes. For example, toggle a flag after a deployment, then inspect its status and the resulting audit entry.
Create a personal access token or service token under Organization settings > Authorization > Tokens in LaunchDarkly. Sim sends it directly in the Authorization header, without a Bearer prefix. Grant only the access the workflow needs. Service tokens are available on selected plans ; SDK keys cannot authenticate REST API requests.
List, create, update, toggle, and delete feature flags. Read projects, environments, segments, members, and audit logs. Requires an API key.
Create a new feature flag in a LaunchDarkly project.
Parameter Type Required Description apiKeystring Yes LaunchDarkly API key projectKeystring Yes The project key to create the flag in namestring Yes Human-readable name for the feature flag keystring Yes Unique key for the feature flag (used in code) descriptionstring No Description of the feature flag tagsstring No Comma-separated list of tags temporaryboolean No Whether the flag is temporary (default true)
Parameter Type Description keystring The unique key of the feature flag namestring The human-readable name of the feature flag kindstring The type of flag (boolean or multivariate) descriptionstring Description of the feature flag temporaryboolean Whether the flag is temporary archivedboolean Whether the flag is archived deprecatedboolean Whether the flag is deprecated creationDatenumber Unix timestamp in milliseconds when the flag was created tagsarray Tags applied to the flag variationsarray The variations for this feature flag ↳ value string The variation value (any JSON type, shown as text) ↳ name string The variation name ↳ description string The variation description maintainerIdstring The ID of the member who maintains this flag maintainerEmailstring The email of the member who maintains this flag
Delete a feature flag from a LaunchDarkly project.
Parameter Type Required Description apiKeystring Yes LaunchDarkly API key projectKeystring Yes The project key flagKeystring Yes The feature flag key to delete
Parameter Type Description deletedboolean Whether the flag was successfully deleted
List audit log entries from your LaunchDarkly account.
Parameter Type Required Description apiKeystring Yes LaunchDarkly API key limitnumber No Maximum number of entries to return (default 10, max 20) specstring No Resource specifier filter (e.g. "proj/:env/ :flag/*" for all flag changes, or "proj/default:env/production:flag/my-flag" for one flag in one environment)
Parameter Type Description entriesarray List of audit log entries ↳ id string The audit log entry ID ↳ date number Unix timestamp in milliseconds ↳ kind string The type of action performed ↳ name string The name of the resource acted on ↳ description string Full description of the action ↳ shortDescription string Short description of the action ↳ memberEmail string Email of the member who performed the action ↳ targetName string Name of the target resource ↳ targetKind string Resource specifier of the target (e.g. proj/default:env/production:flag/my-flag) totalCountnumber Total number of audit log entries
Get a single feature flag by key from a LaunchDarkly project.
Parameter Type Required Description apiKeystring Yes LaunchDarkly API key projectKeystring Yes The project key flagKeystring Yes The feature flag key environmentKeystring No Filter flag configuration to a specific environment
Parameter Type Description keystring The unique key of the feature flag namestring The human-readable name of the feature flag kindstring The type of flag (boolean or multivariate) descriptionstring Description of the feature flag temporaryboolean Whether the flag is temporary archivedboolean Whether the flag is archived deprecatedboolean Whether the flag is deprecated creationDatenumber Unix timestamp in milliseconds when the flag was created tagsarray Tags applied to the flag variationsarray The variations for this feature flag ↳ value string The variation value (any JSON type, shown as text) ↳ name string The variation name ↳ description string The variation description maintainerIdstring The ID of the member who maintains this flag maintainerEmailstring The email of the member who maintains this flag onboolean Whether the flag is on in the requested environment (null when the flag spans multiple environments and no environment key was provided)
Get the status of a feature flag across environments (active, inactive, launched, etc.).
Parameter Type Required Description apiKeystring Yes LaunchDarkly API key projectKeystring Yes The project key flagKeystring Yes The feature flag key environmentKeystring Yes The environment key
Parameter Type Description namestring The flag status (new, active, inactive, launched) lastRequestedstring Timestamp of the last evaluation defaultValstring The default variation value
List environments in a LaunchDarkly project.
Parameter Type Required Description apiKeystring Yes LaunchDarkly API key projectKeystring Yes The project key to list environments for limitnumber No Maximum number of environments to return (default 20)
Parameter Type Description environmentsarray List of environments ↳ id string The environment ID ↳ key string The unique environment key ↳ name string The environment name ↳ color string The color assigned to this environment ↳ apiKey string The server-side SDK key for this environment ↳ mobileKey string The mobile SDK key for this environment ↳ tags array Tags applied to the environment totalCountnumber Total number of environments
List feature flags in a LaunchDarkly project.
Parameter Type Required Description apiKeystring Yes LaunchDarkly API key projectKeystring Yes The project key to list flags for environmentKeystring No Filter flag configurations to a specific environment tagstring No Filter flags by tag name limitnumber No Maximum number of flags to return (default 20)
Parameter Type Description flagsarray List of feature flags ↳ key string The unique key of the feature flag ↳ name string The human-readable name of the feature flag ↳ kind string The type of flag (boolean or multivariate) ↳ description string Description of the feature flag ↳ temporary boolean Whether the flag is temporary ↳ archived boolean Whether the flag is archived ↳ deprecated boolean Whether the flag is deprecated ↳ creationDate number Unix timestamp in milliseconds when the flag was created ↳ tags array Tags applied to the flag ↳ variations array The variations for this feature flag ↳ value string The variation value (any JSON type, shown as text) ↳ name string The variation name ↳ description string The variation description ↳ maintainerId string The ID of the member who maintains this flag ↳ maintainerEmail string The email of the member who maintains this flag totalCountnumber Total number of flags
List account members in your LaunchDarkly organization.
Parameter Type Required Description apiKeystring Yes LaunchDarkly API key limitnumber No Maximum number of members to return (default 20)
Parameter Type Description membersarray List of account members ↳ id string The member ID ↳ email string The member email address ↳ firstName string The member first name ↳ lastName string The member last name ↳ role string The member role (reader, writer, admin, owner) ↳ lastSeen number Unix timestamp of last activity ↳ creationDate number Unix timestamp when the member was created ↳ verified boolean Whether the member email is verified totalCountnumber Total number of members
List all projects in your LaunchDarkly account.
Parameter Type Required Description apiKeystring Yes LaunchDarkly API key limitnumber No Maximum number of projects to return (default 20)
Parameter Type Description projectsarray List of projects ↳ id string The project ID ↳ key string The unique project key ↳ name string The project name ↳ tags array Tags applied to the project totalCountnumber Total number of projects
List user segments in a LaunchDarkly project and environment.
Parameter Type Required Description apiKeystring Yes LaunchDarkly API key projectKeystring Yes The project key environmentKeystring Yes The environment key limitnumber No Maximum number of segments to return (default 20)
Parameter Type Description segmentsarray List of user segments ↳ key string The unique segment key ↳ name string The segment name ↳ description string The segment description ↳ tags array Tags applied to the segment ↳ creationDate number Unix timestamp in milliseconds when the segment was created ↳ unbounded boolean Whether this is an unbounded (big) segment ↳ included array User keys explicitly included in the segment ↳ excluded array User keys explicitly excluded from the segment totalCountnumber Total number of segments
Toggle a feature flag on or off in a specific LaunchDarkly environment.
Parameter Type Required Description apiKeystring Yes LaunchDarkly API key projectKeystring Yes The project key flagKeystring Yes The feature flag key to toggle environmentKeystring Yes The environment key to toggle the flag in enabledboolean Yes Whether to turn the flag on (true) or off (false)
Parameter Type Description keystring The unique key of the feature flag namestring The human-readable name of the feature flag kindstring The type of flag (boolean or multivariate) descriptionstring Description of the feature flag temporaryboolean Whether the flag is temporary archivedboolean Whether the flag is archived deprecatedboolean Whether the flag is deprecated creationDatenumber Unix timestamp in milliseconds when the flag was created tagsarray Tags applied to the flag variationsarray The variations for this feature flag ↳ value string The variation value (any JSON type, shown as text) ↳ name string The variation name ↳ description string The variation description maintainerIdstring The ID of the member who maintains this flag maintainerEmailstring The email of the member who maintains this flag onboolean Whether the flag is now on in the target environment
Update feature flag metadata (name, description, tags, temporary, archived) using semantic patch.
Parameter Type Required Description apiKeystring Yes LaunchDarkly API key projectKeystring Yes The project key flagKeystring Yes The feature flag key to update updateNamestring No New name for the flag updateDescriptionstring No New description for the flag addTagsstring No Comma-separated tags to add removeTagsstring No Comma-separated tags to remove archiveboolean No Set to true to archive, false to restore commentstring No Optional comment explaining the update
Parameter Type Description keystring The unique key of the feature flag namestring The human-readable name of the feature flag kindstring The type of flag (boolean or multivariate) descriptionstring Description of the feature flag temporaryboolean Whether the flag is temporary archivedboolean Whether the flag is archived deprecatedboolean Whether the flag is deprecated creationDatenumber Unix timestamp in milliseconds when the flag was created tagsarray Tags applied to the flag variationsarray The variations for this feature flag ↳ value string The variation value (any JSON type, shown as text) ↳ name string The variation name ↳ description string The variation description maintainerIdstring The ID of the member who maintains this flag maintainerEmailstring The email of the member who maintains this flag