DocumentationTypeship CLITypeship MCPTypeship SDKsAPI Reference
Console
Deliveries

Delete a Delivery

DELETE
/deliveries/{delivery_id}

Removes a Delivery from its Target. Removing a repository Delivery retires the Target's open release pull request; removing a hosted MCP Delivery stops serving its URL. Recreating the type later allocates a new ID and, for hosted MCP, a new URL.

A 409 target_busy means the Target is publishing; wait for it to finish. A 502 follow_up_failed means the Delivery was removed, but retiring an obsolete review or regenerating the Target failed. See conditional writes for ETag and If-Match.

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}$

Header Parameters

If-Match?string

ETag from a preceding response. The write applies only if the resource still has that version; otherwise it returns 412 precondition_failed without changes. Omit to write the current version. See https://typeship.dev/docs/typeship-api#conditional-writes.

Length1 <= length <= 1024

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X DELETE "https://example.com/deliveries/dlv_4q8m2v7k1p9d5h6c"
{  "id": "dlv_4q8m2v7k1p9d5h6c",  "object": "delivery",  "deleted": true,  "request_id": "req_3k8m1v6q9p2d7h4c"}

Update a Delivery PATCH

Replaces a repository Delivery's settings. Omitted optional settings reset to their defaults. Hosted MCP Deliveries have no settings to update. With Project auto_generate enabled, changing a Delivery queues the Target's Generation. A queued or running Target reuses that Generation. Omitting If-Match applies the update to the current Delivery; with If-Match, a stale ETag returns 412 precondition_failed without saving. A `409 delivery_conflict` means another Target owns the requested repository directory. A `409 target_busy` means the Target is publishing; wait for it to finish. A `502 follow_up_failed` means the Delivery was saved, but retiring an obsolete review or regenerating the Target failed. Get the Delivery and follow the error's retryable and suggested_action fields. See [conditional writes](https://typeship.dev/docs/typeship-api#conditional-writes) for ETag and If-Match.

List publications GET

Next Page