git.releases.get

One release

GET /git/api/repositories/{repoId}/releases/{releaseId}IAM git:ListReleasesRead

Request syntax

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

Path parameters

  • repoIdRequired

    string

    Constraints: uuid

  • releaseIdRequired

    string

    Constraints: uuid

Response

200 with the release: id, tagName, commitOid, name, body, draft, prerelease, createdAt and publishedAt (its assets come from `release-assets list`).

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

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 get repoId releaseId

Generated from the API description, the same one the API checks requests against and the CLI is built from. MCP tool: dcloud_git_releases_get.