Skip to main content
GET
Get Active Server Ids

Authorizations

Authorization
string
header
required

A Barndoor API key, sent as Authorization: Bearer <key>. Keys are prefixed bdai_ and are opaque — do not attempt to decode one. Interchangeable with an OAuth 2.0 access token.

Query Parameters

availability_status
boolean | null

When omitted, returns all alive (non-soft-deleted) server IDs for the org (local servers only per include_local). True returns only available servers (with the publishing flag on — BCP-3039 — published AND still operationally sound; else operationally available); False returns the complement. Uncapped — no pagination.

audience_scoped
boolean
default:false

BCP-3735: restrict the returned IDs to servers this user may discover — published AND named by an active allow rule on one of the server's ACTIVE policies (same semantics as GET /servers?audience_scoped=true). Opt-in: the default keeps existing callers (audit-history deleted tagging, dashboard denominators) seeing every server the include_local gate allows. Fails closed with HTTP 503 when the visible set cannot be resolved.

include_local
boolean | null

BCP-4300: allow servers that run locally through the Barndoor CLI (embedded and local catalogs). Omitted, the registry resolves it from the org's local-cli-mcp-tooling flag (fail-closed); an explicit value is always honoured. An excluded server is left out of the result, and a single-server read of one returns 404.

Response

Successful Response

Uncapped list of entity IDs for an org (single response, no pagination).

ids
string[]