git.releases.listList a repository’s releases, newest first
Request syntax
GET /git/api/repositories/{repoId}/releasesPath parameters
repoIdRequiredstring
Constraints: uuid
Response
200 with the releases: id, tagName, commitOid, name, body, draft, prerelease, createdAt, publishedAt, and `assets` (id, name, contentType, sizeBytes, downloadCount, createdAt, downloadUrl).
A JSON response is wrapped as { "success": true, "data": … }; the CLI prints the whole body with --json.
Fields of data
[].idAlwaysstring
The release id[].tagNameAlwaysstring
The tag it publishes, without refs/tags/[].commitOidAlwaysstring
The commit the tag pointed at when the release was created[].nameAlwaysstring
The title; the tag name unless one was given[].bodyAlwaysstring
Release notes (Markdown); empty when none were written[].draftAlwaysboolean
A draft is not published yet[].prereleaseAlwaysboolean
Marked a pre-release[].createdAtAlwaysstring
When it was created (ISO 8601)[].publishedAtAlwaysstring, may be null
When it was published (ISO 8601); null while it is a draft[].assetsAlwaysarray of object
Files attached to the release[].assets[].idAlwaysstring
The asset id[].assets[].nameAlwaysstring
The file name it downloads as; unique within the release[].assets[].contentTypeAlwaysstring
The content type declared at upload; downloads are always application/octet-stream[].assets[].sizeBytesAlwaysnumber
Size of the file, in bytes[].assets[].downloadCountAlwaysnumber
How many times it was downloaded[].assets[].createdAtAlwaysstring
When it was uploaded (ISO 8601)[].assets[].downloadUrlAlwaysstring
The API path that downloads the file
Checked against the handlers: every route test validates their answers against this schema.
Errors
- 400The request does not pass the schema above. The body is { "error": …, "issues": […] }, one issue per field.
- 401No credentials, or an access key that is unknown, revoked or expired.
- 403The caller's policies do not allow git:ListReleases on this resource. The body names the action and the resource, and the refusal is recorded in the audit log.
- 404The resource does not exist in your organization.
Examples
The required parameters only, with example values. Replace id and the other placeholders with your own.
dcloud git releases list repoIdcurl -X GET "https://console.platform-development.deutschecloud.app/git/api/repositories/repoId/releases" \
-H "Authorization: EWS-ACCESS-KEY $ACCESS_KEY"Generated from the API description, the same one the API checks requests against and the CLI is built from. MCP tool: dcloud_git_releases_list.