---
title: "Choose which platform accounts are enabled under the current plan"
method: POST
path: "/tenant/plan-account-selection"
---

# Choose which platform accounts are enabled under the current plan

`POST /tenant/plan-account-selection`

## 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/tenant/plan-account-selection`
- Auth: HTTP bearer

## Request body

- object
  - `active_platform_account_ids` string[], required: Platform account row IDs to keep active under the current plan.
  - `active_user_ids` string[]: Optional exact active-user selection. When present, account, user, scope, and ETL assignments are reconciled together.
  - `expected_pool_revision` integer
  - `expected_pool_contract_token` string
  - `request_key` string
  - `confirm_archive` boolean

## Response `200`

Tenant plan account selection updated

- object
  - `status` 'tenant_plan_account_selection_ready' | 'tenant_plan_account_selection_updated' | 'tenant_plan_account_selection_unconfigured' | 'tenant_plan_account_selection_failed' | 'tenant_plan_account_selection_degraded', required
  - `tenant_id` string, required
  - `plan_id` string
  - `plan_account_limit` object, required
  - `platform_account_count` integer, required
  - `platform_accounts` object[], required
  - `active_platform_account_ids` string[], required
  - `selected_platform_account_count` integer
  - `plan_user_limit` object
  - `users` object[]
  - `active_user_ids` string[]
  - `selected_user_count` integer
  - `ai_readiness_summary` object
  - `requested_active_platform_account_count` integer
  - `activated_account_count` integer
  - `over_limited_account_count` integer
  - `reconciliation_summary` object
  - `database_url_configured` boolean
  - `raw_secrets_returned` 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)