WordPress

Change the selection (plugin)

Called by the plugin when the admin changes the checkboxes in WordPress. Send the version it showed; a newer one gives 409.

put/wordpress/connection/selection

Request

  • Base URL: https://api.hypamoon.com/api/v1
  • URL: https://api.hypamoon.com/api/v1/wordpress/connection/selection
  • Auth: HTTP bearer

Request body

itemsobject

Per inventory key (like content:post, orders or form_entries:wpforms:12) what moves. Keys you leave out keep their current choice.

versioninteger nullable

The selection version you showed the user (selection.version). If it changed meanwhile, nothing changes (409). Leave it out to change it anyway.

from_suggestionboolean nullable

true: apply the open suggestion of suggest_wordpress_selection (items, if given, go on top of it).

include_personal_databoolean nullable

Only after the user explicitly said yes to the question this route returns (409 with question): true turns on the kinds of data with personal data in this change; false leaves them off and saves the rest.

confirm_textstring nullable

With include_personal_data true: the user's answer to the question, word for word. It is kept in the audit log.

start_roundboolean nullable

true: Hypamoon wakes the plugin right away (plugin 1.4.2 and later, plugin_woken in the answer) and it starts sending this selection; otherwise it starts the next time it checks in (when the admin opens Tools > Hypamoon, or within a few minutes by WP-cron).

Response

The new selection.

Changes

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