# Clients

A client is the top-level organizational entity in Aleta — typically
a customer of the platform's user. Clients can own legal entities,
reporting entities, and child clients.

## Endpoints

GET /v2/clients
  Fetch all clients.

POST /v2/clients
  Create a new client. Set the `parent` relationship to nest under an
  existing client; omit it for a top-level client.

GET /v2/clients/:id
  Fetch a specific client.

PATCH /v2/clients/:id
  Update a client's mutable attributes (currently only `name`).

DELETE /v2/clients/:id
  Delete a client.

## Attributes (`type: client`)

  name (string, required) — Display name of the client.

## Relationships

  parent             — The parent client that owns this one. null for top-level clients.
  children           — Clients owned by this client.
  legalEntities      — Legal entities owned by this client.
  reportingEntities  — Reporting entities owned by this client.