DocumentationTypeship CLITypeship MCPTypeship SDKsAPI Reference
Console
Targets

Retrieve a Delivery

GET
/deliveries/{delivery_id}

Returns the configured repository or hosted MCP Delivery for a Target. A Delivery in another organization returns 404 not_found.

Authorization

apiKey
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

delivery_id*string
Match^dlv_[a-z0-9]{16}$

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/deliveries/dlv_4q8m2v7k1p9d5h6c"
{  "id": "dlv_4q8m2v7k1p9d5h6c",  "object": "delivery",  "target_id": "tgt_5m8q2v7k1p9d4h6c",  "kind": "repository",  "state": "active",  "repository": {    "provider": "github",    "identifier": "parcel-example/parcel-client"  },  "directory": null,  "package_name": "parcel-client",  "module_path": null,  "publish_on_merge": false,  "created_at": "2026-09-23T08:00:00Z",  "updated_at": "2026-09-23T08:00:00Z",  "request_id": "req_3k8m1v6q9p2d7h4c"}

Approve recovery from rewritten default-branch history POST

When the Draft status is `history_rewritten`, review the affected files with `listDraftFiles` and `filter=history`, then approve with the Draft's `history_recovery` revisions. Approval saves the recovery without changing Git, and the Draft status becomes `needs_generation`: generate the Target to open a new Draft from the rewritten default branch. The previous Draft branch stays available, and overlapping code comes back as conflicts to resolve. A rewritten Draft branch alone needs no approval.

Retrieve a Publication GET

Returns the current registry publication state for a Target Release. A Publication in another organization returns 404 not_found.