Archstone Capabilities API

openapi: 3.2.0
info:
  title: Archstone — public API surface Capabilities API
  version: 2.32.1
  description: 'The public, unauthenticated surface of the Archstone console: discovering what a deployment can do, and verifying an OpenAPI document for free. Every operator-, collector-, and platform-scoped route is deliberately absent from this document — and so is the demo tourism search: its contract lives with the demo Worker in a separate repository this document does not control.'
servers:
- url: https://console.archstone.dev
  description: The hosted Archstone console and its control-plane API.
security: []
tags:
- name: Capabilities
paths:
  /api/capabilities:
    get:
      operationId: getCapabilities
      summary: Discover this deployment's feature flags and version
      security: []
      responses:
        '200':
          description: This deployment's version, feature flags, auth mode, and configured limits.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Capabilities'
              example:
                version: 1.1.2
                build: v1.1.2
                features:
                  multi_tenant: false
                  billing: false
                  offline_import: true
                  hosted_runtime: false
                  endpoint_listing: false
                  registry_publishing: false
                notifications:
                  webhook: false
                  smtp: false
                auth:
                  adapter: local
                  kind: credential
                  productionReady: true
                  notice: null
                retention:
                  defaultDays: 90
                  enforcementImplemented: true
                limits:
                  exportMaxRows: 5000
                hosted: null
      tags:
      - Capabilities
components:
  schemas:
    Capabilities:
      type: object
      required:
      - version
      - build
      - features
      - billing
      - notifications
      - auth
      - retention
      - limits
      - hosted
      additionalProperties: false
      properties:
        version:
          type: string
          description: The console/API compatibility handshake version (BR-37) — never a build identifier.
        build:
          type: string
          description: The tag or commit this image was built from.
        features:
          type: object
          required:
          - multi_tenant
          - billing
          - offline_import
          - hosted_runtime
          - endpoint_listing
          - registry_publishing
          additionalProperties: false
          properties:
            multi_tenant:
              type: boolean
            billing:
              type: boolean
            offline_import:
              type: boolean
            hosted_runtime:
              type: boolean
            endpoint_listing:
              type: boolean
              description: True only when both multi_tenant and hosted_runtime are true.
            registry_publishing:
              type: boolean
              description: True only when endpoint_listing is true and a registry signing key is configured and readable at boot.
        billing:
          type: object
          required:
          - methods
          - freePeriod
          additionalProperties: false
          description: Which billing providers this deployment can actually charge through. Distinct from features.billing, which only says whether billing is on at all.
          properties:
            methods:
              type: array
              items:
                type: string
                enum:
                - card
                - crypto
            freePeriod:
              description: 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.
              oneOf:
              - type: 'null'
              - type: object
                required:
                - opensAt
                - graceEndsAt
                additionalProperties: false
                properties:
                  opensAt:
                    type: string
                    description: ISO datetime checkout/downgrade/portal open at.
                  graceEndsAt:
                    type: string
                    description: ISO datetime; opensAt + BILLING_GRACE_DAYS.
        notifications:
          type: object
          required:
          - webhook
          - smtp
          additionalProperties: false
          properties:
            webhook:
              type: boolean
            smtp:
              type: boolean
        auth:
          type: object
          required:
          - adapter
          - kind
          - productionReady
          additionalProperties: false
          properties:
            adapter:
              type: string
            kind:
              type: string
              enum:
              - credential
              - redirect
            productionReady:
              type: boolean
            notice:
              type:
              - string
              - 'null'
        retention:
          type: object
          required:
          - defaultDays
          - enforcementImplemented
          additionalProperties: false
          properties:
            defaultDays:
              type: integer
            enforcementImplemented:
              type: boolean
        limits:
          type: object
          required:
          - exportMaxRows
          additionalProperties: false
          properties:
            exportMaxRows:
              type: integer
        hosted:
          oneOf:
          - type: 'null'
          - type: object
            required:
            - runtimeUrl
            additionalProperties: false
            properties:
              runtimeUrl:
                type: string
        legal:
          description: '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.'
          oneOf:
          - type: 'null'
          - type: object
            required:
            - currentVersions
            - upcoming
            additionalProperties: false
            properties:
              currentVersions:
                type: object
                required:
                - privacy
                - terms
                - dpa
                additionalProperties: false
                properties:
                  privacy:
                    type: string
                  terms:
                    type: string
                  dpa:
                    type: string
              upcoming:
                type: array
                description: Material changes announced and not yet in force; non-material ones are omitted.
                items:
                  type: object
                  required:
                  - document
                  - version
                  - effectiveAt
                  - changeSummary
                  - urgent
                  additionalProperties: false
                  properties:
                    document:
                      type: string
                      enum:
                      - privacy
                      - terms
                      - dpa
                    version:
                      type: string
                    effectiveAt:
                      type: string
                      description: ISO instant (UTC) the version takes effect.
                    changeSummary:
                      type: string
                      description: English, as published.
                    urgent:
                      type: boolean
                      description: True when it takes effect on shorter notice than usual.