Get application by key

Beta

GET

/api/v2/applications/:applicationKey

Retrieve an application by the application key.

Expanding the application response

LaunchDarkly supports expanding the “Get application” response to include additional fields.

To expand the response, append the expand query parameter and include the following:

flags includes details on the flags that have been evaluated by the application

For example, use ?expand=flags to include the flags field in the response. By default, this field is not included in the response.

Path parameters

applicationKeystringRequired

The application key

Query parameters

expandstringOptional

A comma-separated list of properties that can reveal additional information in the response. Options: flags.

Response

Application response

autoAddedboolean

Whether the application was automatically created because it was included in a context when a LaunchDarkly SDK evaluated a feature flag, or was created through the LaunchDarkly UI or REST API.

keystring

The unique identifier of this application

kindenum

Allowed values: browsermobileserver

To distinguish the kind of application

namestring

The name of the application

flagsobjectOptional

Details about the flags that have been evaluated by the application

_accessobjectOptional

Details on the allowed and denied actions for this application

_linksmap from strings to objectsOptional

The location and content type of related resources

_versionintegerOptional

Version of the application

creationDatelongOptional

Timestamp of when the application version was created

descriptionstringOptional

The application description

_maintainerobjectOptional

Associated maintainer member or team info for the application

Errors

GET

1 curl https://app.launchdarkly.com/api/v2/applications/applicationKey \
2      -H "Authorization: <apiKey>"

200Retrieved

1 {
2   "autoAdded": true,
3   "key": "com.launchdarkly.cafe",
4   "kind": "browser",
5   "name": "LaunchDarklyCafe",
6   "flags": {
7     "items": [
8       {
9         "name": "Example flag",
10         "key": "flag-key-123abc"
11       }
12     ],
13     "totalCount": 1,
14     "_links": {
15       "key": {}
16     }
17   },
18   "_access": {
19     "denied": [
20       {
21         "action": "action",
22         "reason": {
23           "effect": "allow"
24         }
25       }
26     ],
27     "allowed": [
28       {
29         "action": "action",
30         "reason": {
31           "effect": "allow"
32         }
33       }
34     ]
35   },
36   "_links": {
37     "key": {
38       "href": "href",
39       "type": "type"
40     }
41   },
42   "_version": 1,
43   "creationDate": 1000000,
44   "description": "The LaunchDarkly Cafe app",
45   "_maintainer": {
46     "member": {
47       "_links": {
48         "self": {
49           "href": "/api/v2/members/569f183514f4432160000007",
50           "type": "application/json"
51         }
52       },
53       "_id": "569f183514f4432160000007",
54       "role": "admin",
55       "email": "ariel@acme.com",
56       "firstName": "Ariel",
57       "lastName": "Flores"
58     },
59     "team": {
60       "customRoleKeys": [
61         "access-to-test-projects"
62       ],
63       "key": "team-key-123abc",
64       "name": "QA Team",
65       "_links": {
66         "key": {}
67       }
68     }
69   }
70 }

Get application versions by application key

Up Next

Built with

1	curl https://app.launchdarkly.com/api/v2/applications/applicationKey \
2	-H "Authorization: <apiKey>"

1	{
2	"autoAdded": true,
3	"key": "com.launchdarkly.cafe",
4	"kind": "browser",
5	"name": "LaunchDarklyCafe",
6	"flags": {
7	"items": [
8	{
9	"name": "Example flag",
10	"key": "flag-key-123abc"
11	}
12	],
13	"totalCount": 1,
14	"_links": {
15	"key": {}
16	}
17	},
18	"_access": {
19	"denied": [
20	{
21	"action": "action",
22	"reason": {
23	"effect": "allow"
24	}
25	}
26	],
27	"allowed": [
28	{
29	"action": "action",
30	"reason": {
31	"effect": "allow"
32	}
33	}
34	]
35	},
36	"_links": {
37	"key": {
38	"href": "href",
39	"type": "type"
40	}
41	},
42	"_version": 1,
43	"creationDate": 1000000,
44	"description": "The LaunchDarkly Cafe app",
45	"_maintainer": {
46	"member": {
47	"_links": {
48	"self": {
49	"href": "/api/v2/members/569f183514f4432160000007",
50	"type": "application/json"
51	}
52	},
53	"_id": "569f183514f4432160000007",
54	"role": "admin",
55	"email": "ariel@acme.com",
56	"firstName": "Ariel",
57	"lastName": "Flores"
58	},
59	"team": {
60	"customRoleKeys": [
61	"access-to-test-projects"
62	],
63	"key": "team-key-123abc",
64	"name": "QA Team",
65	"_links": {
66	"key": {}
67	}
68	}
69	}
70	}