Skip to main content
PATCH
Change remote configuration status

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
status
enum<string>
required

New status. Allowed transitions: draftactive, draftarchived, activearchived. archived is terminal.

Available options:
draft,
active,
archived

Response

Updated remote configuration with new status.

A named server-driven configuration. The read view returned by the list, create, update, and status endpoints. Only the single-configuration GET additionally embeds the inline payload values (see V4RemoteConfigurationDetail); these endpoints do not.

object
string
required
Example:

"remote_configuration"

id
string
required

Remote configuration identifier (UUID).

Example:

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

url
string
required

Canonical API path.

Example:

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

name
string
required

Display name.

Example:

"Onboarding copy"

status
string
required

Lifecycle status. Only active configurations are served to the SDK. archived is terminal. Change via PATCH /remote-configurations/{config_id}/status.

Example:

"active"

segment_percent
number
required

Percentage (0–100) of the targeted audience that receives this configuration. 100 targets the whole audience.

Required range: 0 <= x <= 100
Example:

100

segmentation_conditions
object[]
required

Targeting rules that narrow the audience. Always present on read; [] when no conditions are set.

priority
integer | null
required

Resolution priority when a user matches multiple configurations (read-only). null until the configuration is first activated.

Example:

1

created_at
string<date-time>
required

ISO 8601 creation timestamp.

Example:

"2025-09-15T12:30:00Z"

updated_at
string<date-time>
required

ISO 8601 last update timestamp.

Example:

"2025-11-03T10:26:40Z"

context_key
string | null

Optional stable key the SDK uses to look up this configuration.

Example:

"onboarding_copy_v1"

started_at
string<date-time> | null

When the configuration was activated. null while in draft.

Example:

"2025-11-03T10:26:40Z"

finished_at
string<date-time> | null

When the configuration was archived. null while not archived.

last_applied_at
string<date-time> | null

When the configuration was last served to a user.