Batch assign/unassign earning rules

⚠️ BETA endpoint

This is a work-in-progress documentation of a BETA endpoint. The parameters, fields, request and response bodies, and other data may subject to change. If you want to share feedback or improvements, contact Voucherify support or your Technical Account Manager.

Assigns and/or unassigns earning rules to/from a program in a single batch.

POST /v2/loyalties/programs/{id}/earning-rules/batch

Batch assign/unassign earning rules

cURL

curl --request POST \
  --url https://api.voucherify.io/v2/loyalties/programs/{id}/earning-rules/batch \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-App-Id: <api-key>' \
  --header 'X-App-Token: <api-key>' \
  --data '
{
  "assign": [
    {
      "id": "<string>"
    }
  ],
  "unassign": [
    {
      "id": "<string>"
    }
  ]
}
'

200

{
  "assigned": [
    {
      "earning_rule_id": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "object": "<string>"
    }
  ],
  "unassigned": [
    {
      "earning_rule_id": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "object": "<string>"
    }
  ]
}

{
  "code": 123,
  "key": "<string>",
  "message": "<string>",
  "details": "<string>",
  "request_id": "<string>",
  "resource_id": "<string>",
  "resource_type": "<string>"
}

{
  "code": 123,
  "key": "<string>",
  "message": "<string>",
  "details": "<string>",
  "request_id": "<string>",
  "resource_id": "<string>",
  "resource_type": "<string>"
}

{
  "code": 123,
  "key": "<string>",
  "message": "<string>",
  "details": "<string>",
  "request_id": "<string>",
  "resource_id": "<string>",
  "resource_type": "<string>"
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

X-App-Id · string · header · required

X-App-Token · string · header · required

Path Parameters

id · string · required

Unique program identifier

Pattern: ^lprg_[a-f0-9]+$

Body

application/json

assign · object[] | null

Earning rules to assign

Maximum array length: 10

Show child attributes

unassign · object[] | null

Earning rules to unassign

Maximum array length: 10

Show child attributes

Response

200

application/json

Batch processing result

assigned · object[] | null

Successfully assigned earning rules (null if no assign operations)

Show child attributes

unassigned · object[] | null

Successfully unassigned earning rules (null if no unassign operations)

Show child attributes