---
title: "Return Phase 1 read-only Workbench readiness contract"
method: GET
path: "/workbench/readiness"
---

# Return Phase 1 read-only Workbench readiness contract

`GET /workbench/readiness`

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

Lists the Workbench readonly API surface and explicitly states that Phase 1 Workbench does not execute platform writes.

## Response `200`

Workbench readonly readiness

- object
  - `schema_version` 'gravityads.hosted_workbench_readiness.v1', required
  - `status` string, required
  - `ready_for_workbench_readonly_v1` boolean, required
  - `phase_contract` 'phase1_workbench_readonly_never_executes_platform_writes', required
  - `required_plan_ids` string[]
  - `read_only_boundary` object, required
    - `writes_platform` false
    - `controlled_execute_enabled_in_phase1` false
    - `execute_requires_phase2_controlled_action_worker` true
  - `endpoint_contract` object
  - `phase2_controlled_actions` object
  - `claude_frontend_handoff` object
  - `raw_secret_values_returned` false, required
  - `raw_customer_ids_returned` false
  - `raw_account_ids_returned` false
  - `platform_write_called` false, required

---

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