git.releases.list

List a repository’s releases, newest first

GET /git/api/repositories/{repoId}/releasesIAM git:ListReleasesRead

Request syntax

GET /git/api/repositories/{repoId}/releases

Path parameters

  • repoIdRequired

    string

    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

  • [].​idAlways

    string

    The release id
  • [].​tagNameAlways

    string

    The tag it publishes, without refs/tags/
  • [].​commitOidAlways

    string

    The commit the tag pointed at when the release was created
  • [].​nameAlways

    string

    The title; the tag name unless one was given
  • [].​bodyAlways

    string

    Release notes (Markdown); empty when none were written
  • [].​draftAlways

    boolean

    A draft is not published yet
  • [].​prereleaseAlways

    boolean

    Marked a pre-release
  • [].​createdAtAlways

    string

    When it was created (ISO 8601)
  • [].​publishedAtAlways

    string, may be null

    When it was published (ISO 8601); null while it is a draft
  • [].​assetsAlways

    array of object

    Files attached to the release
  • [].​assets[].​idAlways

    string

    The asset id
  • [].​assets[].​nameAlways

    string

    The file name it downloads as; unique within the release
  • [].​assets[].​contentTypeAlways

    string

    The content type declared at upload; downloads are always application/octet-stream
  • [].​assets[].​sizeBytesAlways

    number

    Size of the file, in bytes
  • [].​assets[].​downloadCountAlways

    number

    How many times it was downloaded
  • [].​assets[].​createdAtAlways

    string

    When it was uploaded (ISO 8601)
  • [].​assets[].​downloadUrlAlways

    string

    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 repoId

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.