Skip to content

GET /application/{name}/tags/available — List upstream tags

GET https://api.sandbox-gameye.gameye.net/application/{name}/tags/available

Section titled “GET https://api.sandbox-gameye.gameye.net/application/{name}/tags/available”

Returns all image tags available for a given application in its upstream Docker registry. Use this to discover which versions can be enabled via POST /application/{name}/tags.

Requires the application:read scope.

ParameterTypeRequiredDescription
namestringYesThe name of the application.
ParameterTypeRequiredDescriptionDefault
pageintegerNoPage number to retrieve. Min 1, max 1000.1
pageSizeintegerNoNumber of tags per page. Min 1, max 1000.20
cURL
curl 'https://api.sandbox-gameye.gameye.net/application/my-game-server/tags/available?page=1&pageSize=20' \
--header 'Authorization: Bearer YOUR_TOKEN' \
--header 'Accept: application/json'
JavaScript
const response = await fetch(
'https://api.sandbox-gameye.gameye.net/application/my-game-server/tags/available?page=1&pageSize=20',
{
headers: {
'Authorization': 'Bearer YOUR_TOKEN',
'Accept': 'application/json',
},
}
);
const { tags } = await response.json();
Python
import requests
response = requests.get(
'https://api.sandbox-gameye.gameye.net/application/my-game-server/tags/available',
params={'page': 1, 'pageSize': 20},
headers={
'Authorization': 'Bearer YOUR_TOKEN',
'Accept': 'application/json',
},
)
tags = response.json()['tags']

A paginated list of tags available in the upstream registry.

FieldTypeRequiredDescription
tagsarrayYesList of tag objects.
tags[].versionstringYesThe tag version string.
{
"tags": [
{ "version": "v1.2.3" },
{ "version": "v1.2.2" },
{ "version": "latest" }
]
}

You are not authorized. Make sure your bearer token is correct.

Your API token does not have the required permissions to invoke this endpoint.