List app releases in Dynatrace with the Hub API for a specific app, including revoked releases, and return the release list.
| GET | SaaS | https://{your-environment-id}.apps.dynatrace.com/platform/hub/v1/catalog/apps/{id}/releases |
You use the app ID path parameter to list the releases published for that app in the current environment. The response returns a list of releases, including revoked releases.
To execute this request, you need a platform token or OAuth access token with hub:catalog:read scope. To learn how to obtain and use it, see Tokens and authentication.
The request doesn't provide any configurable parameters.
| Code | Type | Description |
|---|---|---|
| 200 | Releases | A list of releases |
| 4XX | - | - |
| 5XX | - | - |
ReleasesList object| Element | Type | Description |
|---|---|---|
| releases | Release[] | - |
Release object| Element | Type | Description |
|---|---|---|
| version | string | A semantic versioning 2.0 conform version. |
| releaseNotes | string | Markdown content describing this release. |
| compatible | Compatibility | -The element can hold these values
|
| publicationTime | string | - |
| revocation | Revocation | The existence of this object marks a release as being revoked. It contains information on why this is the case. |
| manifest | Manifest | - |
| extensionMetadata | Extension | - |
| extensionDocuments | - | - |
| contentCount | Content | - |
Compatibility objectRevocation objectThe existence of this object marks a release as being revoked. It contains information on why this is the case.
| Element | Type | Description |
|---|---|---|
| reason | Revocation | -The element can hold these values
|
| severity | Revocation | -The element can hold these values
|
| description | string | - |
RevocationReason objectRevocationSeverity objectManifest object| Element | Type | Description |
|---|---|---|
| actions | - | - |
| csp | - | - |
| intents | - | - |
| pageTokens | - | - |
| scopes | Manifest | - |
| documents | - | - |
| dependencies | Dependency[] | - |
| Content | DEPRECATED The contentCount here is deprecated. Please prefer the field on the root of the Release object. | |
| settings | - | - |
| hidden | boolean | - |
ManifestScope object| Element | Type | Description |
|---|---|---|
| name | string | - |
| comment | string | - |
Dependency object| Element | Type | Description |
|---|---|---|
| name | string | The name of the required dependency |
| version | string | SemVer2 version of the required dependency |
ContentCount object| Element | Type | Description |
|---|---|---|
| documents | Asset | - |
| actions | Asset | - |
| settings | Asset | - |
DocumentCount object| Element | Type | Description |
|---|---|---|
| types | object | - |
AssetCount object| Element | Type | Description |
|---|---|---|
| total | integer | - |
ExtensionMetadata object| Element | Type | Description |
|---|---|---|
| extensionContents | - | - |
| featureSets | string[] | - |
| featureSetsDetails | object | - |
{"releases": [{"version": "2.0.0","releaseNotes": "Now *even more* descriptive!","compatible": "COMPATIBLE","publicationTime": "2023-04-25T12:00:00Z","revocation": {"reason": "SECURITY_ISSUE","severity": "HIGH","description": "This release contained CVE-XXXX"},"manifest": {"actions": {},"csp": {},"intents": {},"pageTokens": {},"scopes": [{"name": "string","comment": "string"}],"documents": {},"dependencies": [{"name": "/platform/hub/v1","version": "1.2.3"}],"contentCount": {"documents": {"total": 1},"actions": {},"settings": {}},"settings": {},"hidden": false},"extensionMetadata": {"extensionContents": {},"featureSets": ["string"],"featureSetsDetails": {}},"extensionDocuments": {},"contentCount": {}}]}