---
title: "Read-only optimizer workflow: start_or_resume"
method: POST
path: "/workflow/start_or_resume"
---

# Read-only optimizer workflow: start_or_resume

`POST /workflow/start_or_resume`

## Request

- Base URL: `https://api.gravityads.dev` (the document declares no server; this is the origin it was published from)
- URL: `https://api.gravityads.dev/workflow/start_or_resume`
- Auth: HTTP bearer

## Request body

- object
  - `brief_ref` Local7BusinessReference
    - `run_id` string, required
    - `revision` integer, required
  - `report_thresholds` object, nullable
  - `report_options` Local7ReportOptions
    - `timezone` string
    - `aggregation_method` 'daily_arithmetic_mean' | 'pooled_ratio'
    - `baseline_includes_target` boolean
    - `period_kind` 'natural_week' | 'custom_period'
  - `intent` string, required
  - `platform` string, required
  - `account_id` string, required
  - `date_start` string, required
  - `date_end` string, required
  - `request_key` string, required
  - `locale` string

## Response `200`

Authorized workflow state; no platform writes

- object

## Other responses

- `400`: Invalid workflow request
- `403`: Access denied

---

[API](https://skmtc.dev/gravityads/apis/gravityads-api.md) · [All operations](https://skmtc.dev/gravityads/apis/gravityads-api/llms.txt) · [OpenAPI document](https://skmtc.dev/gravityads/apis/gravityads-api/revisions/124cd07d534d?raw)