DocumentationTypeship CLITypeship MCPTypeship SDKsAPI Reference
Console
Targets

Delete a Target

DELETE
/targets/{target_id}

Deletes a Target with no Generation history, release history, or active Draft. A 409 resource_has_dependencies means one of those resources still depends on it. Retrieve the Target, disable it instead, or resolve the dependency before retrying.

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

target_id*string

Stable identifier for one configured generated product.

Match^tgt_[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

curl -X DELETE "https://example.com/targets/tgt_5m8q2v7k1p9d4h6c"
{  "id": "tgt_5m8q2v7k1p9d4h6c",  "object": "target",  "deleted": true,  "request_id": "req_3k8m1v6q9p2d7h4c"}

Update a Target PATCH

Omitted fields keep their current values. Supplied config and checks replace their complete stored values. Change Deliveries with createDelivery, updateDelivery, and deleteDelivery. With Project auto_generate enabled, changing Target config or checks queues that Target's Generation. A queued or running Target reuses that Generation. Omitting If-Match applies the update to the current resource; with If-Match, a stale ETag returns 412 precondition_failed without saving. Select the next version through PATCH /drafts/{draft_id} on the Target's draft_id. A `409 target_busy` means the Target is publishing; wait for it to finish. A `409 delivery_conflict` means another Target owns the requested repository tree; retrieve both Targets, choose a free destination, and retry. A `502 follow_up_failed` means the update was saved, but retiring an obsolete review or regenerating the Target failed. Retrieve the Target 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.

Adopt a package release POST

Checks the repository tag, package metadata, and registry artifact, then records the package as an Imported latest release. Opens the first Typeship Draft at the next major version; review it to establish the baseline for preserving existing code.