---
title: "Deploy draft release"
method: POST
path: "/orchestration/releases/draft/deploy"
tags: ["Orchestration - Releases"]
---

# Deploy draft release

`POST /orchestration/releases/draft/deploy`

Deploy a draft release

## Request body

- object — Request body schema.
  - `workflowUuid` string, uuid, required
  - `version` string
  - `description` string
  - `nodes` union[], required
    - union
      - object
        - `uuid` string, uuid, required
        - `slug` string, required
        - `name` string
        - `config` object, required
        - `description` string
        - `retry` object
          - `maximumAttempts` number
          - `initialInterval` number
          - `backoffCoefficient` number
        - `childrenUuids` string[], required
        - `fallbackChildUuid` string
        - `fallbackOnFailure` boolean, required
        - `position` object, required
          - `x` number, required
          - `y` number, required
        - `kind` 'native', required
        - `actionSlug` string, required
      - object
        - `uuid` string, uuid, required
        - `slug` string, required
        - `name` string
        - `config` object, required
        - `description` string
        - `retry` object
          - `maximumAttempts` number
          - `initialInterval` number
          - `backoffCoefficient` number
        - `childrenUuids` string[], required
        - `fallbackChildUuid` string
        - `fallbackOnFailure` boolean, required
        - `position` object, required
          - `x` number, required
          - `y` number, required
        - `kind` 'connector', required
        - `connectorUuid` string
        - `integrationSlug` string, required
        - `actionSlug` string, required
      - object
        - `uuid` string, uuid, required
        - `slug` string, required
        - `name` string
        - `config` object, required
        - `description` string
        - `retry` object
          - `maximumAttempts` number
          - `initialInterval` number
          - `backoffCoefficient` number
        - `childrenUuids` string[], required
        - `fallbackChildUuid` string
        - `fallbackOnFailure` boolean, required
        - `position` object, required
          - `x` number, required
          - `y` number, required
        - `kind` 'tool', required
        - `toolUuid` string
        - `templateSlug` string
        - `releaseUuid` string
        - `waitUntilFinished` boolean
      - object
        - `uuid` string, uuid, required
        - `slug` string, required
        - `name` string
        - `config` object, required
        - `description` string
        - `retry` object
          - `maximumAttempts` number
          - `initialInterval` number
          - `backoffCoefficient` number
        - `childrenUuids` string[], required
        - `fallbackChildUuid` string
        - `fallbackOnFailure` boolean, required
        - `position` object, required
          - `x` number, required
          - `y` number, required
        - `kind` 'agent', required
        - `agentUuid` string
        - `templateSlug` string
        - `releaseUuid` string
        - `waitUntilFinished` boolean
  - `formFields` union[], nullable, required
    - union
      - object
        - `slug` string, required
        - `name` string, required
        - `description` string
        - `placeholder` string
        - `isRequired` boolean
        - `kind` 'string' | 'number' | 'boolean' | 'date' | 'any', required
      - object
        - `slug` string, required
        - `name` string, required
        - `description` string
        - `placeholder` string
        - `isRequired` boolean
        - `kind` 'enum', required
        - `enum` string[], required
      - object
        - `slug` string, required
        - `name` string, required
        - `description` string
        - `placeholder` string
        - `isRequired` boolean
        - `kind` 'array', required
        - `fields` union[], required
          - union
            - object
              - …
            - object
              - …
            - object
              - …
  - `options` object
    - `connectorUuidsByIntegrationSlug` object
    - `modelUuidsByIntegrationSlug` object

## Response `200`

Successful response

- object
  - `release` object, required
    - `uuid` string, required
    - `parentUuid` string, nullable, required
    - `workspaceUuid` string, required
    - `userUuid` string, required
    - `workflowUuid` string, required
    - `description` string, nullable, required
    - `version` string, nullable, required
    - `status` 'draft' | 'deployed' | 'archived', required
    - `templateSlug` string, nullable, required
    - `nodes` union[], required
      - union
        - object
          - `uuid` string, uuid, required
          - `slug` string, required
          - `name` string
          - `config` object, required
          - `description` string
          - `retry` object
            - `maximumAttempts` number
            - `initialInterval` number
            - `backoffCoefficient` number
          - `childrenUuids` string[], required
          - `fallbackChildUuid` string
          - `fallbackOnFailure` boolean, required
          - `position` object, required
            - `x` number, required
            - `y` number, required
          - `kind` 'native', required
          - `actionSlug` string, required
        - object
          - `uuid` string, uuid, required
          - `slug` string, required
          - `name` string
          - `config` object, required
          - `description` string
          - `retry` object
            - `maximumAttempts` number
            - `initialInterval` number
            - `backoffCoefficient` number
          - `childrenUuids` string[], required
          - `fallbackChildUuid` string
          - `fallbackOnFailure` boolean, required
          - `position` object, required
            - `x` number, required
            - `y` number, required
          - `kind` 'connector', required
          - `connectorUuid` string
          - `integrationSlug` string, required
          - `actionSlug` string, required
        - object
          - `uuid` string, uuid, required
          - `slug` string, required
          - `name` string
          - `config` object, required
          - `description` string
          - `retry` object
            - `maximumAttempts` number
            - `initialInterval` number
            - `backoffCoefficient` number
          - `childrenUuids` string[], required
          - `fallbackChildUuid` string
          - `fallbackOnFailure` boolean, required
          - `position` object, required
            - `x` number, required
            - `y` number, required
          - `kind` 'tool', required
          - `toolUuid` string
          - `templateSlug` string
          - `releaseUuid` string
          - `waitUntilFinished` boolean
        - object
          - `uuid` string, uuid, required
          - `slug` string, required
          - `name` string
          - `config` object, required
          - `description` string
          - `retry` object
            - `maximumAttempts` number
            - `initialInterval` number
            - `backoffCoefficient` number
          - `childrenUuids` string[], required
          - `fallbackChildUuid` string
          - `fallbackOnFailure` boolean, required
          - `position` object, required
            - `x` number, required
            - `y` number, required
          - `kind` 'agent', required
          - `agentUuid` string
          - `templateSlug` string
          - `releaseUuid` string
          - `waitUntilFinished` boolean
    - `formFields` union[], nullable, required
      - union
        - object
          - `slug` string, required
          - `name` string, required
          - `description` string
          - `placeholder` string
          - `isRequired` boolean
          - `kind` 'string' | 'number' | 'boolean' | 'date' | 'any', required
        - object
          - `slug` string, required
          - `name` string, required
          - `description` string
          - `placeholder` string
          - `isRequired` boolean
          - `kind` 'enum', required
          - `enum` string[], required
        - object
          - `slug` string, required
          - `name` string, required
          - `description` string
          - `placeholder` string
          - `isRequired` boolean
          - `kind` 'array', required
          - `fields` union[], required
            - union
              - …
    - `testRecords` union[], required
      - union
        - object
          - `kind` 'id', required
          - `id` string, required
          - `data` object
        - object
          - `kind` 'data', required
          - `data` object, required
    - `deployedAt` string, nullable, required
    - `createdAt` string, required
    - `updatedAt` string, required
    - `deletedAt` string, nullable, required

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `404` — Not found
- `500` — Internal server error

---

[API](https://skmtc.net/getcargo/apis/cargo-api.md) · [All operations](https://skmtc.net/getcargo/apis/cargo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/getcargo/cargo-api/revisions/1d5a19e01d83/schema)