LegalEntitySubAccount

Retrieve all sub-accounts for a specific legal entity.

Retrieves a list of sub-accounts associated with a specific legal entity, identified by its UUID.

SecurityBearer
Request
path Parameters
legalEntityUuid
required
string

The UUID of the legal entity to which the sub-accounts belong.

query Parameters
page
integer
Default: 1

The collection page number

itemsPerPage
integer [ 0 .. 30 ]
Default: 30

The number of items per page

Responses
200

LegalEntitySubAccount collection

403

Forbidden

get/be/legal-entities/{legalEntityUuid}/sub-accounts
Request samples
Response samples
{
  • "hydra:member": [
    ],
  • "hydra:totalItems": 0,
  • "hydra:view": {
    },
  • "hydra:search": {
    }
}

Create a new sub-account for a legal entity.

Creates a new sub-account for a specific legal entity, identified by its UUID. The sub-account will be granted access only to document related to the legal entity.

SecurityBearer
Request
path Parameters
legalEntityUuid
required
string

The UUID of the legal entity to which the sub-account will be associated.

Request Body schema:
required

The new LegalEntitySubAccount resource

email
string <email>

The username of the sub-account. It must be unique within the whole A-Cube platform.

password
string or null

The password for the sub-account. It will be set only if the sub-account is created contextually within the request. If not provided, the user must set it later via the reset password flow.

Responses
201

LegalEntitySubAccount resource created

400

Invalid input

403

Forbidden

422

An error occurred

post/be/legal-entities/{legalEntityUuid}/sub-accounts
Request samples
{
  • "email": "user@example.com",
  • "password": "string"
}
Response samples
{
  • "@context": "string",
  • "@id": "string",
  • "@type": "string",
  • "uuid": "string",
  • "email": "string",
  • "createdAt": "string"
}

Delete a sub-account by email for a specific legal entity.

Deletes a sub-account associated with a specific legal entity, identified by the legal entity UUID and the sub-account email address. This operation will remove the sub-account and revoke its access to documents related to the legal entity.

SecurityBearer
Request
path Parameters
legalEntityUuid
required
string

The UUID of the legal entity to which the sub-account belongs.

email
required
string

The email address of the sub-account to be deleted.

Responses
204

LegalEntitySubAccount resource deleted

403

Forbidden

404

Not found

delete/be/legal-entities/{legalEntityUuid}/sub-accounts/{email}
Request samples
Response samples
{
  • "@context": "string",
  • "@id": "string",
  • "@type": "string",
  • "title": "string",
  • "detail": "string",
  • "status": 404,
  • "instance": "string",
  • "type": "string",
  • "description": "string"
}