---
title: "Create Run Promotion Draft"
method: POST
path: "/api/v1/optimization/runs/{run_id}/promotion-drafts"
tags: ["optimization"]
---

# Create Run Promotion Draft

`POST /api/v1/optimization/runs/{run_id}/promotion-drafts`

Create or load a non-mutating draft promotion artifact for an optimization run.

## Path parameters

- `run_id` string, required — Identifier of the optimization run to draft for promotion.

## Response `200`

Successful Response

- OptimizationPromotionDraftResponse — A draft promotion artifact for a completed optimization run.
  - `ok` boolean — Whether the draft was created or loaded.
  - `draft_id` string, required — Stable promotion draft identifier.
  - `run_id` string, required — Optimization run id.
  - `target` string, required — Skill/module target represented by the draft.
  - `status` 'draft' — Draft status.
  - `summary` string, required — Human-readable draft summary.
  - `optimized_artifact_path` string, nullable — Optimized artifact path.
  - `manifest_path` string, nullable — Source manifest path.
  - `draft_path` string, required — Filesystem path to the draft artifact.
  - `created_at` string, required — ISO timestamp when the draft was created.

## Other responses

- `401` — Authentication is required or the provided token is invalid.
- `404` — Run not found.
- `422` — Validation Error

---

[API](https://skmtc.net/qredence/apis/fleet-rlm.md) · [All operations](https://skmtc.net/qredence/apis/fleet-rlm/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/qredence/fleet-rlm/revisions/62e8c152aa18/schema)