---
title: "Feature-flag onboarding live-signal status (TBP-205)"
method: GET
path: "/v1/admin/flags/onboarding/status"
tags: ["admin"]
---

# Feature-flag onboarding live-signal status (TBP-205)

`GET /v1/admin/flags/onboarding/status`

## Request

- Base URL: `https://api.thebridge.dev` (the document declares no server; this is the origin it was published from)
- URL: `https://api.thebridge.dev/v1/admin/flags/onboarding/status`
- Auth: none declared

Returns per-signal detection state for the FF onboarding wizard. Polled every 5–7s by `/onboarding/flags` while the user is integrating.

## Response `200`

- FlagOnboardingStatusDto
  - `appId` string, required: The app this status snapshot belongs to.
  - `signals` OnboardingSignals, required
    - `sdk_initialized` OnboardingSignalState, required
      - `detected` boolean, required: True once the signal has been observed at least once for this app. Sticky — never flips back to false.
      - `lastSeenAt` number, nullable: Most recent observation time in epoch milliseconds. Present when detected = true.
      - `count` number, nullable: Total rows in the backing collection scoped to this app. Lets the UI render "3 flags discovered" / "42 evals received". Optional and signal-specific.
    - `flag_discovered` OnboardingSignalState, required
      - `detected` boolean, required: True once the signal has been observed at least once for this app. Sticky — never flips back to false.
      - `lastSeenAt` number, nullable: Most recent observation time in epoch milliseconds. Present when detected = true.
      - `count` number, nullable: Total rows in the backing collection scoped to this app. Lets the UI render "3 flags discovered" / "42 evals received". Optional and signal-specific.
    - `eval_received` OnboardingSignalState, required
      - `detected` boolean, required: True once the signal has been observed at least once for this app. Sticky — never flips back to false.
      - `lastSeenAt` number, nullable: Most recent observation time in epoch milliseconds. Present when detected = true.
      - `count` number, nullable: Total rows in the backing collection scoped to this app. Lets the UI render "3 flags discovered" / "42 evals received". Optional and signal-specific.
    - `attribute_seen` OnboardingSignalState, required
      - `detected` boolean, required: True once the signal has been observed at least once for this app. Sticky — never flips back to false.
      - `lastSeenAt` number, nullable: Most recent observation time in epoch milliseconds. Present when detected = true.
      - `count` number, nullable: Total rows in the backing collection scoped to this app. Lets the UI render "3 flags discovered" / "42 evals received". Optional and signal-specific.
    - `flag_activated` OnboardingSignalState, required
      - `detected` boolean, required: True once the signal has been observed at least once for this app. Sticky — never flips back to false.
      - `lastSeenAt` number, nullable: Most recent observation time in epoch milliseconds. Present when detected = true.
      - `count` number, nullable: Total rows in the backing collection scoped to this app. Lets the UI render "3 flags discovered" / "42 evals received". Optional and signal-specific.

---

[API](https://skmtc.dev/thebridge/apis/bridge-api.md) · [All operations](https://skmtc.dev/thebridge/apis/bridge-api/llms.txt) · [OpenAPI document](https://skmtc.dev/thebridge/apis/bridge-api/revisions/290fffcb3d80?raw)