Discard selected Draft customizations
Replace explicitly listed non-conflicting paths with generated files in one Draft commit. Listing a customer-only file deletes it. Use dry_run to inspect writes and deletions first. Resolve conflicts through the separate conflicts action. Generate afterward to refresh the Draft and its checks.
Authorization
apiKey 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
Stable identifier for one configured generated product.
^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 POST "https://example.com/targets/tgt_5m8q2v7k1p9d4h6c/draft/customizations/discard" \ -H "Content-Type: application/json" \ -d '{ "expected_head_revision": "0123456789abcdef0123456789abcdef01234567", "paths": [ "src/helper.ts" ], "dry_run": true }'{ "target_id": "tgt_5m8q2v7k1p9d4h6c", "head_revision": "0123456789abcdef0123456789abcdef01234567", "request_id": "req_3k8m1v6q9p2d7h4c", "object": "draft_code_update", "status": "preview", "total_files": 1, "has_more": false, "next_path": null, "files": [ { "path": "src/helper.ts", "action": "delete", "content_base64": null, "mode": null, "size_bytes": null, "content_offset": 0, "next_offset": null } ]}Resolve selected Draft conflicts POST
Save deliberate decisions for the exact inspected Draft. Keep the repository or incoming side, or submit final file content, including binary bytes. Decisions save atomically. Use dry_run to preview them, then generate the Target separately to apply saved decisions and run its checks.
Review and recover rewritten repository history POST
Preview a rewritten default branch and the Draft code to preserve. Approve the exact inspected revisions with dry_run false, then Generate separately. Recovery preserves the previous Draft branch, opens a new Draft from the current default branch, and requires explicit decisions for overlapping code. A rewritten Draft alone recovers automatically during Generate.