---
title: "Updates the release notes on an existing Release."
method: POST
path: "/{spaceId}/releases/{releaseId}/release-notes"
tags: ["Releases"]
---

# Updates the release notes on an existing Release.

`POST /{spaceId}/releases/{releaseId}/release-notes`

Only the release notes are changed and everything else about the Release is left alone. Variable expressions in the notes are evaluated before they are stored, so the saved text is the resolved one.

## Path parameters

- `spaceId` string, required
- `releaseId` string, required

## Request body

- UpdateReleaseNotesCommand
  - `ReleaseId` string, required — The ID of the release, for example 'Releases-123'.
  - `ReleaseNotes` string, required — The notes to store, replacing whatever the release currently has. Markdown is supported. Build information is in scope, so expressions such as #{Octopus.Release.WorkItems} and #{Octopus.Release.Number} are resolved before the notes are saved. Send an empty string to clear them.
  - `SpaceId` string, required

## Response `200`

Confirmation that the release notes were updated, containing the updated Release

- ReleaseResource
  - `Assembled` string, date-time
  - `BuildInformation` ReleasePackageVersionBuildInformationResource[]
    - `Branch` string
    - `BuildEnvironment` string
    - `BuildNumber` string
    - `BuildUrl` string
    - `Commits` CommitDetails[]
      - `Comment` string
      - `Id` string
      - `LinkUrl` string
    - `IssueTrackerName` string
    - `PackageId` string
    - `VcsCommitNumber` string
    - `VcsCommitUrl` string
    - `VcsRoot` string
    - `VcsType` string
    - `Version` string
    - `WorkItems` WorkItemLink[]
      - `Description` string
      - `Id` string
      - `LinkUrl` string
      - `Source` string
  - `ChannelId` string
  - `CustomFields` object
  - `Id` string
  - `IgnoreChannelRules` boolean
  - `LastModifiedBy` string
  - `LastModifiedOn` string, date-time
  - `LibraryVariableSetSnapshotIds` string[]
  - `Links` object
  - `ProjectDeploymentProcessSnapshotId` string
  - `ProjectId` string
  - `ProjectVariableSetSnapshotId` string
  - `ReleaseNotes` string
  - `SelectedGitResources` SelectedGitResource[]
    - `ActionName` string, required
    - `GitReferenceResource` GitReferenceResource, required
      - `GitCommit` string
      - `GitRef` string
    - `GitResourceReferenceName` string
  - `SelectedPackages` SelectedPackage[]
    - `ActionName` string
    - `PackageReferenceName` string
    - `StepName` string
    - `Version` string
  - `SpaceId` string
  - `Version` string, required
  - `VersionControlReference` SnapshotGitReferenceResource
    - `GitCommit` string
    - `GitRef` string
    - `VariablesGitCommit` string

## Other responses

- `400` — Bad request. Either the payload was not structurally valid or business rules did not permit the operation.
- `404` — Not found. One or more of the entities involved in the operation was not found.

---

[API](https://skmtc.net/octopus/apis/octopus-server-api.md) · [All operations](https://skmtc.net/octopus/apis/octopus-server-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/octopus/octopus-server-api/revisions/dbbd6d1e3f1c/schema)