Releases

Retry publishing an exact release

POST
/releases/{release_id}/republish

Retries publishing the specified release through its repository workflow. Uses that release's version and accepted commit, even if a newer Draft or release exists.

A 502 response means the repository publishing workflow could not be dispatched.

AuthorizationBearer <token>

Organization API key from the console (ak_...), or an OAuth access token with user:org:read, the organization selected during consent, and the capability required by the operation.

In: header

Path Parameters

release_id*string
Match^rel_[a-z0-9]{16}$

Header Parameters

Idempotency-Key?string

Identifies one logical write for 24 hours. The key is scoped to the authenticated organization and operation; generation without an organization uses a hashed network identity. Retrying the same method, path, query, If-Match header, and JSON body replays the original response. Reusing the key with changed intent returns 409. After expiry the key starts a new write.

Match^[!-~]+$
Length1 <= length <= 255

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/releases/rel_7m2q8v4k1p9d5h6c/republish"
{  "id": "rel_7m2q8v4k1p9d5h6c",  "object": "release",  "target_id": "tgt_5m8q2v7k1p9d4h6c",  "generation_id": "gen_7h2p5d9c3m8w1k6q",  "version": "1.0.0",  "channel": "stable",  "origin": "typeship",  "repository": {    "provider": "github",    "identifier": "parcel-example/parcel-client"  },  "spec_revision_id": "srev_6m1q8v4k2p9d7h3c",  "commit_sha": "0123456789abcdef0123456789abcdef01234567",  "checks": [],  "approvals": [],  "import_provenance": null,  "publications": [],  "created_at": "2026-09-23T08:00:00Z",  "request_id": "req_3k8m1v6q9p2d7h4c"}