Tenant

Tenant

List tenants

get

Listing all tenant the user has access to.

Required permission: TENANT.ACCESS

Authorizations

accessTokenauthTokenintegrationToken

Query parameters

pageNumberintegeroptional

Reference to a specific page in a result set.

pageSizeintegeroptional

The number of items per page in a result set.

sortBystringoptional

Defines which field the resource list is sorted by.

sortDirectionstring · enumoptional

ENUM	Description
ASC	Sort in ascending order
DESC	Sort in descending order

Available options:

Responses

application/json

objectoptional

get

HTTPcURLJavaScriptPython

GET /v2/tenants HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

Example response

{
  "items": [
    {
      "countryCode": "text",
      "createdAt": "2025-04-18T00:56:27.456Z",
      "lastModifiedAt": "2025-04-18T00:56:27.456Z",
      "name": "text",
      "pricelistUid": "text",
      "tenantUid": "text",
      "vatNumber": "text",
      "settings": {
        "allowExternalCashDrawer": true,
        "autoLogout": 1,
        "autoPrintReceipt": true,
        "numericSkuCounter": 1,
        "printCardPaymentDetails": true,
        "sendInvoicesExternally": true
      },
      "appSettings": {
        "showOutOfStockWarning": true
      },
      "extensions": [
        {
          "extensionCode": "FLOWGIFTCARD",
          "name": "text",
          "active": true
        }
      ],
      "assets": {
        "logo": {
          "url": "text",
          "assetUid": "text"
        },
        "splash": {
          "url": "text",
          "assetUid": "text"
        }
      },
      "timezone": "text",
      "languageCode": "text",
      "currency": {
        "code": "text",
        "name": "text",
        "symbol": "text",
        "symbolPosition": "text",
        "decimalSeparator": "text",
        "thousandSeparator": "text",
        "cashRounding": 1
      }
    }
  ],
  "paging": {
    "pageNumber": 1,
    "pageSize": 1,
    "totalCount": 1
  }
}

Get tenant details

get

Internal endpoint for details for a tenant.

Required permission: TENANT.ACCESS

Authorizations

accessTokenauthTokenintegrationToken

Path parameters

tenantUidstringrequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+

Responses

application/json

objectoptional

application/json

get

HTTPcURLJavaScriptPython

GET /v2/tenants/{tenantUid} HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "countryCode": "text",
  "createdAt": "2025-04-18T00:56:27.456Z",
  "lastModifiedAt": "2025-04-18T00:56:27.456Z",
  "name": "text",
  "pricelistUid": "text",
  "tenantUid": "text",
  "vatNumber": "text",
  "settings": {
    "allowExternalCashDrawer": true,
    "autoLogout": 1,
    "autoPrintReceipt": true,
    "numericSkuCounter": 1,
    "printCardPaymentDetails": true,
    "sendInvoicesExternally": true
  },
  "appSettings": {
    "showOutOfStockWarning": true
  },
  "extensions": [
    {
      "extensionCode": "FLOWGIFTCARD",
      "name": "text",
      "active": true
    }
  ],
  "assets": {
    "logo": {
      "url": "text",
      "assetUid": "text"
    },
    "splash": {
      "url": "text",
      "assetUid": "text"
    }
  },
  "timezone": "text",
  "languageCode": "text",
  "currency": {
    "code": "text",
    "name": "text",
    "symbol": "text",
    "symbolPosition": "text",
    "decimalSeparator": "text",
    "thousandSeparator": "text",
    "cashRounding": 1
  }
}

Update tenant details

put

Required permission: TENANT ADMIN

Authorizations

accessTokenauthTokenintegrationToken

Path parameters

tenantUidstringrequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+

Body

namestringoptional

pricelistUidstringoptionalPattern: ^[A-Za-z0-9-_]*

vatNumberstringoptional

VAT identification number for value added tax reporting purposes.

allowExternalCashDrawerbooleanoptionalDefault: false

autoLogoutintegeroptional

time in seconds, 0 means not enabled

Default: 0

autoPrintReceiptbooleanoptional

showOutOfStockWarningbooleanoptional

logoAssetUidstringoptionalPattern: ^[A-Za-z0-9-_]*

splashAssetUidstringoptionalPattern: ^[A-Za-z0-9-_]*

timezonestringoptional

The timezone in tz/zoneinfo format. Example: Europe/Oslo

numericSkuCounterintegeroptional

languageCodestringoptional

ISO 639-1 code for language

printCardPaymentDetailsbooleanoptional

toogle on/off payment terminal details on receipt

sendInvoicesExternallybooleanoptional

Responses

application/json

objectoptional

put

HTTPcURLJavaScriptPython

PUT /v2/tenants/{tenantUid} HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 324

{
  "name": "text",
  "pricelistUid": "text",
  "vatNumber": "text",
  "allowExternalCashDrawer": true,
  "autoLogout": 1,
  "autoPrintReceipt": true,
  "showOutOfStockWarning": true,
  "logoAssetUid": "text",
  "splashAssetUid": "text",
  "timezone": "text",
  "numericSkuCounter": 1,
  "languageCode": "text",
  "printCardPaymentDetails": true,
  "sendInvoicesExternally": true
}

200

Example response

{
  "countryCode": "text",
  "createdAt": "2025-04-18T00:56:27.456Z",
  "lastModifiedAt": "2025-04-18T00:56:27.456Z",
  "name": "text",
  "pricelistUid": "text",
  "tenantUid": "text",
  "vatNumber": "text",
  "settings": {
    "allowExternalCashDrawer": true,
    "autoLogout": 1,
    "autoPrintReceipt": true,
    "numericSkuCounter": 1,
    "printCardPaymentDetails": true,
    "sendInvoicesExternally": true
  },
  "appSettings": {
    "showOutOfStockWarning": true
  },
  "extensions": [
    {
      "extensionCode": "FLOWGIFTCARD",
      "name": "text",
      "active": true
    }
  ],
  "assets": {
    "logo": {
      "url": "text",
      "assetUid": "text"
    },
    "splash": {
      "url": "text",
      "assetUid": "text"
    }
  },
  "timezone": "text",
  "languageCode": "text",
  "currency": {
    "code": "text",
    "name": "text",
    "symbol": "text",
    "symbolPosition": "text",
    "decimalSeparator": "text",
    "thousandSeparator": "text",
    "cashRounding": 1
  }
}

List users

get

List all users.

Required access: Tenant.Admin

Authorizations

accessTokenauthTokenintegrationToken

Path parameters

tenantUidstringrequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+

Query parameters

pageNumberintegeroptional

Reference to a specific page in a result set.

pageSizeintegeroptional

The number of items per page in a result set.

sortBystringoptional

Defines which field the resource list is sorted by.

sortDirectionstring · enumoptional

ENUM	Description
ASC	Sort in ascending order
DESC	Sort in descending order

Available options:

querystringoptional

Query string for tenant users

tenantuserOrganizationUidstringoptional

Reference to an Organization

Pattern: ^[A-Za-z0-9-_]+

tenantuserStoreUidstringoptional

Reference to a Store

Pattern: ^[A-Za-z0-9-_]+

Responses

application/json

objectoptional

get

HTTPcURLJavaScriptPython

GET /v2/tenants/{tenantUid}/users HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

Example response

{
  "items": [
    {
      "accountType": "FULL",
      "createdAt": "2025-04-18T00:56:27.456Z",
      "defaultStoreUid": "text",
      "displayName": "text",
      "email": "text",
      "externalId": "text",
      "firstname": "text",
      "lastAccessed": "2025-04-18T00:56:27.456Z",
      "lastModifiedAt": "2025-04-18T00:56:27.456Z",
      "lastname": "text",
      "mobile": "text",
      "status": "PENDING_INVITE",
      "storeAccess": [
        {
          "createdAt": "2025-04-18T00:56:27.456Z",
          "lastModifiedAt": "2025-04-18T00:56:27.456Z",
          "storeAccessUid": "text",
          "storeUid": "text",
          "storeRole": "ADMIN"
        }
      ],
      "tenantUid": "text",
      "tenantRole": "ACCESS",
      "tenantUserUid": "text",
      "userCode": "text",
      "languageCode": "text"
    }
  ],
  "paging": {
    "pageNumber": 1,
    "pageSize": 1,
    "totalCount": 1
  }
}

Create new user on a tenant

post

Add user to tenant

Required access: Tenant.Admin

Authorizations

accessTokenauthTokenintegrationToken

Path parameters

tenantUidstringrequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+

Body

Email is required when accountType is FULL

accountTypestring · enumrequired

ENUM	Description
FULL	Access to backoffice and onboarding of new devices
REGULAR	Can only login to already onboarded devices
SUPPORT	Support account
INTEGRATION	Computer integration account

Available options:

displayNamestringoptional

emailstringoptional

externalIdstringoptional

firstnamestringoptional

lastnamestringoptional

mobilestringoptional

passwordstringrequired

tenantRolestring · enumrequired

ENUM	Description
BLOCKED	Blocked from this tenant
ACCESS	Only access to the tenant.
ADMIN	Tenant admin, allow full access to tenant and can add users and new stores.
BACKOFFICE	Access to product, pricelists, etc.

Available options:

userCodestringrequired

tenantUserUidstringoptionalPattern: ^[A-Za-z0-9-_]+

languageCodestringoptional

ISO 639-1 code for language

Responses

application/json

objectoptional

post

HTTPcURLJavaScriptPython

POST /v2/tenants/{tenantUid}/users HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 234

{
  "accountType": "FULL",
  "displayName": "text",
  "email": "text",
  "externalId": "text",
  "firstname": "text",
  "lastname": "text",
  "mobile": "text",
  "password": "text",
  "tenantRole": "ACCESS",
  "userCode": "text",
  "tenantUserUid": "text",
  "languageCode": "text"
}

200

Tenant user respose

{
  "accountType": "FULL",
  "createdAt": "2025-04-18T00:56:27.456Z",
  "defaultStoreUid": "text",
  "displayName": "text",
  "email": "text",
  "externalId": "text",
  "firstname": "text",
  "lastAccessed": "2025-04-18T00:56:27.456Z",
  "lastModifiedAt": "2025-04-18T00:56:27.456Z",
  "lastname": "text",
  "mobile": "text",
  "status": "PENDING_INVITE",
  "storeAccess": [
    {
      "createdAt": "2025-04-18T00:56:27.456Z",
      "lastModifiedAt": "2025-04-18T00:56:27.456Z",
      "storeAccessUid": "text",
      "storeUid": "text",
      "storeRole": "ADMIN"
    }
  ],
  "tenantUid": "text",
  "tenantRole": "ACCESS",
  "tenantUserUid": "text",
  "userCode": "text",
  "languageCode": "text"
}

Get user details

get

Get details for a user.

Required access: Tenant.Admin

Authorizations

accessTokenauthTokenintegrationToken

Path parameters

tenantUserUidstringrequired

Reference to a TenantUser.

Pattern: ^[A-Za-z0-9-_]+

tenantUidstringrequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+

Responses

application/json

objectoptional

get

HTTPcURLJavaScriptPython

GET /v2/tenants/{tenantUid}/users/{tenantUserUid} HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

Tenant user respose

{
  "accountType": "FULL",
  "createdAt": "2025-04-18T00:56:27.456Z",
  "defaultStoreUid": "text",
  "displayName": "text",
  "email": "text",
  "externalId": "text",
  "firstname": "text",
  "lastAccessed": "2025-04-18T00:56:27.456Z",
  "lastModifiedAt": "2025-04-18T00:56:27.456Z",
  "lastname": "text",
  "mobile": "text",
  "status": "PENDING_INVITE",
  "storeAccess": [
    {
      "createdAt": "2025-04-18T00:56:27.456Z",
      "lastModifiedAt": "2025-04-18T00:56:27.456Z",
      "storeAccessUid": "text",
      "storeUid": "text",
      "storeRole": "ADMIN"
    }
  ],
  "tenantUid": "text",
  "tenantRole": "ACCESS",
  "tenantUserUid": "text",
  "userCode": "text",
  "languageCode": "text"
}

Update tenant user

put

Update user access for a tenant

Required access: Tenant.Admin

Authorizations

accessTokenauthTokenintegrationToken

Path parameters

tenantUserUidstringrequired

Reference to a TenantUser.

Pattern: ^[A-Za-z0-9-_]+

tenantUidstringrequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+

Query parameters

resendInvitebooleanoptional

Check external payment gateways and fetch status

Body

accountTypestring · enumoptional

ENUM	Description
FULL	Access to backoffice and onboarding of new devices
REGULAR	Can only login to already onboarded devices
SUPPORT	Support account
INTEGRATION	Computer integration account

Available options:

defaultStoreUidstringoptionalPattern: ^[A-Za-z0-9-_]+

displayNamestringoptional

emailstringoptional

externalIdstringoptional

firstnamestringoptional

lastnamestringoptional

mobilestringoptional

passwordstringoptional

storeAccessobject[]optional

tenantRolestring · enumoptional

ENUM	Description
BLOCKED	Blocked from this tenant
ACCESS	Only access to the tenant.
ADMIN	Tenant admin, allow full access to tenant and can add users and new stores.
BACKOFFICE	Access to product, pricelists, etc.

Available options:

userCodestringoptional

languageCodestringoptional

ISO 639-1 code for language

Responses

application/json

objectoptional

put

HTTPcURLJavaScriptPython

PUT /v2/tenants/{tenantUid}/users/{tenantUserUid} HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 292

{
  "accountType": "FULL",
  "defaultStoreUid": "text",
  "displayName": "text",
  "email": "text",
  "externalId": "text",
  "firstname": "text",
  "lastname": "text",
  "mobile": "text",
  "password": "text",
  "storeAccess": [
    {
      "storeUid": "text",
      "storeRole": "ADMIN"
    }
  ],
  "tenantRole": "ACCESS",
  "userCode": "text",
  "languageCode": "text"
}

200

Tenant user respose

{
  "accountType": "FULL",
  "createdAt": "2025-04-18T00:56:27.456Z",
  "defaultStoreUid": "text",
  "displayName": "text",
  "email": "text",
  "externalId": "text",
  "firstname": "text",
  "lastAccessed": "2025-04-18T00:56:27.456Z",
  "lastModifiedAt": "2025-04-18T00:56:27.456Z",
  "lastname": "text",
  "mobile": "text",
  "status": "PENDING_INVITE",
  "storeAccess": [
    {
      "createdAt": "2025-04-18T00:56:27.456Z",
      "lastModifiedAt": "2025-04-18T00:56:27.456Z",
      "storeAccessUid": "text",
      "storeUid": "text",
      "storeRole": "ADMIN"
    }
  ],
  "tenantUid": "text",
  "tenantRole": "ACCESS",
  "tenantUserUid": "text",
  "userCode": "text",
  "languageCode": "text"
}

Delete a user from a tenant

delete

Deletes a user completely from a tenant.

Required access: Tenant.Admin

Authorizations

accessTokenauthTokenintegrationToken

Path parameters

tenantUserUidstringrequired

Reference to a TenantUser.

Pattern: ^[A-Za-z0-9-_]+

tenantUidstringrequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+

Responses

delete

HTTPcURLJavaScriptPython

DELETE /v2/tenants/{tenantUid}/users/{tenantUserUid} HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

204

No Content

No Content

Get list of integration tokens for a tenant user.

get

Get list of integration tokens for a tenant user.

Required access: Tenant.Admin

Authorizations

accessTokenauthTokenintegrationToken

Path parameters

tenantUserUidstringrequired

Reference to a TenantUser.

Pattern: ^[A-Za-z0-9-_]+

tenantUidstringrequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+

Responses

application/json

objectoptional

get

HTTPcURLJavaScriptPython

GET /v2/tenants/{tenantUid}/users/{tenantUserUid}/tokens HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

Example response

{
  "items": [
    {
      "tenantUserTokenUid": "text",
      "token": "text"
    }
  ],
  "paging": {
    "pageNumber": 1,
    "pageSize": 1,
    "totalCount": 1
  }
}

Create integration token for a tenant user

post

Create integration token for a tenant user

Required access: Tenant.Admin

Authorizations

accessTokenauthTokenintegrationToken

Path parameters

tenantUserUidstringrequired

Reference to a TenantUser.

Pattern: ^[A-Za-z0-9-_]+

tenantUidstringrequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+

Responses

application/json

objectoptional

post

HTTPcURLJavaScriptPython

POST /v2/tenants/{tenantUid}/users/{tenantUserUid}/tokens HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

Example response

{
  "items": [
    {
      "tenantUserTokenUid": "text",
      "token": "text"
    }
  ],
  "paging": {
    "pageNumber": 1,
    "pageSize": 1,
    "totalCount": 1
  }
}

Delete an integration token from a tenant user

delete

Deletes an integration token for a tenant user

Required access: Tenant.Admin

Authorizations

accessTokenauthTokenintegrationToken

Path parameters

tenantUserTokenUidstringrequired

Reference to a TenantUserToken.

Pattern: ^[A-Za-z0-9-_]+

tenantUserUidstringrequired

Reference to a TenantUser.

Pattern: ^[A-Za-z0-9-_]+

tenantUidstringrequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+

Responses

delete

HTTPcURLJavaScriptPython

DELETE /v2/tenants/{tenantUid}/users/{tenantUserUid}/tokens/{tenantUserTokenUid} HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

204

No Content

No Content