discovery

Get campaign settings quotes

Deprecated: use discovery.campaign-settings-quotes.get.v2 (discovery_campaign_settings_quotes_get_v2), which takes no audience, targetedGroupIds or removeCustomersOutsideAudience: a campaign's audiences are fixed at launch. This version still quotes a change to them. Review a Save of a Discovery campaign's settings before making it, writing nothing: each change and when it starts (from the next run; a run under way finishes on what it reserved), the change in estimated monthly conversations at today's price with any one-time work, Billing's answer to the extra work, how the change reaches results, and who a lower customer count removes. Pass the settingsRevision discovery.campaign-settings.get returned as expectedSettingsRevision; refused when the settings changed since. id is the campaign's id.

get/api/v1/discovery/campaign-settings-quotes/{id}

Request

  • Base URL: https://point11.ai
  • URL: https://point11.ai/api/v1/discovery/campaign-settings-quotes/{id}
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://auth.point11.ai/oauth2/authorize, token URL https://auth.point11.ai/oauth2/token)

Path parameters

idstring uuid required

Discovery campaign id.

Query parameters

expectedSettingsRevisioninteger required

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

namestring

The campaign's new name.

enginesstring[]

The assistants the campaign asks from its next run: the whole set, at least one. Add, remove or swap; past conversations stay.

engineCatchUpboolean

When an assistant is added: also run it once, within a day, for the customers this month's runs already refreshed (true when omitted), so its results are complete this month.

customerCountinteger

How many customers it runs: the campaign's total, or, on a store campaign, the customers per store. Raising it adds eligible customers, then generates the rest; lowering it removes the newest joined first unless removeCustomerIds names who leaves.

addCustomerIdsstring[]

Customers to add; each joins this month's calendar.

removeCustomerIdsstring[]

Customers to remove; each leaves every later run at once and keeps its history.

audience'all' | 'groups'

Who can be added: every eligible customer (all) or members of targetedGroupIds (groups). It never resamples the current customers.

targetedGroupIdsstring[]

The audiences, with audience groups.

removeCustomersOutsideAudienceboolean

With a new audience: also remove the current customers outside it.

removeStoreKeysstring[]

Stores to stop measuring, by key: their customers leave at once and their history stays.

addStoresstring[]

Stores to add, each one JSON-encoded store pick as the update takes it.

Headers

Point11-Organizationstring uuid

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

Response

Success.

settingsRevisioninteger required

The settings revision this quote read; pass it as expectedSettingsRevision.

requiresReviewboolean required

Whether the Save changes money or results, so Billing is asked about its work and a quoted estimate is re-checked; false when it changes only the name.

resultsNotestring nullable required

How the change reaches results; null when results do not change.

Changes

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