Handling | Flow Retail Docs

List handlings

get

List all order handlings

Authorizations

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

Possible values:

Responses

200

Example response

application/json

get

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

200

Example response

{
  "items": [
    {
      "active": true,
      "createdAt": "2025-07-30T17:55:34.737Z",
      "createdBy": "text",
      "description": "text",
      "handlingUid": "text",
      "lastModifiedAt": "2025-07-30T17:55:34.737Z",
      "lastModifiedBy": "text",
      "name": "text",
      "triggers": [
        {
          "active": true,
          "trigger": "PUSHMESSAGE_ON_CREATE"
        }
      ]
    }
  ],
  "paging": {
    "pageNumber": 1,
    "pageSize": 1,
    "totalCount": 1
  }
}

Create a new handling

post

Create a new order handling.

Required permission: TENANT.ACCESS

Authorizations

Path parameters

tenantUidstringRequired

Reference to a tenant.

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

Body

all ofOptional

and

Responses

201

Example response

application/json

post

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

{
  "handlingUid": "text",
  "active": true,
  "description": "text",
  "name": "text",
  "triggers": [
    {
      "active": true,
      "trigger": "PUSHMESSAGE_ON_CREATE"
    }
  ]
}

201

Example response

{
  "active": true,
  "createdAt": "2025-07-30T17:55:34.737Z",
  "createdBy": "text",
  "description": "text",
  "handlingUid": "text",
  "lastModifiedAt": "2025-07-30T17:55:34.737Z",
  "lastModifiedBy": "text",
  "name": "text",
  "triggers": [
    {
      "active": true,
      "trigger": "PUSHMESSAGE_ON_CREATE"
    }
  ]
}

Get handling details

get

Get handling details

Authorizations

Path parameters

tenantUidstringRequired

Reference to a tenant.

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

handlingUidstringRequired

Reference to an handling id.

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

Responses

200

Example response

application/json

get

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

200

Example response

{
  "active": true,
  "createdAt": "2025-07-30T17:55:34.737Z",
  "createdBy": "text",
  "description": "text",
  "handlingUid": "text",
  "lastModifiedAt": "2025-07-30T17:55:34.737Z",
  "lastModifiedBy": "text",
  "name": "text",
  "triggers": [
    {
      "active": true,
      "trigger": "PUSHMESSAGE_ON_CREATE"
    }
  ]
}

Update handling details

put

Update handling details

Authorizations

Path parameters

tenantUidstringRequired

Reference to a tenant.

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

handlingUidstringRequired

Reference to an handling id.

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

Body

Request for creating or updating an orderhandling

activebooleanRequired

descriptionstringRequired

namestring · max: 20Required

Responses

200

Example response

application/json

put

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

{
  "active": true,
  "description": "text",
  "name": "text",
  "triggers": [
    {
      "active": true,
      "trigger": "PUSHMESSAGE_ON_CREATE"
    }
  ]
}

200

Example response

{
  "active": true,
  "createdAt": "2025-07-30T17:55:34.737Z",
  "createdBy": "text",
  "description": "text",
  "handlingUid": "text",
  "lastModifiedAt": "2025-07-30T17:55:34.737Z",
  "lastModifiedBy": "text",
  "name": "text",
  "triggers": [
    {
      "active": true,
      "trigger": "PUSHMESSAGE_ON_CREATE"
    }
  ]
}

Delete an handling

delete

Delete an handling

Authorizations

Path parameters

tenantUidstringRequired

Reference to a tenant.

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

handlingUidstringRequired

Reference to an handling id.

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

Responses

204

No Content

delete

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

204

No Content

No content

List Handling actions

get

List Handling actions

Authorizations

Path parameters

tenantUidstringRequired

Reference to a tenant.

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

handlingUidstringRequired

Reference to an handling id.

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

Possible values:

handlingActionStoreUidstringOptional

Reference to a store uid.

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

Responses

200

Example response

application/json

get

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

200

Example response

{
  "items": [
    {
      "active": true,
      "allowComment": true,
      "name": "text",
      "storeUid": "text",
      "createdAt": "2025-07-30T17:55:34.737Z",
      "createdBy": "text",
      "handlingActionUid": "text",
      "lastModifiedAt": "2025-07-30T17:55:34.737Z",
      "lastModifiedBy": "text"
    }
  ],
  "paging": {
    "pageNumber": 1,
    "pageSize": 1,
    "totalCount": 1
  }
}

Create new handling action

post

Create new handling action

Authorizations

Path parameters

tenantUidstringRequired

Reference to a tenant.

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

handlingUidstringRequired

Reference to an handling id.

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

Body

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

activebooleanRequired

allowCommentbooleanRequired

namestring · max: 20Required

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

Responses

200

Example response

application/json

Responseall of

post

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

{
  "handlingActionUid": "text",
  "active": true,
  "allowComment": true,
  "name": "text",
  "storeUid": "text"
}

200

Example response

{
  "active": true,
  "allowComment": true,
  "name": "text",
  "storeUid": "text",
  "createdAt": "2025-07-30T17:55:34.737Z",
  "createdBy": "text",
  "handlingActionUid": "text",
  "lastModifiedAt": "2025-07-30T17:55:34.737Z",
  "lastModifiedBy": "text"
}

Get handling action details

get

Get handling action details

Authorizations

Path parameters

tenantUidstringRequired

Reference to a tenant.

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

handlingUidstringRequired

Reference to an handling id.

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

handlingActionUidstringRequired

Reference to an handling action id.

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

Responses

200

Example response

application/json

Responseall of

get

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

200

Example response

{
  "active": true,
  "allowComment": true,
  "name": "text",
  "storeUid": "text",
  "createdAt": "2025-07-30T17:55:34.737Z",
  "createdBy": "text",
  "handlingActionUid": "text",
  "lastModifiedAt": "2025-07-30T17:55:34.737Z",
  "lastModifiedBy": "text"
}

Update a handling action

put

Update a handling action

Required permission: TENANT.ADMIN

Authorizations

Path parameters

tenantUidstringRequired

Reference to a tenant.

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

handlingUidstringRequired

Reference to an handling id.

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

handlingActionUidstringRequired

Reference to an handling action id.

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

Body

activebooleanRequired

allowCommentbooleanRequired

namestring · max: 20Required

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

Responses

200

Example response

application/json

Responseall of

put

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

{
  "active": true,
  "allowComment": true,
  "name": "text",
  "storeUid": "text"
}

200

Example response

{
  "active": true,
  "allowComment": true,
  "name": "text",
  "storeUid": "text",
  "createdAt": "2025-07-30T17:55:34.737Z",
  "createdBy": "text",
  "handlingActionUid": "text",
  "lastModifiedAt": "2025-07-30T17:55:34.737Z",
  "lastModifiedBy": "text"
}

Delete a handling action

delete

Delete a handling action

Authorizations

Path parameters

tenantUidstringRequired

Reference to a tenant.

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

handlingUidstringRequired

Reference to an handling id.

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

handlingActionUidstringRequired

Reference to an handling action id.

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

Responses

204

No Content

delete

DELETE /v2/tenants/{tenantUid}/handlings/{handlingUid}/actions/{handlingActionUid} HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

204

No Content

No content