---
title: "Replace the payload values"
method: PUT
path: "/remote-configurations/{config_id}/payload"
tags: ["Remote Configurations"]
---

# Replace the payload values

`PUT /remote-configurations/{config_id}/payload`

Replaces the payload **values** delivered to the SDK. Full replace: the supplied `data` object entirely overwrites the stored payload — to change one key, read the current payload, modify it, and send the whole object back. An empty object `{}` clears the payload. Requests are limited to 64 KiB.

## Path parameters

- `config_id` string, required

## Request body

- V4RemoteConfigurationPayloadRequest
  - `data` object, required — Full replacement of the payload values. Must be a JSON object. An empty object `{}` clears the payload. Replaces the stored payload in full — to change one key, read the current payload, modify it, and send the whole object back. Limited to 64 KiB.

## Response `200`

Updated payload values

- V4RemoteConfigurationPayload — The payload **values**: the actual JSON object delivered to the SDK for this configuration. Distinct from the payload mapping, which is the key → type schema.
  - `object` string, required
  - `url` string, required
  - `config_id` string, required
  - `data` object, required — The JSON values served to the SDK. Always a JSON object — `{}` when unset, never an array.

## Other responses

- `400` — Invalid request — e.g. `data` is not a JSON object, or the payload exceeds the 64 KiB limit.
- `401` — Unauthorized
- `404` — Remote configuration not found
- `415` — Unsupported Content-Type
- `500` — Internal error
- `504` — Upstream timeout

---

[API](https://skmtc.net/qonversion/apis/qonversion-rest-api-v4.md) · [All operations](https://skmtc.net/qonversion/apis/qonversion-rest-api-v4/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/qonversion/qonversion-rest-api-v4/versions/e3f72cf8951c/schema)