---
title: "Set Schedule State Entry"
method: POST
path: "/api/workflow-play/schedule-state/set"
tags: ["schedule-state"]
---

# Set Schedule State Entry

`POST /api/workflow-play/schedule-state/set`

## Request

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

- SetScheduleStateRequest
  - `expected_version` integer, nullable
  - `key` string, required
  - `value` union, required
    - object
    - unknown[]
      - unknown
    - string
    - integer
    - number
    - boolean

## Response `200`

Successful Response

- ScheduleStateWriteResponse
  - `created` boolean, required: Whether this write created the key rather than updating it.
  - `key` string, required: Schedule-owned state key that was written.
  - `version` integer, required: New committed optimistic-concurrency version.

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