Create segment — LaunchDarkly

Create a new segment.

Path parameters

projectKeystringRequired

The project key

environmentKeystringRequired

The environment key

Request

This endpoint expects an object.

namestringRequired

A human-friendly name for the segment

keystringRequired

A unique key used to reference the segment

descriptionstringOptional

A description of the segment’s purpose

tagslist of stringsOptional

Tags for the segment

unboundedbooleanOptional

Whether to create a standard segment (false) or a big segment (true). Standard segments include rule-based and smaller list-based segments. Big segments include larger list-based segments and synced segments. Only use a big segment if you need to add more than 15,000 individual targets.

unboundedContextKindstringOptional

For big segments, the targeted context kind.

Response

Segment response

namestring

A human-friendly name for the segment.

tagslist of strings

Tags for the segment. Defaults to an empty array.

creationDatelong

Timestamp of when the segment was created

lastModifiedDatelong

Timestamp of when the segment was last modified

keystring

A unique key used to reference the segment

_linksmap from strings to objects

The location and content type of related resources

ruleslist of objects

An array of the targeting rules for this segment.

versioninteger

Version of the segment

deletedboolean

Whether the segment has been deleted

generationinteger

For big segments, how many times this segment has been created.

descriptionstringOptional

A description of the segment’s purpose. Defaults to null and is omitted in the response if not provided.

includedlist of stringsOptional

An array of keys for included targets. Included individual targets are always segment members, regardless of segment rules. For list-based segments over 15,000 entries, also called big segments, this array is either empty or omitted.

excludedlist of stringsOptional

An array of keys for excluded targets. Segment rules bypass individual excluded targets, so they will never be included based on rules. Excluded targets may still be included explicitly. This value is omitted for list-based segments over 15,000 entries, also called big segments.

includedContextslist of objectsOptional

excludedContextslist of objectsOptional

_accessobjectOptional

_flagslist of objectsOptional

A list of flags targeting this segment. Only included when getting a single segment, using the getSegment endpoint.

unboundedbooleanOptional

Whether this is a standard segment (false) or a big segment (true). Standard segments include rule-based segments and smaller list-based segments. Big segments include larger list-based segments and synced segments. If omitted, the segment is a standard segment.

unboundedContextKindstringOptional

For big segments, the targeted context kind.

_unboundedMetadataobjectOptional

Details on the external data store backing this segment. Only applies to big segments.

_externalstringOptional

The external data store backing this segment. Only applies to synced segments.

_externalLinkstringOptional

The URL for the external data store backing this segment. Only applies to synced segments.

_importInProgressbooleanOptional

Whether an import is currently in progress for the specified segment. Only applies to big segments.

Errors

1 curl -X POST https://app.launchdarkly.com/api/v2/segments/projectKey/environmentKey \ 2 -H "Authorization: <apiKey>" \ 3 -H "Content-Type: application/json" \ 4 -d '{ 5 "name": "Example segment", 6 "key": "segment-key-123abc" 7 }'

1 { 2 "name": "Example segment", 3 "tags": [ 4 "testing" 5 ], 6 "creationDate": 1000000, 7 "lastModifiedDate": 1000000, 8 "key": "segment-key-123abc", 9 "_links": { 10 "key": { 11 "href": "href", 12 "type": "type" 13 } 14 }, 15 "rules": [ 16 { 17 "clauses": [ 18 { 19 "attribute": "email", 20 "op": "endsWith", 21 "values": [ 22 ".edu" 23 ], 24 "negate": false, 25 "_id": "12ab3c45de678910fab12345" 26 } 27 ], 28 "_id": "1234a56b7c89d012345e678f", 29 "weight": 1, 30 "rolloutContextKind": "rolloutContextKind", 31 "bucketBy": "bucketBy", 32 "description": "description" 33 } 34 ], 35 "version": 1, 36 "deleted": false, 37 "generation": 1, 38 "description": "Bundle our sample customers together", 39 "included": [ 40 "user-key-123abc" 41 ], 42 "excluded": [ 43 "user-key-123abc" 44 ], 45 "includedContexts": [ 46 { 47 "values": [ 48 "values" 49 ], 50 "contextKind": "contextKind" 51 } 52 ], 53 "excludedContexts": [ 54 { 55 "values": [ 56 "values" 57 ], 58 "contextKind": "contextKind" 59 } 60 ], 61 "_access": { 62 "denied": [ 63 { 64 "action": "action", 65 "reason": { 66 "effect": "allow" 67 } 68 } 69 ], 70 "allowed": [ 71 { 72 "action": "action", 73 "reason": { 74 "effect": "allow" 75 } 76 } 77 ] 78 }, 79 "_flags": [ 80 { 81 "name": "Example flag", 82 "key": "flag-key-123abc", 83 "_links": { 84 "key": {} 85 } 86 } 87 ], 88 "unbounded": false, 89 "unboundedContextKind": "unboundedContextKind", 90 "_unboundedMetadata": { 91 "envId": "envId", 92 "segmentId": "segmentId", 93 "version": 1, 94 "includedCount": 1, 95 "excludedCount": 1, 96 "lastModified": 1000000, 97 "deleted": true 98 }, 99 "_external": "amplitude", 100 "_externalLink": "https://analytics.amplitude.com/org/1234/cohort/123abc", 101 "_importInProgress": false 102 }

1	curl -X POST https://app.launchdarkly.com/api/v2/segments/projectKey/environmentKey \
2	-H "Authorization: <apiKey>" \
3	-H "Content-Type: application/json" \
4	-d '{
5	"name": "Example segment",
6	"key": "segment-key-123abc"
7	}'

1	{
2	"name": "Example segment",
3	"tags": [
4	"testing"
5	],
6	"creationDate": 1000000,
7	"lastModifiedDate": 1000000,
8	"key": "segment-key-123abc",
9	"_links": {
10	"key": {
11	"href": "href",
12	"type": "type"
13	}
14	},
15	"rules": [
16	{
17	"clauses": [
18	{
19	"attribute": "email",
20	"op": "endsWith",
21	"values": [
22	".edu"
23	],
24	"negate": false,
25	"_id": "12ab3c45de678910fab12345"
26	}
27	],
28	"_id": "1234a56b7c89d012345e678f",
29	"weight": 1,
30	"rolloutContextKind": "rolloutContextKind",
31	"bucketBy": "bucketBy",
32	"description": "description"
33	}
34	],
35	"version": 1,
36	"deleted": false,
37	"generation": 1,
38	"description": "Bundle our sample customers together",
39	"included": [
40	"user-key-123abc"
41	],
42	"excluded": [
43	"user-key-123abc"
44	],
45	"includedContexts": [
46	{
47	"values": [
48	"values"
49	],
50	"contextKind": "contextKind"
51	}
52	],
53	"excludedContexts": [
54	{
55	"values": [
56	"values"
57	],
58	"contextKind": "contextKind"
59	}
60	],
61	"_access": {
62	"denied": [
63	{
64	"action": "action",
65	"reason": {
66	"effect": "allow"
67	}
68	}
69	],
70	"allowed": [
71	{
72	"action": "action",
73	"reason": {
74	"effect": "allow"
75	}
76	}
77	]
78	},
79	"_flags": [
80	{
81	"name": "Example flag",
82	"key": "flag-key-123abc",
83	"_links": {
84	"key": {}
85	}
86	}
87	],
88	"unbounded": false,
89	"unboundedContextKind": "unboundedContextKind",
90	"_unboundedMetadata": {
91	"envId": "envId",
92	"segmentId": "segmentId",
93	"version": 1,
94	"includedCount": 1,
95	"excludedCount": 1,
96	"lastModified": 1000000,
97	"deleted": true
98	},
99	"_external": "amplitude",
100	"_externalLink": "https://analytics.amplitude.com/org/1234/cohort/123abc",
101	"_importInProgress": false
102	}