---
title: "Create Workflow Play Snapshot Bundle Upload"
method: POST
path: "/api/workflow-play-snapshot-bundle-uploads"
tags: ["plays"]
---

# Create Workflow Play Snapshot Bundle Upload

`POST /api/workflow-play-snapshot-bundle-uploads`

## Request

- Base URL: `https://platform.verbiflow.com/api/bridge`
- URL: `https://platform.verbiflow.com/api/bridge/api/workflow-play-snapshot-bundle-uploads`
- 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`

## Request body

- WorkflowPlayBundleUploadRequest: Request a short-lived direct-upload capability for one immutable output bundle.
  - `content_length` integer, required: Exact zip bundle size in bytes.
  - `content_type` 'application/zip' | 'null', nullable: Bundle media type; omission selects application/zip.
  - `local_run_id` string, required: Exact local workflow run id whose outputs are bundled.
  - `sha256` string, required: Lowercase hexadecimal SHA-256 of the exact zip bytes.
  - `workflow_slug` string, required: Stable workflow slug owning the local run.

## Response `200`

Successful Response

- WorkflowPlayBundleUploadResponse: Direct-upload instructions, or a false capability result for multipart fallback.
  - `direct_upload_supported` boolean, required: Whether the object store issued a direct-upload URL.
  - `expires_seconds` integer: Lifetime of the upload URL and signed reference.
  - `headers` object: Exact HTTP headers that must accompany the direct upload.
  - `max_bytes` integer: Maximum accepted output-bundle size in bytes.
  - `method` 'PUT': Required upload HTTP method.
  - `output_bundle_ref` string, nullable: Signed opaque reference supplied to snapshot publication after upload.
  - `upload_url` string, nullable: Short-lived absolute object-store PUT URL.

## 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)