Update till details

Updates details for a till.

Required permissions: TILL

put

/tenants/{tenantUid}/stores/{storeUid}/tills/{tillUid}

Authorizations

AuthorizationstringRequired

Access token recevied after user login with a deviceToken

Path parameters

storeUidstringRequired

Reference to a Store.

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

tillUidstringRequired

Reference to a till.

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

tenantUidstringRequired

Reference to a tenant.

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

Body

Update till

cashDrawerstringOptional

namestringOptional

paymentTerminalstring · enumOptionalPossible values:

tillNumberintegerOptional

Responses

200

Example response

application/json

cashDrawerstringRequired

createdAtstring · date-timeRequired

lastModifiedAtstring · date-timeRequired

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

lastOrderNumberstringRequired

namestringRequired

paymentTerminalstring · enumRequiredPossible values:

statusstring · enumRequired

Current open/closed state of the till. OPEN means a cash-register session is active; CLOSED means none is. For full session details (counted amounts, cash revenue, open/close users) use the till status endpoint.

Possible values:

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

tillNumberintegerRequired

put/tenants/{tenantUid}/stores/{storeUid}/tills/{tillUid}

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

{
  "cashDrawer": "text",
  "name": "text",
  "paymentTerminal": "NONE",
  "settings": [
    {
      "key": "STRIPE_TERMINAL_ID",
      "value": "text"
    }
  ],
  "tillNumber": 1
}

200

Example response

{
  "cashDrawer": "text",
  "createdAt": "2026-01-01T00:00:00.000Z",
  "lastModifiedAt": "2026-01-01T00:00:00.000Z",
  "lastOrderUid": "text",
  "lastOrderNumber": "text",
  "name": "text",
  "paymentTerminal": "NONE",
  "settings": [
    {
      "key": "STRIPE_TERMINAL_ID",
      "value": "text"
    }
  ],
  "status": "OPEN",
  "tillUid": "text",
  "tillNumber": 1,
  "device": {
    "deviceUid": "text",
    "identifier": "text",
    "name": "text"
  },
  "fiscal": {
    "registerId": "text",
    "registerState": "",
    "registerDesignation": "text"
  }
}