Releases
endpoint
string
Which product. Optional when the board has one project.
string
open or completed, lowercase. A frozen release is still open — freezing
is not a third status, it is a release that has taken a branch of its own and
completes the same way.string | null
When what this release ships stopped changing. A frozen release has had its branch cut, and a card joins it after that only through a deliberate pick — which is the whole point of the moment.
Inbox
endpoint
string
Which product. Optional when the board has one project.
kind
A branch created by hand whose name matches the team’s convention. Tylon offers the link and only offers it — linking the wrong branch to a card on a guess is worse than not noticing it.
kind
A card whose move was refused, with the forge’s own words: conflicts, red checks, nothing to merge.
kind
Something a monitor grouped in production. It waits here rather than landing on the board — a backlog that fills itself is a backlog nobody reads.
Creating and shaping a release
endpoint
string
required
1 to 80 characters —
2026.09, Checkout rewrite.string
Which product. A release delivers one, so this is required when the board
holds several.
endpoint
integer[]
required
The whole scope, not additions — up to 500.
PUT because a caller computing
the scope somewhere else wants to say what it is now, rather than diff it
against whatever is there.204.
A flow has to have releases turned on. Otherwise this is
400: “This flow
does not work with releases. Turn it on in the flow settings first.” A team
shipping continuously never meets any of this.Freezing
endpoint
endpoint
Picking into a frozen one
endpoint
integer
required
Promoting
endpoint
string
required
The stage to move the release’s cards into.
integer[]
Only these. Left out, the whole release goes.
200 with an outcome rather than throwing. A release of twelve cards
where nine promoted and three were refused is news, not an error — the
refusals are in the body, each naming its card and the repository that said
no, and the nine that landed stay landed.
Completing
endpoint
object[]
required
One entry per repository:
{ "repositoryId": "…", "tagName": "v2.4.0" }.
Each repository gets its own tag and its own release on the provider,
because each keeps its own versioning — there is no single number for a
delivery that spans three of them.endpoint
204.
The inbox, cleared
endpoint
integer
Which card. Optional — the Inbox already guessed from the naming
convention, and this is how you overrule the guess.
endpoint
204.