Sign in

v1

latestOpenAPI 3.1.02026-07-227350156.5 KB
Category Action Triggers

Incremental category trigger operations at program scope

Perform incremental operations on category action triggers at the program scope.

See the account-scope PATCH endpoint for full documentation on supported operations (add, remove).

patch/programs/{programId}/category-action-triggers

Request body

operation'add' | 'remove' required

The operation to perform:

  • add: Register new category triggers or update existing ones
  • remove: Remove category triggers (excluded from enrichment lookups)
triggerIdsstring[] nullable

List of trigger IDs to remove. Required and must be non-empty for the remove operation.

Trigger IDs that are not currently active are silently ignored (idempotent).

For add operations, this field is optional and ignored if provided — you may pass null, [], or omit it entirely.

Example request

{
  "operation": "add",
  "categoryTriggers": [
    {
      "id": "travel-reward-1",
      "categoryId": "020-001-000-000",
      "action": {
        "type": "REWARD",
        "rewardPercent": 3,
        "offerId": "travel-3x-promo"
      }
    }
  ],
  "triggerIds": [
    "travel-reward-1",
    "block-gambling"
  ]
}

Response

Remove operation completed successfully

status'succeeded'
versioninteger

The version number of this operation.

Example response

{
  "status": "succeeded",
  "version": 5
}