OpenAPI specification

OpenAPI specification

The /partner/v1 plane is defined by an OpenAPI 3.0 document — the same file the Geena backend generates its routing from, so the published contract cannot drift from the implementation.

Download partner-v1.yaml

curl -sO https://docs.test.geena.eu/openapi/partner-v1.yaml

Use it to generate a typed client in your stack (openapi-generator, oapi-codegen, openapi-typescript, …) or to import the collection into an API tool. Two conventions worth knowing when reading it:

  • Path ids are documented as UUIDs, but the server deliberately answers malformed ids with the same 404 not_found as foreign ones — do not rely on a 400 for client-side id validation.
  • The OAuth endpoints (/oauth/authorize, /oauth/token, /oauth/revoke, /oauth/step-up) are not part of this document; they are covered in Connect with Geena and Errors & step-up.