# The /api/public spec names its schemas by their type, not their .NET namespace

- Date: 2026-10-29
- Type: Non-breaking change
- Surface: /api/public
- What you need to do: Nothing.
- Address: https://developers.rivr.io/changelog/2026-10-29-api-public-short-schema-names

The schemas in the /api/public OpenAPI document had their full .NET names, such as `Rivr.PublicApi.Contracts.Orders.CreateOrderRequest`, which made a generated client hard to read. They are now the type's own name, `CreateOrderRequest`, `OrderPublic`, `OrderStatus` and so on. Six names that two layers share keep the layer in front, so both are still there: `DomainAddress` and `PublicApiAddress`, and likewise for `CheckoutHint`, `CheckoutHintType`, `CommonCustomer`, `SettlementInfo` and `SubscriptionPayment`. Nothing in the calls, the answers, the fields or the status codes changes: only the names in `components.schemas` and the `$ref`s that point at them. If you generate a client from the spec, regenerate it and the types get the shorter names. The sandbox has the change since platform release 2026.10.29.2702; production gets it with the platform's next release, and this entry says when.