v2

latestOpenAPI 3.1.02026-07-26102336742.6 KB

Gifting

Update gifting config

Writes the four creator-controlled gifting rule fields. Validation (duration 20-180s, valid shipping/products) and the one-platform-per-shop mutex are enforced server-side. Upserts: a first-ever PUT materializes the config row.

put/open-api/v1.0/gifting/config

Request body

enabledboolean required

Master flag. Off pauses purchasability without losing the rest.

entryTimeLimitSecondsinteger required

Entry time limit in seconds. Validated 20-180.

Response

enabledboolean required

Master "gift while live" flag.

entryTimeLimitSecondsinteger required

Entry time limit in seconds (20-180), maps to the giveaway duration.

platform'TWITCH' | 'STREAMELEMENTS' | 'OPEN_API' | 'NOT_SELECTED' required

Current giveaway platform owning the shop's single gifting slot. Read-only conflict signal — TWITCH or STREAMELEMENTS means another integration owns the slot. A Kick shop operates on the OPEN_API slot.