experience

Update campaign settings

Save an Experience campaign's settings in place, all or nothing: its name, devices and customers, from the next cycle planned; results continue on the same campaign and take in the change over its next 30 days. Every new cycle uses each customer's newest version, so customerVersionPolicy latest changes nothing and pinned is refused. Its websites, pages, platform, access and mode never change, and an always-on campaign has no schedule to change: each listed customer shops once every UTC month. Nothing is charged at Save: delivered visits accrue against the plan. Pass expectedSettingsRevision from experience_campaign_settings_get; a Save whose settings moved since is refused (STALE_WRITE). Pass reviewedEstimate from experience_campaign_settings_quotes_get to also refuse one whose estimate moved, or null to save at the current estimate. A person confirms it.

post/api/v1/experience/campaign-settings/update

Request

  • Base URL: https://point11.ai
  • URL: https://point11.ai/api/v1/experience/campaign-settings/update
  • Auth: OAuth 2 (authorization code, authorization URL https://auth.point11.ai/oauth2/authorize, token URL https://auth.point11.ai/oauth2/token)

Headers

Point11-Organizationstring uuid

Organization to act in. Required for OAuth bearers; an API key acts in the organization that owns it.

Idempotency-Keystring uuid required

UUID naming this intent. Retry with the same key; reuse for other input is 409.

Point11-Confirm'true' required

Explicit human confirmation of this operation's effect.

Request body

campaignIdstring uuid required

The campaign's id.

expectedSettingsRevisioninteger required

The settingsRevision the settings read (or a quote) returned.

Response

Success.

campaignIdstring uuid required
changedboolean required

False when the Save asked for the settings the campaign has.

settingsRevisioninteger required

The campaign's revision now.

Changes

No recorded changes to this operation across all 1 revision of this API.