Reference · Modifiers

Update a pre-modifier group

PATCH/v1/sites/{siteId}/pre-modifier-groups/{code}

Changes a pre-modifier group. Only the fields sent change. Nothing is deleted: retire it with active false.

Needs Catalogue: writeChanges live data

Path

siteIdrequired
The site, from GET /v1/sites.
string
coderequired
The record's code.
string

Headers

Authorizationrequired
An API key from Automation > Access in the Dnero portal, sent as Authorization: Bearer <key>.
string

Body

active
False to retire it, true to bring it back.
boolean
name
A new name.
string · 1–200 characters
options
Replaces its options, in order.
array of objects
4 fields in each
- displayNamerequired
  What the till shows.
  string · 1–100 characters
- priceChange
  Added to the item's price, in minor units. 0 for free.
  integer
- pricePercent
  Or a percentage of the item's price, instead of priceChange.
  number · double
- printName
  What the kitchen ticket says. Defaults to displayName.
  string · at most 100 characters

Responses

200OK
400Bad Requestbad_request invalid_cursor idempotency_key_required
401Unauthorizedmissing_key invalid_key key_expired +1 more
403Forbiddenkey_revoked assistant_key key_without_access +7 more
404Not Foundsite_not_found not_found
409Conflictidempotency_key_reused request_in_progress
422Unprocessable Entityinvalid_request not_a_modifier_group
429Too Many Requestsrate_limited
500Internal Server Errorserver_error
502Bad Gatewayupstream_unavailable

200 OK

activerequired
False for a retired group.
boolean
coderequired
The group's code.
string
namerequired
The group's name.
string
optionsrequired
Its options, in order.
array of objects
5 fields in each
- coderequired
  The option's code.
  string
- displayNamerequired
  What the till shows.
  string
- priceChangerequired
  Added to the item's price, in minor units. 0 is free.
  integer
- pricePercent
  Or a percentage of the item's price: 50 is half as much again.
  number · double
- printName
  What the kitchen ticket says, when it differs.
  string
updatedAt
When it last changed.
string · date-time

curlJavaScriptPython

curl -X PATCH "https://api.dev.dnerohq.com/v1/sites/9a3c74c2-741e-48c3-ad9e-b137ec1c7243/pre-modifier-groups/7b3e9c14-2a6f-4d08-8b5e-c1f4a7d2e936" \
  -H "Authorization: Bearer $DNERO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "options": [
    {
      "displayName": "Extra",
      "priceChange": 100
    }
  ]
}'

const response = await fetch('https://api.dev.dnerohq.com/v1/sites/9a3c74c2-741e-48c3-ad9e-b137ec1c7243/pre-modifier-groups/7b3e9c14-2a6f-4d08-8b5e-c1f4a7d2e936', {
  method: 'PATCH',
  headers: {
    Authorization: `Bearer ${process.env.DNERO_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "options": [
      {
        "displayName": "Extra",
        "priceChange": 100
      }
    ]
  }),
})
const data = await response.json()

import os
import requests

response = requests.patch(
    "https://api.dev.dnerohq.com/v1/sites/9a3c74c2-741e-48c3-ad9e-b137ec1c7243/pre-modifier-groups/7b3e9c14-2a6f-4d08-8b5e-c1f4a7d2e936",
    headers={"Authorization": f"Bearer {os.environ['DNERO_API_KEY']}"},
    json={
      "options": [
        {
          "displayName": "Extra",
          "priceChange": 100
        }
      ]
    },
)
data = response.json()

200OKapplication/json

{
  "active": true,
  "code": "4f8a2d6c-1e9b-4c3a-8d7f-0b5e2a9c6d14",
  "name": "Quantity",
  "options": [
    {
      "code": "b1c4e7f0-2a5d-4e8b-9c3f-6a0d1e4b7c92",
      "displayName": "Extra",
      "priceChange": 100,
      "pricePercent": 50,
      "printName": "XTRA"
    }
  ],
  "updatedAt": "2026-10-20T03:15:00Z"
}

400Bad Requestapplication/problem+json

{
  "type": "https://developers.dnerohq.com/guides/errors/#bad_request",
  "title": "Bad Request",
  "status": 400,
  "detail": "The request could not be read, for example malformed JSON.",
  "code": "bad_request"
}

401Unauthorizedapplication/problem+json

{
  "type": "https://developers.dnerohq.com/guides/errors/#missing_key",
  "title": "Unauthorized",
  "status": 401,
  "detail": "No API key was sent.",
  "code": "missing_key"
}

403Forbiddenapplication/problem+json

{
  "type": "https://developers.dnerohq.com/guides/errors/#key_revoked",
  "title": "Forbidden",
  "status": 403,
  "detail": "The key was revoked or switched off in the Dnero portal.",
  "code": "key_revoked"
}

404Not Foundapplication/problem+json

{
  "type": "https://developers.dnerohq.com/guides/errors/#site_not_found",
  "title": "Not Found",
  "status": 404,
  "detail": "The key does not reach that site, or there is no such site.",
  "code": "site_not_found"
}

409Conflictapplication/problem+json

{
  "type": "https://developers.dnerohq.com/guides/errors/#idempotency_key_reused",
  "title": "Conflict",
  "status": 409,
  "detail": "This `Idempotency-Key` was already used for a different request.",
  "code": "idempotency_key_reused"
}

422Unprocessable Entityapplication/problem+json

{
  "type": "https://developers.dnerohq.com/guides/errors/#invalid_request",
  "title": "Unprocessable Entity",
  "status": 422,
  "detail": "The request was read but is not valid.",
  "code": "invalid_request"
}

429Too Many Requestsapplication/problem+json

{
  "type": "https://developers.dnerohq.com/guides/errors/#rate_limited",
  "title": "Too Many Requests",
  "status": 429,
  "detail": "The key has used its requests for this minute.",
  "code": "rate_limited"
}

500Internal Server Errorapplication/problem+json

{
  "type": "https://developers.dnerohq.com/guides/errors/#server_error",
  "title": "Internal Server Error",
  "status": 500,
  "detail": "Something went wrong on Dnero's side. It has been logged.",
  "code": "server_error"
}

502Bad Gatewayapplication/problem+json

{
  "type": "https://developers.dnerohq.com/guides/errors/#upstream_unavailable",
  "title": "Bad Gateway",
  "status": 502,
  "detail": "Something Dnero depends on did not answer in time.",
  "code": "upstream_unavailable"
}

Examples use this site's API host. Keep the key in $DNERO_API_KEY; never paste it into code.