---
title: "Transfer Workflow Play"
method: POST
path: "/api/workflow-plays/{play_id}/transfer"
tags: ["plays"]
---

# Transfer Workflow Play

`POST /api/workflow-plays/{play_id}/transfer`

## Request

- Base URL: `https://platform.verbiflow.com/api/bridge`
- URL: `https://platform.verbiflow.com/api/bridge/api/workflow-plays/{play_id}/transfer`
- Auth: one of:
  - HTTP bearer and API key in header `x-flage-org-id`
  - HTTP bearer and API key in header `x-flage-org-slug`

Move a workflow play (and every credit row tagged with its play_id) from
the authenticated workspace to ``target_org_id``.

The caller must be a member of both the source workspace (`auth.org_id`,
which currently owns the play) and the target workspace. Updates run in a
single transaction across `workflow_plays` (FKs cascade to runs/sync/actions/
approvals/events) and the four credit ledger tables that carry play_id as a
free-text tag.

## Path parameters

- `play_id` string, required

## Request body

- WorkflowPlayTransferRequest: Destination workspace for an atomic Play ownership transfer.
  - `target_org_id` string, required: Workspace UUID or slug in which the caller is also a member.

## Response `200`

Successful Response

- WorkflowPlayTransferResponse: Receipt for an atomic Play and credit-ledger workspace transfer.
  - `play_id` string, required: Canonical Play id that moved workspaces.
  - `rows_updated` WorkflowPlayTransferRowsUpdated, required: Exact row counts from every table moved by the atomic workspace transfer.
    - `enrichment_credit_reservations` integer, required: Open or historical enrichment credit reservations moved.
    - `enrichment_execution_credit_ledger` integer, required: Enrichment-execution credit ledger rows moved.
    - `growth_mcp_capability_usage_events` integer, required: Capability-usage event rows moved.
    - `source_execution_credit_ledger` integer, required: Source-execution credit ledger rows moved.
    - `workflow_plays` integer, required: Canonical Play rows moved; always one.
  - `source_org_id` string, required: Workspace UUID that previously owned the Play.
  - `target_org_id` string, required: Workspace UUID that now owns the Play.

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/verbiflow/apis/verbiflow-sdk-http-contract.md) - [All operations](https://skmtc.dev/verbiflow/apis/verbiflow-sdk-http-contract/llms.txt) - [OpenAPI document](https://skmtc.dev/verbiflow/apis/verbiflow-sdk-http-contract/revisions/c80e903ef8f3?raw)