DocumentationTypeship CLITypeship MCPTypeship SDKsAPI Reference
Console
Targets

Select an exact Draft version or return to automatic versioning

PATCH
/targets/{target_id}/draft

Checks your version choice against the required version bump, then regenerates the existing Draft pull request.

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

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X PATCH "https://example.com/targets/tgt_5m8q2v7k1p9d4h6c/draft" \  -H "Content-Type: application/json" \  -d '{    "version": "string"  }'
{  "object": "target_draft",  "target_id": "tgt_5m8q2v7k1p9d4h6c",  "revision": 0,  "current_version": "string",  "version": "string",  "selection": {    "mode": "automatic"  },  "readiness": {},  "changes": {    "changelog": "string",    "breaking_count": 0,    "previous_version": "string"  },  "head_revision": "string",  "pull_request_url": "http://example.com",  "request_id": "req_3k8m1v6q9p2d7h4c"}

Retrieve a Target's rolling Draft release GET

Returns Current's version, the proposed Draft version, readiness, and commit. Pass `revision` as `expected_revision` when updating the Draft to avoid changing a newer candidate.

Inspect preserved custom code for a Target Draft GET

Returns preserved changes, conflicts, reused resolutions, and check results for the Draft. Includes the input and package identifiers needed to compare attempts. Does not include file contents.