---
title: "Set Campaign Play State"
method: POST
path: "/campaigns/plays/{play_key}/state"
tags: ["campaigns"]
---

# Set Campaign Play State

`POST /campaigns/plays/{play_key}/state`

Pause, resume or disable an automated campaign for this org.

Pausing stops the planner evaluating it AND the dispatcher holds every queued
action for the play (re-checked fresh per action). Stopping disables the play
and closes its in-flight wave campaigns, so nothing keeps sending afterwards.

## Path parameters

- `play_key` string, required

## Request body

- SetPlayStateRequest — pause / resume keep the config; stop disables the automated campaign.
  - `action` 'pause' | 'resume' | 'stop', required

## Response `200`

Successful Response

- unknown

## Other responses

- `404` — Not found
- `422` — Validation Error

---

[API](https://skmtc.dev/noso/apis/crucible-backend-api.md) · [All operations](https://skmtc.dev/noso/apis/crucible-backend-api/llms.txt) · [OpenAPI document](https://skmtc.dev/noso/apis/crucible-backend-api/revisions/8eb1d6b3ce25?raw)