---
title: Organization and members
slug: organization-and-members
createdAt: 2026-11-02T08:43:07.427Z
---

## Read the organization tree

```curl
# Organization of the authenticated user
curl 'https://core.fsflt.net/organization/v1' -H 'x-api-key: YOUR_CLOUD_API_KEY'

# Direct children (e.g. dealer → end customers)
curl 'https://core.fsflt.net/organization/v1/children' -H 'x-api-key: YOUR_CLOUD_API_KEY'

# Members
curl 'https://core.fsflt.net/organization/v1/members' -H 'x-api-key: YOUR_CLOUD_API_KEY'
```

```curl
{
  "id": "0199f1c2-76a1-7b21-a758-a1cdab30d590",
  "name": "John Due",
  "timezoneId": "0199f187-7894-76f3-a8e4-4294794cda0e",
  "type": "DEALER"
}
```

<font color="#EF4444">`type`</font> is <font color="#EF4444">`DEALER`</font> for partners and <font color="#EF4444">`END_CUSTOMER`</font> for final customers.

## Create the tenant administrator

```curl
# 1. Available roles
curl 'https://core.fsflt.net/authentication/v1/roles' -H 'x-api-key: YOUR_CLOUD_API_KEY'

# 2. Create the member
curl -X POST 'https://core.fsflt.net/organization/v1/member' \
  -H 'x-api-key: YOUR_CLOUD_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "username": "anna.wright@example.com",
    "name": "Anna Wright",
    "roleId": "0199e375-e27a-7a82-8b8e-84706f381512",
    "organizationId": "019f88ef-7fb5-725c-88e8-0d7028d1b392"
  }'
```

Roles: <font color="#EF4444">`SUPER_ADMIN`</font>, <font color="#EF4444">`ADMIN`</font>, <font color="#EF4444">`EDITOR`</font>, <font color="#EF4444">`POLICY`</font>, <font color="#EF4444">`READ_ONLY`</font>.

| **Method**                            | En**dpo**int                                                      |
| ------------------------------------- | ----------------------------------------------------------------- |
| <font color="#EF4444">`GET`</font>    | <font color="#EF4444">`/organization/v1/member/{memberId}`</font> |
| <font color="#EF4444">`PATCH`</font>  | <font color="#EF4444">`/organization/v1/member/{memberId}`</font> |
| <font color="#EF4444">`DELETE`</font> | <font color="#EF4444">`/organization/v1/member/{memberId}`</font> |

:::hint{type="warning"}
Before creating a member, check <font color="#EF4444">`GET /organization/v1/members`</font> for an existing <font color="#EF4444">`username`</font> to avoid duplicates on retries.
:::