---
title: "Pause up to five owner-registered PetCenter tasks using revision checks"
method: POST
path: "/v1/outbound/dispatch-scopes/petcenter/pauses"
---

# Pause up to five owner-registered PetCenter tasks using revision checks

`POST /v1/outbound/dispatch-scopes/petcenter/pauses`

## Request

- Base URL: `https://volai.cz`
- URL: `https://volai.cz/v1/outbound/dispatch-scopes/petcenter/pauses`
- Auth: HTTP bearer

Owner-only pause operation for one to five currently registered PetCenter tasks. Send a stable `operationId`, current manifest SHA, and each task's freshly read revision. The response wraps the operation under `operation`, including the canonical request hash and ordered task inputs. The task revision change and per-task durable outcome are atomic; replaying the same operation is safe, while changing its body conflicts. A revision conflict is reported per task and does not pause that task.

## Request body

- object
  - `operationId` string, required: Stable opaque ID for this durable pause operation. Reuse it unchanged after a timeout; the server stores each task outcome atomically with its task revision change.
  - `manifestSha` string, required: Lowercase SHA-256 digest of the currently registered PetCenter task manifest.
  - `tasks` object[], required: One to five unique task IDs and the exact revisions just read from GET /v1/tasks?ids=.... Only registered PetCenter tasks owned by the campaign account are accepted.
    - `taskId` string, required: Registered task ID whose pause was reviewed.
    - `revision` integer, required: Current revision from a fresh task read; a mismatch is returned as a per-task revision_conflict.

## Response `200`

Durable batch-pause operation

- object
  - `operation` object, nullable, required
    - `operationId` string, required
    - `manifestSha` string, required
    - `requestHash` string, required
    - `tasks` object[], required
      - `taskId` string, required
      - `revision` integer, required
    - `acceptedAt` integer, required
    - `complete` boolean, required
    - `outcomes` object[], required
      - `taskId` string, required
      - `outcome` 'paused' | 'not_running' | 'revision_conflict' | 'not_found', required
      - `revision` integer

## Other responses

- `400`: Error codes: validation (request).
- `401`: Error codes: unauthorized (request).
- `403`: Error codes: account_suspended (account).
- `409`: Error codes: revision_conflict (request).
- `429`: Error codes: rate_limited (busy).
- `500`: Error codes: internal_error (service).

---

[API](https://skmtc.dev/volai/apis/volai-rest-api.md) · [All operations](https://skmtc.dev/volai/apis/volai-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/volai/apis/volai-rest-api/revisions/12029b05e2fa?raw)