Clients

A client is a registry tenant. Most consumers do not create clients themselves; they receive a client_id from the platform team and use it in tenant-scoped routes.

/v2/clients/{client_id}/domains

When clients matter

You need the client concept whenever you call domain or service routes. The client_id path segment determines:

• Which tenant’s domains and services are addressed.
• Which Cognito group or machine-client claim is required.
• Which records are visible to list and get operations.

Client lifecycle

Client management is an administrative operation. A typical integrator only needs to know whether their assigned client is active and which domain ids belong to it.

If you receive a 404 for a domain route, first confirm that both the client_id and domain_id are correct for the environment you are calling.