LaunchDarkly REST API
  1. User segments
LaunchDarkly REST API
  • Relay proxy configurations
    • Returns a list of relay proxy configurations in the account.
      GET
    • Create a new relay proxy config.
      POST
    • Delete a relay proxy configuration by ID.
      DELETE
    • Get a single relay proxy configuration by ID.
      GET
    • Modify a relay proxy configuration by ID.
      PATCH
    • Reset a relay proxy configuration's secret key with an optional expiry time for the old key.
      POST
  • Audit log
    • Get a list of all audit log entries. The query parameters allow you to restrict the returned results by date ranges, resource specifiers, or a full-text search query.
      GET
    • Use this endpoint to fetch a single audit log entry by its resouce ID.
      GET
  • Data export destinations
    • Returns a list of all data export destinations.
      GET
    • Create a new data export destination
      POST
    • Get a single data export destination by ID
      DELETE
    • Get a single data export destination by ID
      GET
    • Perform a partial update to a data export destination.
      PATCH
  • Feature flags
    • Get the status for a particular feature flag across environments
      GET
    • Get a list of statuses for all feature flags. The status includes the last time the feature flag was requested, as well as the state of the flag.
      GET
    • Get the status for a particular feature flag.
      GET
    • Get a list of all features in the given project.
      GET
    • Creates a new feature flag.
      POST
    • Get dependent flags for the flag in the environment specified in path parameters
      GET
    • Delete a feature flag in all environments. Be careful-- only delete feature flags that are no longer being used by your application.
      DELETE
    • Get a single feature flag by key.
      GET
    • Perform a partial update to a feature.
      PATCH
    • Copies the feature flag configuration from one environment to the same feature flag in another environment.
      POST
    • Get dependent flags across all environments for the flag specified in the path parameters
      GET
    • Get expiring user targets for feature flag
      GET
    • Update, add, or delete expiring user targets on feature flag
      PATCH
    • Get all approval requests for a feature flag config
      GET
    • Delete an approval request for a feature flag config
      DELETE
    • Get a single approval request for a feature flag config
      GET
    • Create an approval request for a feature flag config
      POST
    • Apply approval request for a feature flag config
      POST
    • Review approval request for a feature flag config
      POST
    • Get all scheduled workflows for a feature flag by key.
      GET
    • Creates a new scheduled change for a feature flag.
      POST
    • Lists conflicts between the given instructions and any existing scheduled changes for the feature flag. The actual HTTP verb should be REPORT, not POST.
      POST
    • Delete a scheduled change on a feature flag in an environment.
      DELETE
    • Get a scheduled change on a feature flag by id.
      GET
    • Updates an existing scheduled-change on a feature flag in an environment.
      PATCH
  • Integrations
    • Get a list of all configured audit log event integrations associated with this account.
    • Get a list of all configured integrations of a given kind.
    • Create a new integration subscription of a given kind.
    • Delete an integration subscription by ID.
    • Get a single integration subscription by ID.
    • Modify an integration subscription by ID.
  • Team members
    • Returns a list of all members in the account.
    • Invite new members.
    • Get the current team member associated with the token
    • Delete a team member by ID.
    • Get a single team member by ID.
    • Modify a team member by ID.
  • Projects
    • Returns a list of all projects in the account.
    • Create a new project with the given key and name.
    • Delete a project by key. Caution-- deleting a project will delete all associated environments and feature flags. You cannot delete the last project in an account.
    • Fetch a single project by key.
    • Modify a project by ID.
  • Environments
    • Create a new environment in a specified project with a given name, key, and swatch color.
    • Delete an environment in a specific project.
    • Get an environment given a project and key.
    • Modify an environment by ID. If you try to patch the environment by setting both required and requiredApprovalTags, it will result in an error. Users can specify either required approvals for all flags in an environment or those with specific tags, but no
    • Reset an environment's SDK key with an optional expiry time for the old key.
    • Reset an environment's mobile key. The optional expiry for the old key is deprecated for this endpoint, so the old key will always expire immediately.
  • Custom roles
    • Return a complete list of custom roles.
    • Create a new custom role.
    • Delete a custom role by key.
    • Get one custom role by key.
    • Modify a custom role by key.
  • User segments
    • Get a list of all user segments in the given project.
      GET
    • Creates a new user segment.
      POST
    • Delete a user segment.
      DELETE
    • Get a single user segment by key.
      GET
    • Perform a partial update to a user segment.
      PATCH
    • Update targets included or excluded in a big segment
      POST
    • Get expiring user targets for user segment
      GET
    • Update, add, or delete expiring user targets on user segment
      PATCH
  • Access tokens
    • Returns a list of tokens in the account.
    • Create a new token.
    • Delete an access token by ID.
    • Get a single access token by ID.
    • Modify an access token by ID.
    • Reset an access token's secret key with an optional expiry time for the old key.
  • Customer Metrics
    • Returns of the usage endpoints available.
    • Get events usage by event id and the feature flag key.
    • Get events usage endpoints.
    • Get events usage by event type.
    • Get monthly active user data.
    • Get monthly active user data by category.
    • Returns a list of all streams.
    • Get a stream endpoint and return timeseries data.
    • Get a stream timeseries data by source show sdk version metadata.
    • Get a stream timeseries data by source and show all sdk version associated.
  • Users
    • Search users in LaunchDarkly based on their last active date, or a search query. It should not be used to enumerate all users in LaunchDarkly-- use the List users API resource.
    • List all users in the environment. Includes the total count of users. In each page, there will be up to 'limit' users returned (default 20). This is useful for exporting all users in the system for further analysis. Paginated collections will include a ne
    • Delete a user by ID.
    • Get a user by key.
  • User settings
    • Fetch a single flag setting for a user by key.
    • Fetch a single flag setting for a user by key.
    • Specifically enable or disable a feature flag for a user based on their key.
    • Get expiring dates on flags for user
    • Update, add, or delete expiring user targets for a single user on all flags
  • Webhooks
    • Fetch a list of all webhooks.
    • Create a webhook.
    • Delete a webhook by ID.
    • Get a webhook by ID.
    • Modify a webhook by ID.
  • /
    GET
  1. User segments

Creates a new user segment.

POST
/segments/{projectKey}/{environmentKey}
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://app.launchdarkly.com/api/v2/segments//' \
--header 'Content-Type: application/json' \
--data-raw '{
    "description": "Users in this segment will have access to beta features.",
    "key": "new-segment",
    "name": "new segment",
    "tags": [
        []
    ],
    "unbounded": false
}'
Response Response Example
201 - Example 1
{
    "_flags": [
        {
            "_links": {
                "next": {
                    "href": "/api/v2/endpoint",
                    "type": "application/json"
                },
                "self": {
                    "href": "/api/v2/endpoint",
                    "type": "application/json"
                }
            },
            "_site": {
                "href": "/features/sort.order",
                "type": "text/html"
            },
            "key": "string",
            "name": "string"
        }
    ],
    "_links": {
        "next": {
            "href": "/api/v2/endpoint",
            "type": "application/json"
        },
        "self": {
            "href": "/api/v2/endpoint",
            "type": "application/json"
        }
    },
    "creationDate": 1443652232590,
    "description": "Users in this segment can access beta features.",
    "excluded": [
        "string"
    ],
    "included": [
        "string"
    ],
    "key": "beta-testers",
    "name": "Beta Testers",
    "rules": [
        {
            "bucketBy": "string",
            "clauses": [
                {
                    "_id": "string",
                    "attribute": "groups",
                    "negate": true,
                    "op": "in",
                    "values": [
                        "Top Customers"
                    ]
                }
            ],
            "weight": 0
        }
    ],
    "tags": [
        "dev",
        "ops"
    ],
    "unbounded": false,
    "version": 0
}

Request

Path Params

Body Params application/json

Examples

Responses

🟢201OK
application/json
Body

🟠400400
🟠401401
🟠409409
Modified at 2022-09-11 22:47:17
Previous
Get a list of all user segments in the given project.
Next
Delete a user segment.
Built with