Update the expiry date of one or more label assignments in a single request. Use this endpoint to extend or shorten how long a label remains active on a customer, product, or store — without removing and re-assigning it.

You can identify the label to update by its ID, name, or external ID. You can process up to 100 update items per request.

Example request

curl --location --request PUT 'https://eu.api.capillarytech.com/v2/labels/assignments' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic {base64_credentials}' \
--data '{
  "entityType": "PRODUCT",
  "updates": [
    {
      "entityId": "505102",
      "labelId": 128,
      "expiryDate": "2100-06-30T23:59:59+05:30"
    }
  ]
}'

Prerequisites

• Basic authentication (Authorization: Basic {base64_credentials}) or OAuth (X-CAP-API-OAUTH-TOKEN).
• Access to Label access group resource

Body parameters

Note: The Updatable column indicates which fields can be changed. The expiryDate is the only updatable field — all other fields identify which assignment to update.

Example response

{
    "data": [
        {
            "assignmentId": 25,
            "entityId": "505102",
            "labelId": 128,
            "labelName": "DocDemo-VIP-Customer0",
            "labelExternalId": "docdemo-vip-0",
            "expiryDate": "2100-06-30T18:29:59Z"
        }
    ],
    "warnings": [],
    "errors": []
}

Response parameters

Error & warning codes