List flag settings for user

Deprecated

GET

/api/v2/users/:projectKey/:environmentKey/:userKey/flags

Get the current flag settings for a given user.

The _value is the flag variation that the user receives. The setting indicates whether you’ve explicitly targeted a user to receive a particular variation. For example, if you have turned off a feature flag for a user, this setting will be false. The example response indicates that the user Abbie_Braun has the sort.order flag enabled and the alternate.page flag disabled, and that the user has not been explicitly targeted to receive a particular variation.

Path parameters

projectKeystringRequired

The project key

environmentKeystringRequired

The environment key

userKeystringRequired

The user key

Response

User flag settings collection response

itemsmap from strings to objects

An array of flag settings for the user

_linksmap from strings to objects

The location and content type of related resources

Errors

GET

1 curl https://app.launchdarkly.com/api/v2/users/projectKey/environmentKey/userKey/flags \
2      -H "Authorization: <apiKey>"

200Retrieved

1 {
2   "items": {
3     "alternate.page": {
4       "_links": {
5         "self": {
6           "href": "/api/v2/users/lacuna/production/Abbie_Braun/flags/alternate.page",
7           "type": "application/json"
8         }
9       },
10       "_value": false,
11       "setting": {
12         "key": "value"
13       },
14       "reason": {
15         "kind": "OFF",
16         "ruleIndex": 3,
17         "ruleID": "1234567890",
18         "prerequisiteKey": "someotherflagkey",
19         "inExperiment": true,
20         "errorKind": "USER_NOT_SPECIFIED"
21       }
22     },
23     "sort.order": {
24       "_links": {
25         "self": {
26           "href": "/api/v2/users/lacuna/production/Abbie_Braun/flags/sort.order",
27           "type": "application/json"
28         }
29       },
30       "_value": true,
31       "setting": {
32         "key": "value"
33       },
34       "reason": {
35         "kind": "OFF",
36         "ruleIndex": 3,
37         "ruleID": "1234567890",
38         "prerequisiteKey": "someotherflagkey",
39         "inExperiment": true,
40         "errorKind": "USER_NOT_SPECIFIED"
41       }
42     }
43   },
44   "_links": {
45     "self": {
46       "href": "/api/v2/users/lacuna/production/Abbie_Braun/flags",
47       "type": "application/json"
48     }
49   }
50 }

Update expiring user target for flags

Up Next

Built with

1	curl https://app.launchdarkly.com/api/v2/users/projectKey/environmentKey/userKey/flags \
2	-H "Authorization: <apiKey>"

1	{
2	"items": {
3	"alternate.page": {
4	"_links": {
5	"self": {
6	"href": "/api/v2/users/lacuna/production/Abbie_Braun/flags/alternate.page",
7	"type": "application/json"
8	}
9	},
10	"_value": false,
11	"setting": {
12	"key": "value"
13	},
14	"reason": {
15	"kind": "OFF",
16	"ruleIndex": 3,
17	"ruleID": "1234567890",
18	"prerequisiteKey": "someotherflagkey",
19	"inExperiment": true,
20	"errorKind": "USER_NOT_SPECIFIED"
21	}
22	},
23	"sort.order": {
24	"_links": {
25	"self": {
26	"href": "/api/v2/users/lacuna/production/Abbie_Braun/flags/sort.order",
27	"type": "application/json"
28	}
29	},
30	"_value": true,
31	"setting": {
32	"key": "value"
33	},
34	"reason": {
35	"kind": "OFF",
36	"ruleIndex": 3,
37	"ruleID": "1234567890",
38	"prerequisiteKey": "someotherflagkey",
39	"inExperiment": true,
40	"errorKind": "USER_NOT_SPECIFIED"
41	}
42	}
43	},
44	"_links": {
45	"self": {
46	"href": "/api/v2/users/lacuna/production/Abbie_Braun/flags",
47	"type": "application/json"
48	}
49	}
50	}