---
title: "WorkflowClient.deploy_release"
description: "Deploy a workflow release to one or more clusters."
image: "https://tilebox.com/images/tilebox-docs-social-preview.png"
---

> Documentation Index
> Fetch the complete documentation index at: https://tilebox.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# WorkflowClient.deploy_release

import { Fragment } from "astro/jsx-runtime";

import ApiReference from "@docs/components/ApiReference.astro";

import ParamField from "@docs/components/ParamField.astro";

```python
def WorkflowClient.deploy_release(
    workflow_or_slug: Workflow | str,
    release_or_id: WorkflowRelease | UUID | str,
    clusters: Cluster | str | list[Cluster | str] | None = None,
) -> WorkflowReleaseDeployment
```

Deploy a workflow release to one or more clusters.

## Parameters

**workflow_or_slug**

type: Workflow | str

required: true

The workflow or workflow slug containing the release to deploy.
**release_or_id**

type: WorkflowRelease | UUID | str

required: true

The workflow release or release ID to deploy.
**clusters**

type: Cluster | str | list[Cluster | str] | None

The cluster or clusters to deploy the release to. If omitted, the API uses the default cluster.

## Returns

The deployment result, including the release and affected clusters.

<h2 id="request-example">Usage example</h2>

```python
deployment = workflow_client.deploy_release(
    workflow,
    release.id,
    clusters="production",
)
```

Source: https://tilebox.com/docs/api-reference/python/tilebox.workflows/WorkflowClient.deploy_release/index.mdx