Import

Import

List all import templates

get

List all import templates

Required permission: TENANT.ADMIN

Authorizations

authTokenintegrationTokenaccessToken

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:

Responses

application/json

objectoptional

get

HTTPcURLJavaScriptPython

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

200

Example response

{
  "items": [
    {
      "templateUid": "text",
      "createdBy": "text",
      "createdAt": "2025-04-18T01:01:36.453Z",
      "lastModifiedBy": "text",
      "lastModifiedAt": "2025-04-18T01:01:36.453Z",
      "layouts": [
        {
          "layoutUid": "text",
          "createdBy": "text",
          "createdAt": "2025-04-18T01:01:36.453Z",
          "lastModifiedBy": "text",
          "lastModifiedAt": "2025-04-18T01:01:36.453Z",
          "conversions": [
            {
              "conversionUid": "text",
              "createdAt": "2025-04-18T01:01:36.453Z",
              "createdBy": "text",
              "lastModifiedAt": "2025-04-18T01:01:36.453Z",
              "lastModifiedBy": "text",
              "fromValue": "text",
              "toValue": "text"
            }
          ],
          "fieldName": "text",
          "value": "text"
        }
      ],
      "name": "text",
      "description": "text",
      "entity": "PRODUCTS",
      "importFormat": "EXCEL"
    }
  ],
  "paging": {
    "pageNumber": 1,
    "pageSize": 1,
    "totalCount": 1
  }
}

Create import template

post

Create import template

Required permission: TENANT.ADMIN

Authorizations

accessTokenauthTokenintegrationToken

Path parameters

tenantUidstringrequired

Reference to a tenant.

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

Body

namestringrequired

descriptionstringrequired

entitystring · enum · min: 1required

ENUM	Description
PRODUCTS	Import products
PRICES	Import prices
PRODUCT_GROUPS	Import product groups
BRANDS	Import brands
CUSTOMERS	Import customers
STOCK	Import stock values
SUPPLIER_PRODUCT	Import Product supplier information
SUPPLIERS	Import suppliers

Available options:

importFormatstring · enum · min: 1required

ENUM	Description
EXCEL	XLS file

Available options:

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

Responses

application/json

all ofoptional

post

HTTPcURLJavaScriptPython

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

{
  "name": "text",
  "description": "text",
  "entity": "PRODUCTS",
  "importFormat": "EXCEL",
  "templateUid": "text"
}

200

Example response

{
  "templateUid": "text",
  "createdBy": "text",
  "createdAt": "2025-04-18T01:01:36.453Z",
  "lastModifiedBy": "text",
  "lastModifiedAt": "2025-04-18T01:01:36.453Z",
  "layouts": [
    {
      "layoutUid": "text",
      "createdBy": "text",
      "createdAt": "2025-04-18T01:01:36.453Z",
      "lastModifiedBy": "text",
      "lastModifiedAt": "2025-04-18T01:01:36.453Z",
      "conversions": [
        {
          "conversionUid": "text",
          "createdAt": "2025-04-18T01:01:36.453Z",
          "createdBy": "text",
          "lastModifiedAt": "2025-04-18T01:01:36.453Z",
          "lastModifiedBy": "text",
          "fromValue": "text",
          "toValue": "text"
        }
      ],
      "fieldName": "text",
      "value": "text"
    }
  ],
  "name": "text",
  "description": "text",
  "entity": "PRODUCTS",
  "importFormat": "EXCEL"
}

Get import template details

get

Get import template details. When includeLayouts is true, the response contains all layouts for the template. If includeConversions is also true, the response also contains all conversions for every layout. includeConversions is only honored if includeLayouts is true

Authorizations

authTokenintegrationTokenaccessToken

Path parameters

tenantUidstringrequired

Reference to a tenant.

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

importTemplateUidstringrequired

Reference to a import template.

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

Query parameters

includeLayoutsbooleanoptional

Include layouts in response

includeConversionsbooleanoptional

Include conversions in response

Responses

application/json

all ofoptional

get

HTTPcURLJavaScriptPython

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

200

Example response

{
  "templateUid": "text",
  "createdBy": "text",
  "createdAt": "2025-04-18T01:01:36.453Z",
  "lastModifiedBy": "text",
  "lastModifiedAt": "2025-04-18T01:01:36.453Z",
  "layouts": [
    {
      "layoutUid": "text",
      "createdBy": "text",
      "createdAt": "2025-04-18T01:01:36.453Z",
      "lastModifiedBy": "text",
      "lastModifiedAt": "2025-04-18T01:01:36.453Z",
      "conversions": [
        {
          "conversionUid": "text",
          "createdAt": "2025-04-18T01:01:36.453Z",
          "createdBy": "text",
          "lastModifiedAt": "2025-04-18T01:01:36.453Z",
          "lastModifiedBy": "text",
          "fromValue": "text",
          "toValue": "text"
        }
      ],
      "fieldName": "text",
      "value": "text"
    }
  ],
  "name": "text",
  "description": "text",
  "entity": "PRODUCTS",
  "importFormat": "EXCEL"
}

Update import template

put

Update import template

Required permission: TENANT.ADMIN

Authorizations

accessTokenauthTokenintegrationToken

Path parameters

tenantUidstringrequired

Reference to a tenant.

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

importTemplateUidstringrequired

Reference to a import template.

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

Body

namestringrequired

descriptionstringrequired

Responses

application/json

all ofoptional

put

HTTPcURLJavaScriptPython

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

{
  "name": "text",
  "description": "text"
}

200

Example response

{
  "templateUid": "text",
  "createdBy": "text",
  "createdAt": "2025-04-18T01:01:36.453Z",
  "lastModifiedBy": "text",
  "lastModifiedAt": "2025-04-18T01:01:36.453Z",
  "layouts": [
    {
      "layoutUid": "text",
      "createdBy": "text",
      "createdAt": "2025-04-18T01:01:36.453Z",
      "lastModifiedBy": "text",
      "lastModifiedAt": "2025-04-18T01:01:36.453Z",
      "conversions": [
        {
          "conversionUid": "text",
          "createdAt": "2025-04-18T01:01:36.453Z",
          "createdBy": "text",
          "lastModifiedAt": "2025-04-18T01:01:36.453Z",
          "lastModifiedBy": "text",
          "fromValue": "text",
          "toValue": "text"
        }
      ],
      "fieldName": "text",
      "value": "text"
    }
  ],
  "name": "text",
  "description": "text",
  "entity": "PRODUCTS",
  "importFormat": "EXCEL"
}

Delete an Import template

delete

Delete an Import template

Required permission: TENANT.ADMIN

Authorizations

accessTokenauthTokenintegrationToken

Path parameters

tenantUidstringrequired

Reference to a tenant.

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

importTemplateUidstringrequired

Reference to a import template.

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

Responses

delete

HTTPcURLJavaScriptPython

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

204

No Content

No Content

List layouts for a import template

get

List layouts for a import template

Required permission: TENANT.ADMIN

Authorizations

authTokenintegrationTokenaccessToken

Path parameters

tenantUidstringrequired

Reference to a tenant.

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

importTemplateUidstringrequired

Reference to a import template.

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:

Responses

application/json

objectoptional

get

HTTPcURLJavaScriptPython

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

200

Example response

{
  "items": [
    {
      "layoutUid": "text",
      "createdBy": "text",
      "createdAt": "2025-04-18T01:01:36.453Z",
      "lastModifiedBy": "text",
      "lastModifiedAt": "2025-04-18T01:01:36.453Z",
      "conversions": [
        {
          "conversionUid": "text",
          "createdAt": "2025-04-18T01:01:36.453Z",
          "createdBy": "text",
          "lastModifiedAt": "2025-04-18T01:01:36.453Z",
          "lastModifiedBy": "text",
          "fromValue": "text",
          "toValue": "text"
        }
      ],
      "fieldName": "text",
      "value": "text"
    }
  ],
  "paging": {
    "pageNumber": 1,
    "pageSize": 1,
    "totalCount": 1
  }
}

Create layout for an import template

post

Create layout for an import template

Required permission: TENANT.ADMIN

Authorizations

accessTokenauthTokenintegrationToken

Path parameters

tenantUidstringrequired

Reference to a tenant.

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

importTemplateUidstringrequired

Reference to a import template.

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

Body

all ofoptional

Responses

application/json

all ofoptional

post

HTTPcURLJavaScriptPython

POST /v2/tenants/{tenantUid}/imports/templates/{importTemplateUid}/layouts HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 54

{
  "fieldName": "text",
  "value": "text",
  "layoutUid": "text"
}

200

Example response

{
  "layoutUid": "text",
  "createdBy": "text",
  "createdAt": "2025-04-18T01:01:36.453Z",
  "lastModifiedBy": "text",
  "lastModifiedAt": "2025-04-18T01:01:36.453Z",
  "conversions": [
    {
      "conversionUid": "text",
      "createdAt": "2025-04-18T01:01:36.453Z",
      "createdBy": "text",
      "lastModifiedAt": "2025-04-18T01:01:36.453Z",
      "lastModifiedBy": "text",
      "fromValue": "text",
      "toValue": "text"
    }
  ],
  "fieldName": "text",
  "value": "text"
}

Get layout details for an import template

get

Get import layout details

Authorizations

authTokenintegrationTokenaccessToken

Path parameters

tenantUidstringrequired

Reference to a tenant.

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

importTemplateUidstringrequired

Reference to a import template.

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

importLayoutUidstringrequired

Reference to a import layout.

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

Query parameters

includeConversionsbooleanoptional

Include conversions in response

Responses

application/json

all ofoptional

get

HTTPcURLJavaScriptPython

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

200

Example response

{
  "layoutUid": "text",
  "createdBy": "text",
  "createdAt": "2025-04-18T01:01:36.453Z",
  "lastModifiedBy": "text",
  "lastModifiedAt": "2025-04-18T01:01:36.453Z",
  "conversions": [
    {
      "conversionUid": "text",
      "createdAt": "2025-04-18T01:01:36.453Z",
      "createdBy": "text",
      "lastModifiedAt": "2025-04-18T01:01:36.453Z",
      "lastModifiedBy": "text",
      "fromValue": "text",
      "toValue": "text"
    }
  ],
  "fieldName": "text",
  "value": "text"
}

Update layout for an import template

put

Update import layout

Required permission: TENANT.ADMIN

Authorizations

accessTokenauthTokenintegrationToken

Path parameters

tenantUidstringrequired

Reference to a tenant.

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

importTemplateUidstringrequired

Reference to a import template.

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

importLayoutUidstringrequired

Reference to a import layout.

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

Body

fieldNamestringrequired

Entity field name in FlowRetail

valuestringrequired

Static value, or reference to field in import file.

Example: For EXCEL import use A to get the value from column A

Responses

application/json

all ofoptional

put

HTTPcURLJavaScriptPython

PUT /v2/tenants/{tenantUid}/imports/templates/{importTemplateUid}/layouts/{importLayoutUid} HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 35

{
  "fieldName": "text",
  "value": "text"
}

200

Example response

{
  "layoutUid": "text",
  "createdBy": "text",
  "createdAt": "2025-04-18T01:01:36.453Z",
  "lastModifiedBy": "text",
  "lastModifiedAt": "2025-04-18T01:01:36.453Z",
  "conversions": [
    {
      "conversionUid": "text",
      "createdAt": "2025-04-18T01:01:36.453Z",
      "createdBy": "text",
      "lastModifiedAt": "2025-04-18T01:01:36.453Z",
      "lastModifiedBy": "text",
      "fromValue": "text",
      "toValue": "text"
    }
  ],
  "fieldName": "text",
  "value": "text"
}

Delete a layout for an import template

delete

Delete an Import layout

Required permission: TENANT.ADMIN

Authorizations

accessTokenauthTokenintegrationToken

Path parameters

tenantUidstringrequired

Reference to a tenant.

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

importTemplateUidstringrequired

Reference to a import template.

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

importLayoutUidstringrequired

Reference to a import layout.

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

Responses

delete

HTTPcURLJavaScriptPython

DELETE /v2/tenants/{tenantUid}/imports/templates/{importTemplateUid}/layouts/{importLayoutUid} HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

204

No Content

No Content

List import files

get

List import files. Use query parameter to narrow list

Authorizations

authTokenintegrationTokenaccessToken

Path parameters

tenantUidstringrequired

Reference to a tenant.

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

Query parameters

importTemplateUidsstring[]optional

Reference to a Import Template.

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:

importFileStatestring · enum · min: 1optional

ENUM	Description
NOT_STARTED	Import not started
IMPORT_IN_PROGRESS	Import is running
IMPORT_ABORT	Import is aborting
IMPORT_ABORTED	Import has been aborted
VALIDATE_IN_PROGRESS	Validate is running
COMPLETE_NOTHING_TO_IMPORT	Import is done, but there where nothing to import
COMPLETE	Import complete
VALIDATE_FAILED	Validate failed
IMPORT_FAILED	Import failed
IMPORT_ABORT	Import is aborting
IMPORT_ABORTED	Import has been aborted
READY_TO_IMPORT	Validation OK, import is ready

Available options:

Responses

application/json

objectoptional

get

HTTPcURLJavaScriptPython

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

200

Example response

{
  "items": [
    {
      "importFileUid": "text",
      "template": {
        "templateUid": "text",
        "createdBy": "text",
        "createdAt": "2025-04-18T01:01:36.453Z",
        "lastModifiedBy": "text",
        "lastModifiedAt": "2025-04-18T01:01:36.453Z",
        "layouts": [
          {
            "layoutUid": "text",
            "createdBy": "text",
            "createdAt": "2025-04-18T01:01:36.453Z",
            "lastModifiedBy": "text",
            "lastModifiedAt": "2025-04-18T01:01:36.453Z",
            "conversions": [
              {
                "conversionUid": "text",
                "createdAt": "2025-04-18T01:01:36.453Z",
                "createdBy": "text",
                "lastModifiedAt": "2025-04-18T01:01:36.453Z",
                "lastModifiedBy": "text",
                "fromValue": "text",
                "toValue": "text"
              }
            ],
            "fieldName": "text",
            "value": "text"
          }
        ],
        "name": "text",
        "description": "text",
        "entity": "PRODUCTS",
        "importFormat": "EXCEL"
      },
      "createdBy": "text",
      "createdAt": "2025-04-18T01:01:36.453Z",
      "lastModifiedBy": "text",
      "lastModifiedAt": "2025-04-18T01:01:36.453Z",
      "state": "NOT_STARTED",
      "filename": "text",
      "columnCount": 1,
      "rowCount": 1,
      "progressCount": 1,
      "errorCount": 1,
      "ignoredCount": 1,
      "estimatedRemainingTime": 1,
      "estimatedRemainingTimeText": "text",
      "totalTime": 1,
      "operation": "INSERT",
      "errorMessage": "text"
    }
  ],
  "paging": {
    "pageNumber": 1,
    "pageSize": 1,
    "totalCount": 1
  }
}

Process or simulate import

post

This will create and return a new import file record with state NOT_STARTED and the importFileUid. The validation and import is processed in a new thread that will update the import progress every 5 seconds. To fetch the current state, use the Get import-file details endpoint.

Use action PROCESS to commit the import upon validation. If no errors occur the import state is COMPLETE.

Use action SIMULATE if you do not want to commit the import data and only validat. If no errors occur the import state will be READY_TO_IMPORT.

Use the Execute import content endpoint to abort the processing or to commit (execute) a successful simulation.

Authorizations

accessTokenauthTokenintegrationToken

Path parameters

tenantUidstringrequired

Reference to a tenant.

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

Body

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

base64Datastringrequired

base64 encoded data to be processed

operationstring · enum · min: 1required

ENUM	Description
INSERT	Only insert non-existing records, existing records will be ignored
UPDATE	Only update existing records, non-existing records will be ignored
UPSERT	non-existing records will be inserted, existing records will be updated

Available options:

actionstring · enum · min: 1required

ENUM	Description
SIMULATE	Do a simulate on import. Return content without saving
PROCESS	Process file with given template. Save file if no errors

Available options:

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

Responses

application/json

objectoptional

post

HTTPcURLJavaScriptPython

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

{
  "templateUid": "text",
  "base64Data": "text",
  "operation": "INSERT",
  "action": "SIMULATE",
  "importFileUid": "text"
}

200

Example response

{
  "templateUid": "text",
  "base64Data": "text",
  "contentType": "text",
  "action": "SIMULATE",
  "importFileUid": "text",
  "operation": "INSERT",
  "state": "NOT_STARTED"
}

Get importfile details

get

Get importfile details

Authorizations

authTokenintegrationTokenaccessToken

Path parameters

tenantUidstringrequired

Reference to a tenant.

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

importFileUidstringrequired

Reference to a import file.

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

Responses

application/json

all ofoptional

get

HTTPcURLJavaScriptPython

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

200

Example response

{
  "importFileUid": "text",
  "template": {
    "templateUid": "text",
    "createdBy": "text",
    "createdAt": "2025-04-18T01:01:36.453Z",
    "lastModifiedBy": "text",
    "lastModifiedAt": "2025-04-18T01:01:36.453Z",
    "layouts": [
      {
        "layoutUid": "text",
        "createdBy": "text",
        "createdAt": "2025-04-18T01:01:36.453Z",
        "lastModifiedBy": "text",
        "lastModifiedAt": "2025-04-18T01:01:36.453Z",
        "conversions": [
          {
            "conversionUid": "text",
            "createdAt": "2025-04-18T01:01:36.453Z",
            "createdBy": "text",
            "lastModifiedAt": "2025-04-18T01:01:36.453Z",
            "lastModifiedBy": "text",
            "fromValue": "text",
            "toValue": "text"
          }
        ],
        "fieldName": "text",
        "value": "text"
      }
    ],
    "name": "text",
    "description": "text",
    "entity": "PRODUCTS",
    "importFormat": "EXCEL"
  },
  "createdBy": "text",
  "createdAt": "2025-04-18T01:01:36.453Z",
  "lastModifiedBy": "text",
  "lastModifiedAt": "2025-04-18T01:01:36.453Z",
  "state": "NOT_STARTED",
  "filename": "text",
  "columnCount": 1,
  "rowCount": 1,
  "progressCount": 1,
  "errorCount": 1,
  "ignoredCount": 1,
  "estimatedRemainingTime": 1,
  "estimatedRemainingTimeText": "text",
  "totalTime": 1,
  "operation": "INSERT",
  "errorMessage": "text",
  "base64Data": "text"
}

Execute import content

post

Execute or abort import job.

Authorizations

accessTokenauthTokenintegrationToken

Path parameters

tenantUidstringrequired

Reference to a tenant.

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

importFileUidstringrequired

Reference to a import file.

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

Body

actionstring · enumoptional

ENUM	Description
EXECUTE	Execute Import job
ABORT	Abort running job

Available options:

Responses

application/json

objectoptional

post

HTTPcURLJavaScriptPython

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

{
  "action": "EXECUTE"
}

200

Example response

{
  "templateUid": "text",
  "base64Data": "text",
  "contentType": "text",
  "action": "SIMULATE",
  "importFileUid": "text",
  "operation": "INSERT",
  "state": "NOT_STARTED"
}

Delete Import file

delete

Delete Import file

Authorizations

authTokenintegrationTokenaccessToken

Path parameters

tenantUidstringrequired

Reference to a tenant.

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

importFileUidstringrequired

Reference to a import file.

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

Responses

delete

HTTPcURLJavaScriptPython

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

200

OK

No Content

List layout conversions

get

List conversions for a import layout

Required permission: TENANT.ADMIN

Authorizations

authTokenintegrationTokenaccessToken

Path parameters

tenantUidstringrequired

Reference to a tenant.

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

importTemplateUidstringrequired

Reference to a import template.

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

importLayoutUidstringrequired

Reference to a import layout.

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:

Responses

application/json

objectoptional

get

HTTPcURLJavaScriptPython

GET /v2/tenants/{tenantUid}/imports/templates/{importTemplateUid}/layouts/{importLayoutUid}/conversions HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

Example response

{
  "items": [
    {
      "conversionUid": "text",
      "createdAt": "2025-04-18T01:01:36.453Z",
      "createdBy": "text",
      "lastModifiedAt": "2025-04-18T01:01:36.453Z",
      "lastModifiedBy": "text",
      "fromValue": "text",
      "toValue": "text"
    }
  ],
  "paging": {
    "pageNumber": 1,
    "pageSize": 1,
    "totalCount": 1
  }
}

Create layout conversion

post

Create conversion for an import layout

Required permission: TENANT.ADMIN

Authorizations

accessTokenintegrationTokenauthToken

Path parameters

tenantUidstringrequired

Reference to a tenant.

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

importTemplateUidstringrequired

Reference to a import template.

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

importLayoutUidstringrequired

Reference to a import layout.

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

Body

all ofoptional

Responses

application/json

all ofoptional

post

HTTPcURLJavaScriptPython

POST /v2/tenants/{tenantUid}/imports/templates/{importTemplateUid}/layouts/{importLayoutUid}/conversions HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 60

{
  "fromValue": "text",
  "toValue": "text",
  "conversionUid": "text"
}

200

Example response

{
  "conversionUid": "text",
  "createdAt": "2025-04-18T01:01:36.453Z",
  "createdBy": "text",
  "lastModifiedAt": "2025-04-18T01:01:36.453Z",
  "lastModifiedBy": "text",
  "fromValue": "text",
  "toValue": "text"
}

Get layout conversion details

get

Get import layout conversion details

Authorizations

authTokenintegrationTokenaccessToken

Path parameters

tenantUidstringrequired

Reference to a tenant.

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

importTemplateUidstringrequired

Reference to a import template.

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

importLayoutUidstringrequired

Reference to a import layout.

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

importConversionUidstringrequired

Reference to a import layout conversion.

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

Responses

application/json

all ofoptional

get

HTTPcURLJavaScriptPython

GET /v2/tenants/{tenantUid}/imports/templates/{importTemplateUid}/layouts/{importLayoutUid}/conversions/{importConversionUid} HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

Example response

{
  "conversionUid": "text",
  "createdAt": "2025-04-18T01:01:36.453Z",
  "createdBy": "text",
  "lastModifiedAt": "2025-04-18T01:01:36.453Z",
  "lastModifiedBy": "text",
  "fromValue": "text",
  "toValue": "text"
}

Update layout conversion

put

Update import layout

Required permission: TENANT.ADMIN

Authorizations

accessTokenauthTokenintegrationToken

Path parameters

tenantUidstringrequired

Reference to a tenant.

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

importTemplateUidstringrequired

Reference to a import template.

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

importLayoutUidstringrequired

Reference to a import layout.

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

importConversionUidstringrequired

Reference to a import layout conversion.

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

Body

fromValuestringrequired

toValuestringrequired

Responses

application/json

all ofoptional

put

HTTPcURLJavaScriptPython

PUT /v2/tenants/{tenantUid}/imports/templates/{importTemplateUid}/layouts/{importLayoutUid}/conversions/{importConversionUid} HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 37

{
  "fromValue": "text",
  "toValue": "text"
}

200

Example response

{
  "conversionUid": "text",
  "createdAt": "2025-04-18T01:01:36.453Z",
  "createdBy": "text",
  "lastModifiedAt": "2025-04-18T01:01:36.453Z",
  "lastModifiedBy": "text",
  "fromValue": "text",
  "toValue": "text"
}

Delete a layout conversion

delete

Delete an Import layout

Required permission: TENANT.ADMIN

Authorizations

accessTokenauthTokenintegrationToken

Path parameters

tenantUidstringrequired

Reference to a tenant.

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

importTemplateUidstringrequired

Reference to a import template.

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

importLayoutUidstringrequired

Reference to a import layout.

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

importConversionUidstringrequired

Reference to a import layout conversion.

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

Responses

delete

HTTPcURLJavaScriptPython

DELETE /v2/tenants/{tenantUid}/imports/templates/{importTemplateUid}/layouts/{importLayoutUid}/conversions/{importConversionUid} HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

204

No Content

No Content