---
title: "Promote Workflow"
method: POST
path: "/v1/agents/{agent_id}/workflow/promote"
tags: ["Agent Workflow"]
---

# Promote Workflow

`POST /v1/agents/{agent_id}/workflow/promote`

Promote versions into a higher environment (DFCX, Bland).

Gated behind :func:`require_promote_permission`. On DFCX this deploys flow versions only (there
is no deploy-playbook primitive); on Bland it publishes one pathway version to staging or
production. Both providers record the deployment upstream; we log the Bluejay actor for audit.

## Path parameters

- `agent_id` string, required

## Headers

- `X-API-Key` string, required

## Request body

- PromoteRequest
  - `environment_name` string, required — DFCX environment resource name (…/environments/{id}), or 'production' / 'staging' for Bland
  - `flow_version_names` string[], required — Versions to deploy: DFCX flow version resource names, or one Bland version number

## Response `200`

Successful Response

- object

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/getbluejay/apis/bluejay-api.md) · [All operations](https://skmtc.net/getbluejay/apis/bluejay-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/getbluejay/bluejay-api/versions/f48cef80963f/schema)