Get application versions by application key

Beta

GET

/api/v2/applications/:applicationKey/versions

GET

/api/v2/applications/:applicationKey/versions

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

1 {
2   "_links": {},
3   "items": [
4     {
5       "autoAdded": true,
6       "key": "2",
7       "name": "01.02.03",
8       "_access": {
9         "denied": [
10           {
11             "action": "string",
12             "reason": {
13               "effect": "allow",
14               "resources": [
15                 "proj/*:env/*;qa_*:/flag/*"
16               ],
17               "notResources": [
18                 "string"
19               ],
20               "actions": [
21                 "*"
22               ],
23               "notActions": [
24                 "string"
25               ],
26               "role_name": "string"
27             }
28           }
29         ],
30         "allowed": [
31           {
32             "action": "string",
33             "reason": {
34               "effect": "allow",
35               "resources": [
36                 "proj/*:env/*;qa_*:/flag/*"
37               ],
38               "notResources": [
39                 "string"
40               ],
41               "actions": [
42                 "*"
43               ],
44               "notActions": [
45                 "string"
46               ],
47               "role_name": "string"
48             }
49           }
50         ]
51       },
52       "_links": {},
53       "_version": 1,
54       "creationDate": 1654104600000,
55       "supported": true
56     }
57   ],
58   "totalCount": 1
59 }

Get a list of versions for a specific application in an account.

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

{
  "_links": {},
  "items": [
    {
      "autoAdded": true,
      "key": "2",
      "name": "01.02.03",
      "_access": {
        "denied": [
          {
            "action": "string",
            "reason": {
              "effect": "allow",
              "resources": [
                "proj/*:env/*;qa_*:/flag/*"
              ],
              "notResources": [
                "string"
              ],
              "actions": [
                "*"
              ],
              "notActions": [
                "string"
              ],
              "role_name": "string"
            }
          }
        ],
        "allowed": [
          {
            "action": "string",
            "reason": {
              "effect": "allow",
              "resources": [
                "proj/*:env/*;qa_*:/flag/*"
              ],
              "notResources": [
                "string"
              ],
              "actions": [
                "*"
              ],
              "notActions": [
                "string"
              ],
              "role_name": "string"
            }
          }
        ]
      },
      "_links": {},
      "_version": 1,
      "creationDate": 1654104600000,
      "supported": true
    }
  ],
  "totalCount": 1
}

Get a list of versions for a specific application in an account.

Authentication

Authorizationstring

API Key authentication via header

Path parameters

applicationKeystringRequiredformat: "string"

The application key

Query parameters

filterstringOptionalformat: "string"

Accepts filter by `key`, `name`, `supported`, and `autoAdded`. To learn more about the filter syntax, read [Filtering applications and application versions](https://launchdarkly.com/docs/api/applications-beta#filtering-applications-and-application-versions).

limitlongOptional

The number of versions to return. Defaults to 50.

offsetlongOptional

Where to start in the list. Use this with pagination. For example, an offset of 10 skips the first ten items and then returns the next items in the list, up to the query limit.

sortstringOptionalformat: "string"

Accepts sorting order and fields. Fields can be comma separated. Possible fields are creationDate, name. Examples: sort=name sort by names ascending, sort=-name,creationDate sort by names descending and creationDate ascending.

Response

Application versions response

_linksmap from strings to objects

The location and content type of related resources

itemslist of objects

A list of the versions for this application

totalCountinteger

The number of versions for this application

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

429

Too Many Requests Error

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

1	{
2	"_links": {},
3	"items": [
4	{
5	"autoAdded": true,
6	"key": "2",
7	"name": "01.02.03",
8	"_access": {
9	"denied": [
10	{
11	"action": "string",
12	"reason": {
13	"effect": "allow",
14	"resources": [
15	"proj/:env/;qa_:/flag/"
16	],
17	"notResources": [
18	"string"
19	],
20	"actions": [
21	"*"
22	],
23	"notActions": [
24	"string"
25	],
26	"role_name": "string"
27	}
28	}
29	],
30	"allowed": [
31	{
32	"action": "string",
33	"reason": {
34	"effect": "allow",
35	"resources": [
36	"proj/:env/;qa_:/flag/"
37	],
38	"notResources": [
39	"string"
40	],
41	"actions": [
42	"*"
43	],
44	"notActions": [
45	"string"
46	],
47	"role_name": "string"
48	}
49	}
50	]
51	},
52	"_links": {},
53	"_version": 1,
54	"creationDate": 1654104600000,
55	"supported": true
56	}
57	],
58	"totalCount": 1
59	}