---
title: "Save an unfinished deployment configuration, creating the draft or replacing it"
method: PUT
path: "/v1/configure-drafts/{draftId}"
tags: ["Deployments"]
---

# Save an unfinished deployment configuration, creating the draft or replacing it

`PUT /v1/configure-drafts/{draftId}`

## Request

- Base URL: `https://console-api-sandbox.akash.network`
- URL: `https://console-api-sandbox.akash.network/v1/configure-drafts/{draftId}`
- Auth: one of:
  - HTTP bearer
  - API key in header `x-api-key`

A user keeps at most 20 drafts: saving a new one drops the least recently saved. A draft expires 30 days after it was last saved. Secret values never belong in a draft, only the references the SDL carries.

## Path parameters

- `draftId` string, required: The id the client gave the draft when it started the session.

## Headers

- `x-organization-id` string
- `x-project-id` string, uuid

## Request body

- object
  - `data` object, required
    - `sdl` string, required: The SDL being edited, with secret values replaced by their references.
    - `startingSdl` string: The SDL the session started from, which a reset goes back to.
    - `name` string
    - `runtimeLimitHours` integer
    - `inheritSecretsFrom` string: The deployment whose secrets a redeploy carries forward.
    - `placementRegions` object: Regions picked per placement beyond the one the SDL can carry.

## Response `200`

The draft as the account holds it

- object
  - `data` object, required
    - `sdl` string, required: The SDL being edited, with secret values replaced by their references.
    - `startingSdl` string: The SDL the session started from, which a reset goes back to.
    - `name` string
    - `runtimeLimitHours` integer
    - `inheritSecretsFrom` string: The deployment whose secrets a redeploy carries forward.
    - `placementRegions` object: Regions picked per placement beyond the one the SDL can carry.
    - `draftId` string, required
    - `updatedAt` string, date-time, required

## Other responses

- `400`: Invalid draft id or body
- `401`: Unauthorized

## Changes

- **2026-10-15** `bb97e5bacb6f`: 2 info
  - added the new optional `header` request parameter `x-organization-id`
  - added the new optional `header` request parameter `x-project-id`
- **2026-10-07** `3be4c5d057cf`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/akash-network/apis/akash-network-console-api/changes/v1/configure-drafts/:draftId/put.md)

---

[API](https://skmtc.dev/akash-network/apis/akash-network-console-api.md) - [All operations](https://skmtc.dev/akash-network/apis/akash-network-console-api/llms.txt) - [OpenAPI document](https://skmtc.dev/akash-network/apis/akash-network-console-api/revisions/b959efa6d493?raw)