Skip to main content
POST
Set the payload mapping

Authorizations

Authorization
string
header
required

Bearer authentication using the project Secret Key (prefixed with sk_, or test_sk_ for sandbox). All v4 public endpoints require the Secret Key — see Authentication. Never expose the Secret Key in client-side code.

Path Parameters

config_id
string
required

Remote configuration identifier.

Body

application/json
data
object
required

Full replacement mapping of payload key to SDK-side type. Allowed types: String, Number, Bool, Json, Color, Products, Screens.

Example:

Response

Updated payload mapping

The payload mapping: the key → type schema describing how the SDK should interpret each payload key. This is the schema — not the delivered values (see V4RemoteConfigurationPayload).

object
string
required
Example:

"payload_mapping"

url
string
required
Example:

"/v4/remote-configurations/82a42dc2-76f6-46c2-b883-846acaf2070a/payload-mapping"

config_id
string
required
Example:

"82a42dc2-76f6-46c2-b883-846acaf2070a"

data
object
required

Flat map of payload key to its SDK-side type.

Example: