Update priority allocations for a campaign item

PATCH

/campaign/{id}/priority-allocations/{itemId}

Updates priority allocation settings for a specific campaign item.

Update Operations:

Modify priority allocation rules

Update asset assignments

Change store priorities

Adjust allocation slots

Business Rules:

Campaign must not be locked

User must have modification permissions

Priority rules must be valid

Asset and store references must exist

Side Effects:

Updates allocation rule priorities

May trigger re-allocation processes

Updates campaign modification timestamp

Request

Authorization

API Key

Add parameter in header

Authorization

Example:

Authorization: ********************

Path Params

Body Params application/jsonRequired

Examples

Responses

🟢200OK

application/json

Priority allocations updated successfully

Body

🟠400Bad Request

🟠403Forbidden

🟠404Not Found

🔴500Internal Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PATCH 'https://prod.your-api-server.com/campaign/550e8400-e29b-41d4-a716-446655440000/priority-allocations/550e8400-e29b-41d4-a716-446655440001' \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "slot": 1,
    "assetId": "550e8400-e29b-41d4-a716-446655440002",
    "priorityAllocationRules": [
        {
            "priority": 1,
            "storeId": "550e8400-e29b-41d4-a716-446655440003",
            "assetId": "550e8400-e29b-41d4-a716-446655440002",
            "slot": 1
        },
        {
            "priority": 2,
            "storeId": "550e8400-e29b-41d4-a716-446655440004",
            "assetId": "550e8400-e29b-41d4-a716-446655440002",
            "slot": 1
        }
    ]
}'

Response Example

200 - Example 1

{
    "success": true,
    "updatedRules": [
        {}
    ],
    "message": "string"
}

Modified at 2025-09-25 10:04:16

Get priority allocations for a campaign item

Duplicate an existing campaign