---
title: "Load Workflow Play State V2"
method: POST
path: "/api/workflow-play/state/load"
tags: ["workflow-play-state"]
---

# Load Workflow Play State V2

`POST /api/workflow-play/state/load`

## Request

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

- LoadStateRequest: Body-owned state selection; subject batches must never live in a URL.
  - `cursor` string, nullable: Opaque continuation cursor from the previous state page.
  - `include_deleted` boolean: Include durable tombstones in the returned state page.
  - `limit` integer: Maximum state entries returned in one page.
  - `namespace` string, required: Revision-defined durable state namespace.
  - `subject_prefix` string, nullable: Optional subject-key prefix scan; mutually exclusive with exact subjects.
  - `subjects` string[], nullable: Exact subject keys to load; mutually exclusive with prefix and cursor.

## Response `200`

Successful Response

- WorkflowStatePageResponse: Committed durable state page and its exact lineage.
  - `entries` WorkflowStateEntryResponse[], required: Requested page of subject values and tombstones.
    - `is_deleted` boolean, required: Whether this entry is a durable tombstone.
    - `namespace` string, required: Revision-defined durable state namespace.
    - `observed_at` string, nullable, required: ISO 8601 source observation time when provided.
    - `provenance` object, required: Revision-defined source evidence retained with the value.
    - `subject_key` string, required: Revision-defined identity within the namespace.
    - `subject_version` integer, required: Monotonic version of this subject.
    - `updated_commit_id` string, required: Commit id that last changed this subject.
    - `updated_generation` integer, required: Committed namespace generation that last changed this subject.
    - `updated_run_id` string, required: Workflow run id that last changed this subject.
    - `updated_tick_id` string, required: Occurrence id that last changed this subject.
    - `value` object, nullable, required: Revision-owned state value, or null for a tombstone.
    - `value_digest` string, nullable, required: Canonical digest of value, or null for a tombstone.
  - `generation` integer, required: Current committed namespace generation.
  - `next_cursor` string, nullable, required: Opaque cursor for the next page, or null when this page is terminal.
  - `schema_digest` string, nullable, required: Current revision-owned schema digest, or null before first commit.
  - `state_digest` string, required: Canonical digest of the complete committed state.

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