Reward Sources

Update reward source

Update a reward source's selection and pricing settings, or archive it by setting status.

patch/v1/programs/{program_id}/reward-sources/{reward_source_id}

Request

Base URL: https://api.scrip.dev
URL: https://api.scrip.dev/v1/programs/{program_id}/reward-sources/{reward_source_id}
Auth: HTTP bearer

Path parameters

program_idstring required

The program's id.

reward_source_idstring required

The reward source's id.

Request body

category_filterstring[]

Category filter ([] clears the filter)

country_filterstring[]

Country filter ([] clears the filter)

default_ratestring

Asset units per currency minor unit of face value (decimal string)

policystring

Product selection: MANUAL or ALL

status'ACTIVE' | 'ARCHIVED'

Set to ARCHIVED to archive the reward source and its rewards, which cannot be undone; send status without other fields.

Example request

{
  "default_rate": "2",
  "policy": "ALL",
  "status": "ARCHIVED"
}

Response

Updated reward source

asset_idstring uuid

Asset participants spend on these rewards

category_filterstring[]

ALL-policy category filter (null = no filter)

country_filterstring[]

ALL-policy country filter (null = no filter)

created_atstring date-time

When the reward source was created (RFC 3339)

default_ratestring

Asset units per currency minor unit of face value (decimal string)

fulfillment_account_idstring uuid

Fulfillment account supplying these products

idstring uuid

The id of the reward source. Use it in reward_source_id fields and paths.

policystring

Product selection: MANUAL (nothing until products are enabled) or ALL

program_idstring uuid

Program this source belongs to

status'ACTIVE' | 'ARCHIVED'

The reward source's lifecycle state: ACTIVE or ARCHIVED.

updated_atstring date-time

When the reward source was last modified (RFC 3339)

Example response

{
  "asset_id": "a3bb189e-8bf9-4c8b-9be0-6b5d2f4e7a02",
  "category_filter": [
    "GIFT_CARD"
  ],
  "country_filter": [
    "US"
  ],
  "created_at": "2027-01-15T10:30:00Z",
  "default_rate": "1.5",
  "fulfillment_account_id": "71f2a9d4-3b6e-4c8a-9f1d-5e2b8c7a0091",
  "id": "9a0c2e4b-6d81-4f35-a7c9-1b3d5f7e9a14",
  "policy": "ALL",
  "program_id": "8f14e45f-ceea-4e70-9df8-2a7d1b3c9f01",
  "status": "ACTIVE",
  "updated_at": "2027-01-15T10:30:00Z"
}

Changes

No recorded changes to this operation across all 1 revision of this API.