Accounts

Change your access over a managed account

Updates the access_level you keep over an account you provisioned.

  • Raising it: only possible while the account is unclaimed. Once its holder has taken ownership you may keep or lower your access, but only they can raise it.
  • Billing: the level never affects it — you pay for the account's subscription at any level.
  • OPERATE: issuing invoices on the holder's behalf additionally requires a signed fiscal representation from them.
  • Entitlement: requires manage_accounts.
patch/v1/accounts/{account_id}/access-level

Request

  • Base URL: https://app.beel.es/api
  • URL: https://app.beel.es/api/v1/accounts/{account_id}/access-level
  • Auth: HTTP bearer

Path parameters

account_idstring uuid required

Identifier (UUID) of an account you manage. An account you do not manage answers exactly like one that does not exist, so its existence is never disclosed.

Request body

access_level'NONE' | 'VIEW' | 'OPERATE' required

How much access an actor has to an account or a company. The same three values are used everywhere access is granted or reported — whether the actor is a member of the account or a provisioner managing it on someone's behalf.

NONE — no access to the data. VIEW — read invoices, customers, products, series and fiscal data. OPERATE — everything in VIEW, plus creating and editing them. Issuing invoices for an account you manage additionally requires a signed fiscal representation from the account holder (see /v1/accounts/{account_id}/companies/{company_id}/representation).

Access level never affects billing: whoever provisioned an account pays for its subscription regardless of the level they keep over it.

Response

Access updated.

Changes

No recorded changes to this operation across all 1 revision of this API.