pub struct Release {Show 27 fields
pub id: Option<String>,
pub created_at: Option<DateTime<Utc>>,
pub updated_at: Option<DateTime<Utc>>,
pub archived_at: Option<DateTime<Utc>>,
pub name: Option<String>,
pub description: Option<String>,
pub version: Option<String>,
pub commit_sha: Option<String>,
pub pipeline: Option<ReleasePipeline>,
pub stage: Option<ReleaseStage>,
pub creator: Option<Box<User>>,
pub slug_id: Option<String>,
pub start_date: Option<NaiveDate>,
pub target_date: Option<NaiveDate>,
pub started_at: Option<DateTime<Utc>>,
pub completed_at: Option<DateTime<Utc>>,
pub canceled_at: Option<DateTime<Utc>>,
pub trashed: Option<bool>,
pub progress_history: Option<Value>,
pub current_progress: Option<Value>,
pub history: Option<ReleaseHistoryConnection>,
pub url: Option<String>,
pub documents: Option<DocumentConnection>,
pub issues: Option<IssueConnection>,
pub issue_count: Option<i64>,
pub links: Option<EntityExternalLinkConnection>,
pub release_notes: Option<Vec<ReleaseNote>>,
}Expand description
Internal A release that bundles issues together for a software deployment or version. Releases belong to a release pipeline and progress through stages (e.g., planned, started, completed, canceled). Issues are associated with releases via the IssueToRelease join entity, and the release tracks lifecycle timestamps such as when it was started, completed, or canceled.
Fields§
§id: Option<String>The unique identifier of the entity.
created_at: Option<DateTime<Utc>>The time at which the entity was created.
updated_at: Option<DateTime<Utc>>The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn’t been updated after creation.
archived_at: Option<DateTime<Utc>>The time at which the entity was archived. Null if the entity has not been archived.
name: Option<String>The name of the release.
description: Option<String>The description of the release in plain text or markdown. Null if no description has been set.
version: Option<String>The version identifier for this release (e.g., ‘v1.2.3’ or a short commit hash). Must be unique within the pipeline. Null if no version has been assigned.
commit_sha: Option<String>The Git commit SHA associated with this release. Used for SHA-based idempotency when completing releases and for linking releases to specific points in the repository history. Null if the release was created without a commit reference.
pipeline: Option<ReleasePipeline>The release pipeline that this release belongs to. A release always belongs to exactly one pipeline.
stage: Option<ReleaseStage>The current stage of the release within its pipeline (e.g., Planned, In Progress, Completed, Canceled). Changing the stage triggers lifecycle timestamp updates and may move non-closed issues to a new release when completing a scheduled pipeline release.
creator: Option<Box<User>>The user who created the release. Null if the release was created by a non-user context such as an access key or automation.
slug_id: Option<String>The release’s unique URL slug, used to construct human-readable URLs for the release.
start_date: Option<NaiveDate>The estimated start date of the release. This is a date-only value without a time component. Automatically set to today when the release moves to a started stage if not already set. Null if no start date has been specified.
target_date: Option<NaiveDate>The estimated completion date of the release. This is a date-only value without a time component. Null if no target date has been specified.
started_at: Option<DateTime<Utc>>The time at which the release first entered a started stage. Null if the release has not yet been started.
completed_at: Option<DateTime<Utc>>The time at which the release was completed. Set automatically when the release moves to a completed stage. Reset to null if the release moves back to a non-completed stage.
canceled_at: Option<DateTime<Utc>>The time at which the release was canceled. Set automatically when the release moves to a canceled stage. Reset to null if the release moves back to a non-canceled stage.
trashed: Option<bool>A flag that indicates whether the release is in the trash bin. Trashed releases are archived and will be permanently deleted after a retention period. Null when the release is not trashed.
progress_history: Option<Value>Internal The historical progress snapshots for the release, tracking how issue completion has evolved over time.
current_progress: Option<Value>Internal The current progress summary for the release, including counts of issues by workflow state type (e.g., completed, in progress, unstarted).
history: Option<ReleaseHistoryConnection>Internal History entries associated with the release.
url: Option<String>The URL to the release page in the Linear app.
documents: Option<DocumentConnection>Internal Documents associated with the release.
issues: Option<IssueConnection>ALPHA Issues associated with the release.
issue_count: Option<i64>ALPHA Number of issues associated with the release.
links: Option<EntityExternalLinkConnection>Internal Links associated with the release.
release_notes: Option<Vec<ReleaseNote>>ALPHA Release notes for the release.