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

# Read-only optimizer workflow: scope_save

`POST /workflow/scope_save`

## 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/scope_save`
- Auth: HTTP bearer

## Request body

- object
  - `scope_name` string, required
  - `definition` Local5ScopeDefinition, required
    - `query` string
    - `match_query` boolean
    - `platform` string
    - `include` Local5AccountIdentity[]
      - `platform` string, required
      - `account_id` string, required
    - `exclude` Local5AccountIdentity[]
      - `platform` string, required
      - `account_id` string, required
  - `request_key` string, required

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