---
title: "Discover this deployment's feature flags and version"
method: GET
path: "/api/capabilities"
---

# Discover this deployment's feature flags and version

`GET /api/capabilities`

## Request

- Base URL: `https://console.archstone.dev`
- URL: `https://console.archstone.dev/api/capabilities`
- Auth: none required

## Response `200`

This deployment's version, feature flags, auth mode, and configured limits.

- Capabilities
  - `version` string, required: The console/API compatibility handshake version (BR-37) — never a build identifier.
  - `build` string, required: The tag or commit this image was built from.
  - `features` object, required
    - `multi_tenant` boolean, required
    - `billing` boolean, required
    - `offline_import` boolean, required
    - `hosted_runtime` boolean, required
    - `endpoint_listing` boolean, required: True only when both multi_tenant and hosted_runtime are true.
    - `registry_publishing` boolean, required: True only when endpoint_listing is true and a registry signing key is configured and readable at boot.
  - `billing` object, required: Which billing providers this deployment can actually charge through. Distinct from features.billing, which only says whether billing is on at all.
    - `methods` string[], required
    - `freePeriod` object, nullable, required: Billing is visible and self-serve-choosable before any payment rail is live, gated by this runtime setting rather than compiled in. null when BILLING_PAYMENTS_OPEN_AT is unset — unchanged behavior for a deployment that never sets it.
      - `opensAt` string, required: ISO datetime checkout/downgrade/portal open at.
      - `graceEndsAt` string, required: ISO datetime; opensAt + BILLING_GRACE_DAYS.
  - `notifications` object, required
    - `webhook` boolean, required
    - `smtp` boolean, required
  - `auth` object, required
    - `adapter` string, required
    - `kind` 'credential' | 'redirect', required
    - `productionReady` boolean, required
    - `notice` string, nullable
  - `retention` object, required
    - `defaultDays` integer, required
    - `enforcementImplemented` boolean, required
  - `limits` object, required
    - `exportMaxRows` integer, required
  - `hosted` object, nullable, required
    - `runtimeUrl` string, required
  - `legal` object, nullable: The legal documents' current versions and the material changes announced, decided on the server's clock. null unless this deployment is multi-tenant and every document is published. Additive (1.4.0): absent from a response of an earlier release.
    - `currentVersions` object, required
      - `privacy` string, required
      - `terms` string, required
      - `dpa` string, required
    - `upcoming` object[], required: Material changes announced and not yet in force; non-material ones are omitted.
      - `document` 'privacy' | 'terms' | 'dpa', required
      - `version` string, required
      - `effectiveAt` string, required: ISO instant (UTC) the version takes effect.
      - `changeSummary` string, required: English, as published.
      - `urgent` boolean, required: True when it takes effect on shorter notice than usual.

---

[API](https://skmtc.dev/archstone/apis/archstone-public-api-surface.md) · [All operations](https://skmtc.dev/archstone/apis/archstone-public-api-surface/llms.txt) · [OpenAPI document](https://skmtc.dev/archstone/apis/archstone-public-api-surface/revisions/e485540668e6?raw)