Create segment (API Explorer) | LaunchDarkly

Access tokens
- POSTCreate access token
- DELDelete access token
- GETGet access token
- GETList access tokens
- PATCHPatch access token
- POSTReset access token
Account members
- POSTAdd a member to teams
- DELDelete account member
- GETGet account member
- POSTInvite new members
- GETList account members
- PATCHModify an account member
Account members (beta)
- PATCHModify account members
Account usage (beta)
- GETGet data export events usage
- GETGet evaluations usage
- GETGet events usage
- GETGet experimentation keys usage
- GETGet experimentation units usage
- GETGet MAU SDKs by type
- GETGet MAU usage
- GETGet MAU usage by category
- GETGet service connection usage
- GETGet stream usage
- GETGet stream usage by SDK version
- GETGet stream usage SDK versions
AI Configs (beta)
- POSTCreate AI Config variation
- POSTCreate an AI model config
- POSTCreate new AI Config
- DELDelete AI Config
- DELDelete AI Config variation
- DELDelete an AI model config
- GETGet AI Config
- GETGet AI Config metrics
- GETGet AI Config metrics by variation
- GETGet AI Config variation
- GETGet AI model config
- GETList AI Configs
- GETList AI model configs
- PATCHUpdate AI Config
- PATCHUpdate AI Config variation
Announcements
- POSTCreate an announcement
- DELDelete an announcement
- GETGet announcements
- PATCHUpdate an announcement
Applications (beta)
- DELDelete application
- DELDelete application version
- GETGet application by key
- GETGet application versions by application key
- GETGet applications
- PATCHUpdate application
- PATCHUpdate application version
Approvals
- POSTApply approval request
- POSTApply approval request for a flag
- POSTCreate approval request
- POSTCreate approval request for a flag
- POSTCreate approval request to copy flag configurations across environments
- DELDelete approval request
- DELDelete approval request for a flag
- GETGet approval request
- GETGet approval request for a flag
- GETList approval requests
- GETList approval requests for a flag
- POSTReview approval request
- POSTReview approval request for a flag
Approvals (beta)
- PATCHUpdate approval request
- PATCHUpdate flag approval request
Audit log
- GETGet audit log entry
- GETList audit log entries
- POSTSearch audit log entries
Code references
- POSTCreate extinction
- POSTCreate repository
- POSTDelete branches
- DELDelete repository
- GETGet branch
- GETGet code references statistics for flags
- GETGet links to code reference repositories for each project
- GETGet repository
- GETList branches
- GETList extinctions
- GETList repositories
- PATCHUpdate repository
- PUTUpsert branch
Contexts
- PUTCreate or update context kind
- DELDelete context instances
- POSTEvaluate flags for context instance
- GETGet context attribute names
- GETGet context attribute values
- GETGet context instances
- GETGet context kinds
- GETGet contexts
- POSTSearch for context instances
- POSTSearch for contexts
Context settings
- PUTUpdate flag settings for context
Custom roles
- POSTCreate custom role
- DELDelete custom role
- GETGet custom role
- GETList custom roles
- PATCHUpdate custom role
Data Export destinations
- POSTCreate Data Export destination
- DELDelete Data Export destination
- POSTGenerate Snowflake destination key pair
- GETGet destination
- GETList destinations
- PATCHUpdate Data Export destination
Environments
- POSTCreate environment
- DELDelete environment
- GETGet environment
- GETList environments
- POSTReset environment mobile SDK key
- POSTReset environment SDK key
- PATCHUpdate environment
Experiments
- POSTCreate experiment
- POSTCreate iteration
- GETGet experiment
- GETGet experiment results (Deprecated)
- GETGet experiment results for metric group (Deprecated)
- GETGet experimentation settings
- GETGet experiments
- PATCHPatch experiment
- PUTUpdate experimentation settings
Feature flags
- POSTCopy feature flag
- POSTCreate a feature flag
- DELDelete feature flag
- GETGet expiring context targets for feature flag
- GETGet expiring user targets for feature flag
- GETGet feature flag
- GETGet feature flag status
- GETGet flag status across environments
- POSTGet migration safety issues
- GETList feature flag statuses
- GETList feature flags
- PATCHUpdate expiring context targets on feature flag
- PATCHUpdate expiring user targets on feature flag
- PATCHUpdate feature flag
Feature flags (beta)
- GETList dependent feature flags
- GETList dependent feature flags by environment
Flag import configurations (beta)
- POSTCreate a flag import configuration
- DELDelete a flag import configuration
- GETGet a single flag import configuration
- GETList all flag import configurations
- POSTTrigger a single flag import run
- PATCHUpdate a flag import configuration
Flag links (beta)
- POSTCreate flag link
- DELDelete flag link
- GETList flag links
- PATCHUpdate flag link
Flag triggers
- POSTCreate flag trigger
- DELDelete flag trigger
- GETGet flag trigger by ID
- GETList flag triggers
- PATCHUpdate flag trigger
Follow flags
- PUTAdd a member as a follower of a flag in a project and environment
- GETGet followers of a flag in a project and environment
- GETGet followers of all flags in a given project and environment
- DELRemove a member as a follower of a flag in a project and environment
Holdouts (beta)
- POSTCreate holdout
- GETGet all holdouts
- GETGet holdout
- GETGet Holdout by Id
- PATCHPatch holdout
Insights charts (beta)
- GETGet deployment frequency chart data
- GETGet flag status chart data
- GETGet lead time chart data
- GETGet release frequency chart data
- GETGet stale flags chart data
Insights deployments (beta)
- POSTCreate deployment event
- GETGet deployment
- GETList deployments
- PATCHUpdate deployment
Insights flag events (beta)
- GETList flag events
Insights pull requests (beta)
- GETList pull requests
Insights repositories (beta)
- PUTAssociate repositories with projects
- GETList repositories
- DELRemove repository project association
Insights scores (beta)
- POSTCreate insight group
- DELDelete insight group
- GETGet insight group
- GETGet insight scores
- GETList insight groups
- PATCHPatch insight group
Integration audit log subscriptions
- POSTCreate audit log subscription
- DELDelete audit log subscription
- GETGet audit log subscription by ID
- GETGet audit log subscriptions by integration
- PATCHUpdate audit log subscription
Integration delivery configurations (beta)
- POSTCreate delivery configuration
- DELDelete delivery configuration
- GETGet delivery configuration by ID
- GETGet delivery configurations by environment
- GETList all delivery configurations
- PATCHUpdate delivery configuration
- POSTValidate delivery configuration
Integrations (beta)
- POSTCreate integration configuration
- DELDelete integration configuration
- GETGet all configurations for the integration
- GETGet an integration configuration
- PATCHUpdate integration configuration
Layers
- POSTCreate layer
- GETGet layers
- PATCHUpdate layer
Metrics
- POSTCreate metric
- DELDelete metric
- GETGet metric
- GETList metrics
- PATCHUpdate metric
Metrics (beta)
- POSTCreate metric group
- DELDelete metric group
- GETGet metric group
- GETList metric groups
- PATCHPatch metric group
OAuth2 Clients
- POSTCreate a LaunchDarkly OAuth 2.0 client
- DELDelete OAuth 2.0 client
- GETGet client by ID
- GETGet clients
- PATCHPatch client by ID
Persistent store integrations (beta)
- POSTCreate big segment store integration
- DELDelete big segment store integration
- GETGet big segment store integration by ID
- GETList all big segment store integrations
- PATCHUpdate big segment store integration
Projects
- PUTCreate or update flag defaults for project
- POSTCreate project
- DELDelete project
- GETGet flag defaults for project
- GETGet project
- GETList projects
- PATCHUpdate flag default for project
- PATCHUpdate project
Relay Proxy configurations
- POSTCreate a new Relay Proxy config
- DELDelete Relay Proxy config by ID
- GETGet Relay Proxy config
- GETList Relay Proxy configs
- POSTReset Relay Proxy configuration key
- PATCHUpdate a Relay Proxy config
Release pipelines (beta)
- POSTCreate a release pipeline
- DELDelete release pipeline
- GETGet all release pipelines
- GETGet release pipeline by key
- GETGet release progressions for release pipeline
- PUTUpdate a release pipeline
Releases (beta)
- PUTCreate a new release for flag
- DELDelete a release for flag
- GETGet release for flag
- PATCHPatch release for flag
- PUTUpdate phase status for release
Scheduled changes
- POSTCreate scheduled changes workflow
- DELDelete scheduled changes workflow
- GETGet a scheduled change
- GETList scheduled changes
- PATCHUpdate scheduled changes workflow
Segments
- POSTCreate big segment export
- POSTCreate big segment import
- POSTCreate segment
- DELDelete segment
- GETGet big segment export
- GETGet big segment import
- GETGet big segment membership for context
- GETGet big segment membership for user
- GETGet expiring targets for segment
- GETGet expiring user targets for segment
- GETGet segment
- POSTList segment memberships for context instance
- GETList segments
- PATCHPatch segment
- POSTUpdate context targets on a big segment
- PATCHUpdate expiring targets for segment
- PATCHUpdate expiring user targets for segment
- POSTUpdate user context targets on a big segment
Tags
- GETList tags
Teams
- POSTAdd multiple members to team
- POSTCreate team
- DELDelete team
- GETGet team
- GETGet team custom roles
- GETGet team maintainers
- GETList teams
- PATCHUpdate team
Teams (beta)
- PATCHUpdate teams
Users
- DELDelete user
- GETFind users
- GETGet user
- GETList users
Users (beta)
- GETGet user attribute names
User settings
- GETGet expiring dates on flags for user
- GETGet flag setting for user
- GETList flag settings for user
- PATCHUpdate expiring user target for flags
- PUTUpdate flag settings for user
Webhooks
- POSTCreates a webhook
- DELDelete webhook
- GETGet webhook
- GETList webhooks
- PATCHUpdate webhook
Workflows
- POSTCreate workflow
- DELDelete workflow
- GETGet custom workflow
- GETGet workflows
Workflow templates
- POSTCreate workflow template
- DELDelete workflow template
- GETGet workflow templates
Other
- GETGet version information
- GETGets the OpenAPI spec in json
- GETGets the public IP list
- GETIdentify the caller
- GETRoot resource

Built with

POST/api/v2/segments/projectKey/environmentKey

Path Parameters

projectKeystringRequired
environmentKeystringRequired

Body Parameters

namestringRequired
keystringRequired

View in API Reference

Request

$ curl -X POST https://app.launchdarkly.com/api/v2/segments/projectKey/environmentKey \
>      -H "Authorization: " \
>      -H "Content-Type: application/json" \
>      -d '{
>   "name": "Example segment",
>   "key": "segment-key-123abc"
> }'

Response

$	curl -X POST https://app.launchdarkly.com/api/v2/segments/projectKey/environmentKey \
>	-H "Authorization: " \
>	-H "Content-Type: application/json" \
>	-d '{
>	"name": "Example segment",
>	"key": "segment-key-123abc"
>	}'