Skip to main content

Admin endpoints — clients & brands

Manages the client / brand tenant records that anchor every other resource in the platform. Auth: Entra ID JWT bearer with the ADMIN role. The formal schema is on the API Reference.

MethodPathCodeDoes
GET/v1/admin/clients200List all clients/brands
PUT/v1/admin/clients/{slug}200Create or update a client/brand, keyed by slug

Notes for operators​

  • Create vs update. A PUT to a new slug creates the record; the clientId and brandId are generated server-side and cannot be supplied in the body. A PUT to an existing slug updates it — only clientStatus and brandStatus can change; clientId, brandId, and slug are immutable once created.
  • Statuses are ACTIVE, SUSPENDED, or INACTIVE.
  • This is the first configuration step for a tenant — products, external-application mappings, and routing policies all reference an existing client slug.