---
title: "Update Free Rounds"
method: PUT
path: "/free-rounds"
tags: ["Free Rounds"]
---

# Update Free Rounds

`PUT /free-rounds`

Update existing free rounds campaign

## Headers

- `X-REQUEST-SIGN` string, required

## Request body

- UpdateFreeRoundsRequest
  - `id` string, uuid — Free rounds ID (internal). Used as idempotency key if present. One of id or external_id must be provided.
  - `external_id` string — Free rounds ID (external). Used as idempotency key if present. One of id or external_id must be provided.
  - `cid` string, uuid, required — Client's ID (internal)
  - `user_ids` string[] — List of player IDs. if null then campaign is available for all players.
  - `valid_until` string, date-time — End date when free rounds become unavailable. Could be setup later. ISO 8601.

## Response `200`

ok

- UpdateFreeRoundsResponse
  - `id` string, uuid, required — Free rounds ID (internal)
  - `external_id` string, required — Free rounds ID (external). It always provided on create request.

## Other responses

- `401` — Wrong signature or API key
- `404` — Free rounds campaign not found
- `500` — Server error occurred

---

[API](https://skmtc.dev/fastplaynetwork/apis/playhub-core-api.md) · [All operations](https://skmtc.dev/fastplaynetwork/apis/playhub-core-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/fastplaynetwork/playhub-core-api/revisions/2cfd86cc6d48/schema)