Skip to main content

Partially update a client account

Path Parameters
idstringrequired

The account's unique identifier

Parameters
namestring

The account name.


beneficiarystring

The account beneficiary. Leading and trailing spaces are removed.


bundle_portfolio_idstring

The bundle portfolio unique identifier.


handlestring^[a-z0-9-_]+$

handle is a client defined URL-friendly string that identifies the account.

The handle is unique per organisation and account type.

Returns

Returns: ClientAccount object

idstringrequired

The Account's unique identifier


namestringrequired

The Account's name


organisation_idstringrequired

The unique identifier of the organisation this account belongs to


handlestring^[a-z0-9-_]+$required

handle is a client defined URL-friendly string that identifies the account.

The handle is unique per organisation and account type.


currencystringrequired

The Account's currency


typeenumrequired

The account's type.

Enum:
  • live
  • test

logostringrequired

The account logo


beneficiarystringrequired

Retirement beneficiary

This is the name that appears on future retirements that are made in this account. If none is present, the organisation beneficiary will be used instead.


bundle_portfolio_idstringrequired

Bundle portfolio id tied to the account.

  • PATCH /accounts/client/{id}
  • curl 'https://api.lune.co/v1/accounts/client/ljmkOq7vXd239gAE9WALWQ8ZGVD5ExNz' \
      -H 'Authorization: Bearer <API_KEY>' \
      -H 'Content-Type: application/json' \
      -X PATCH \
      -d '{
        "name": "ACME",
        "beneficiary": "ACME Inc"
      }'
      
  • Response
  • {
      "id": "ljmkOq7vXd239gAE9WALWQ8ZGVD5ExNz",
      "name": "ACME",
      "beneficiary": "ACME Inc",
      "currency": "USD",
      "type": "live",
      "organisation_id": "VndoQ0PZjGMzvYOZGwqy6kbgN1eOJx9B",
      "logo": null,
      "bundle_portfolio_id": null
    }