Files
Maxence Maireaux 792130ed23 feat: centralize OpenAPI spec management with Speakeasy Registry
Remove NoAuthorization security scheme from base.yaml and add a shared
overlay to clean up the merged spec (remove requestBody on GET/HEAD,
fix /versions security). Publish the overlaid spec to the Speakeasy
Registry via a new workflow job so all SDK repos consume a single
corrected source.
2026-03-16 12:38:53 +01:00

93 lines
2.1 KiB
YAML

openapi: 3.0.3
info:
title: Formance Stack API
description: |
Open, modular foundation for unique payments flows
# Introduction
This API is documented in **OpenAPI format**.
# Authentication
Formance Stack offers one forms of authentication:
- OAuth2
OAuth2 - an open protocol to allow secure authorization in a simple
and standard method from web, mobile and desktop applications.
<SecurityDefinitions />
contact:
name: Formance
url: https://www.formance.com
email: [email protected]
x-logo:
url: https://avatars.githubusercontent.com/u/84325077?s=200&v=4
altText: Formance
version: "SDK_VERSION"
servers:
- url: http://localhost
description: local server
- url: https://{organization}.{environment}.formance.cloud
description: A per-organization and per-environment API
variables:
organization:
description: The organization name. Defaults to a generic organization.
default: orgID-stackID
environment:
description: The environment name. Defaults to the production environment.
default: eu.sandbox
enum:
- eu.sandbox
- eu-west-1
- us-east-1
tags:
- name: ledger.v1
- name: ledger.v2
- name: payments.v1
- name: payments.v3
- name: auth.v1
- name: orchestration.v1
- name: orchestration.v2
- name: reconciliation.v1
- name: search.v1
- name: webhooks.v1
- name: wallets.v1
components:
securitySchemes:
Authorization:
type: oauth2
flows:
clientCredentials:
tokenUrl: "/api/auth/oauth/token"
refreshUrl: "/api/auth/oauth/token"
scopes: {}
x-tagGroups:
- name: Auth
tags:
- auth.v1
- name: Ledger
tags:
- ledger.v1
- ledger.v2
- name: Payments
tags:
- payments.v1
- payments.v3
- name: Search
tags:
- search.v1
- name: Wallets
tags:
- wallets.v1
- name: Webhooks
tags:
- webhooks.v1
- name: Flows
tags:
- orchestration.v1
- orchestration.v2
- name: Reconciliation
tags:
- reconciliation.v1