Change remote configuration status
Changes the status of a remote configuration. Allowed transitions: draft → active, draft → archived, active → archived. Archiving is terminal — an archived configuration can only be deleted. Only active configurations are served to the SDK.
Authorizations
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
Remote configuration identifier.
Body
New status. Allowed transitions: draft → active, draft → archived,
active → archived. archived is terminal.
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.
"remote_configuration"
Remote configuration identifier (UUID).
"82a42dc2-76f6-46c2-b883-846acaf2070a"
Canonical API path.
"/v4/remote-configurations/82a42dc2-76f6-46c2-b883-846acaf2070a"
Display name.
"Onboarding copy"
Lifecycle status. Only active configurations are served to the SDK.
archived is terminal. Change via PATCH /remote-configurations/{config_id}/status.
"active"
Percentage (0–100) of the targeted audience that receives this
configuration. 100 targets the whole audience.
0 <= x <= 100100
Targeting rules that narrow the audience. Always present on read; []
when no conditions are set.
Resolution priority when a user matches multiple configurations
(read-only). null until the configuration is first activated.
1
ISO 8601 creation timestamp.
"2025-09-15T12:30:00Z"
ISO 8601 last update timestamp.
"2025-11-03T10:26:40Z"
Optional stable key the SDK uses to look up this configuration.
"onboarding_copy_v1"
When the configuration was activated. null while in draft.
"2025-11-03T10:26:40Z"
When the configuration was archived. null while not archived.
When the configuration was last served to a user.