generated: '2026-07-21'
method: searched
source: https://docs.api-swap-os.com/quickstart/environments/
docs:
  - https://docs.api-swap-os.com/quickstart/environments/
  - https://docs.api-swap-os.com/overview/architecture/
versioning:
  scheme: uri-path
  current: v1
  detail: >-
    Operations are path-versioned (v1 across surfaces). TLC serves under
    /tax-duty/v1. The Agentic Storefront Wire session endpoint is
    POST /v1/agents/session/authorize.
environments:
  - name: production
    surfaces:
      agentic_storefront: https://prod-ws-gateway.api-swap-os.com
      global: https://prod-global-server.api-swap-os.com
      protect: https://prod-protect-integrations.api-swap-os.com/protect-integrations/api/v1
      returns: https://api-gateway.swap-os.com/returns-api
      shipping: https://api-gateway.swap-os.com/shipping/v1/public
      tlc: https://prod-tlc.api-swap-os.com/tax-duty/v1
  - name: sandbox
    surfaces:
      agentic_storefront_dev: https://dev-ws-gateway.api-swap-os.com
      agentic_storefront_uat: https://uat-ws-gateway.api-swap-os.com
      shipping: https://sandbox-apigw.swap-os.com/shipping/v1/public
      tlc: https://sandbox-tlc.api-swap-os.com/tax-duty/v1
    note: >-
      Global has no dedicated sandbox hostname today; integration testing uses a
      separate sandbox dashboard account and key against the production Global
      host. Protect sandbox hostnames are issued during onboarding.
deprecation:
  policy_url: null
  sunset_header: false
  note: >-
    No formal deprecation/Sunset policy located in the public docs. Returns and
    Shipping webhooks expose V1/V2 payload versions with V2 recommended for new
    integrations (soft migration path rather than a dated deprecation policy).
status_page:
  url: null
  note: >-
    TLC release notes reference an internal status page ("the status page has
    been updated to cover new services") but no public status-page URL was
    confirmed (swap.statuspage.io resolves to an inactive page).
release_notes: https://docs.api-swap-os.com/products/tlc/release-notes/
changelog_ref: changelog/swap-changelog.yml