Skip to main content
GET
Get one release: blockers, risk factors, next actions, decision.
Scope: review:releases:read. See API Tokens.

Authorizations

Authorization
string
header
required

CloudThinker token: a personal access token ct_pat_… (fine-grained scopes, created in Settings) or an OAuth access token ct_oat_… (1 hour, from the OAuth flow). Send Authorization: Bearer <token>. Scopes have the form module:resource:read|write; write includes read.

Path Parameters

workspace_id
string<uuid>
required

Workspace to act in. Every call names it.

release_id
string<uuid>
required

Release id.

Response

OK

One release: blockers, risk factors, next actions, changelog and decision.

id
string<uuid>
required
provider
enum<string>
required
Available options:
gitlab,
github,
bitbucket,
azure_devops,
aws_codecommit
project
string
required

Repository path, for example group/project.

track
string
required
ref_kind
enum<string>
required
Available options:
tag,
branch,
commit,
environment
head_ref
string
required
base_ref
string | null
required
status
enum<string>
required
Available options:
analyzing,
failed,
blocked,
clear,
shipped_anyway,
superseded
analysis_status
enum<string>
required
Available options:
pending,
analyzing,
ready,
failed
decision
enum<string>
required
Available options:
pending,
approved,
held
blocking_count
integer
required
open_blocking_count
integer
required
top_blocker
string | null
required
watch_count
integer
required
quality
number | null
required
merge_requests_total
integer | null
required
merge_requests_reviewed
integer | null
required
unresolved_high
integer | null
required
open_findings
integer | null
required
superseded
boolean
required
created_at
string<date-time>
required
base_sha
string | null
required
head_sha
string
required
summary
ReleaseSummaryText · object | null
required
factors
ReleaseRiskFactor · object[]
required
next_actions
ReleaseNextAction · object[]
required
changelog
ReleaseChangelogSection · object[]
required
gate
enum<string> | null
required
Available options:
pending,
success,
failed,
error,
unavailable,
unsupported
gate_detail
string | null
required
limitations
string[]
required
failure_reason
string | null
required
conversation_id
string<uuid> | null
required
decision_at
string<date-time> | null
required
decision_note
string | null
required
truncated
boolean
required

True when the range was too large to analyze in full.

scope
ReleaseScopeV1 · object | null
required

Size of the release range; null until it is measured.

pipeline
ReleasePipelineV1 · object | null
required

Latest CI pipeline on the released ref.

successor_id
string<uuid> | null
required

The newer release analysis that replaced this one.

changes
ReleaseChangeV1 · object[] | null
required

Notable changes; null until the analysis publishes.

coverage
enum<string> | null
required

Whether the analysis read the whole range.

Available options:
complete,
partial