---
title: "Validate hosted connection metadata and optional token health"
method: GET
path: "/connections/{connection_id}/validate"
---

# Validate hosted connection metadata and optional token health

`GET /connections/{connection_id}/validate`

## 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/connections/{connection_id}/validate`
- Auth: HTTP bearer

## Query parameters

- `include_token_health` boolean

## Response `200`

Connection validation

- object
  - `status` 'connection_validation_ready' | 'connection_validation_not_found' | 'connection_validation_unconfigured' | 'connection_validation_degraded', required
  - `source` string
  - `tenant_id` string, required
  - `connection_id` string, required
  - `exists` boolean, required
  - `connection` object
  - `secret_vault_readiness` object
  - `token_runtime_readiness` object
  - `provider_token_health` object
    - `schema_version` string
    - `status` string
    - `provider_api_called` boolean
    - `provider_result` object
      - `ready_for_controlled_write` boolean
      - `controlled_write_scope_count` integer
      - `missing_controlled_write_scope_count` integer
    - `raw_secrets_returned` false
  - `platform_account_count` integer
  - `platform_accounts` object[]
  - `ready_for_readonly_etl` boolean
  - `validation_mode` string
  - `database_url_configured` boolean, required
  - `hosted_auth_context` object
  - `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)