Skip to main content

Promote all pending workflow changes

POST 
/api/v1/notifications/manage/promote-all-changes

Promotes staged workflow changes to the notification provider’s live configuration. Supply changeIds to select changes; omitting it or sending an empty array selects all pending changes. Inspect per-change errors alongside the successful results.

The following access conditions are preserved as declared intent and are not implemented by generated code: Authorized scoped domain action.

Use this in a guide: Welcome a new user with an in-app message

Request​

Responses​

Changes promoted

Promote explicitly selected pending changes; replace changeIds with IDs from get-pending-changes.​

Section ID: DOC-CP-notifications-api-promoteAllChanges#example-notifications-promoteAllChanges-request

Request example

{
  "changeIds": [
    "change_123"
  ]
}

Illustrative response shape; omitted default fields and actual outcomes depend on the operation.​

Section ID: DOC-CP-notifications-api-promoteAllChanges#example-notifications-promoteAllChanges-response

Response example

{
  "promotedCount": 1,
  "promotedIds": [
    "example_123"
  ],
  "errors": [
    {
      "changeId": "example_123",
      "error": "example"
    }
  ]
}

Document ID: DOC-CP-notifications-api-promoteAllChanges. Section identities and revisions.

SectionStable reference
Promote all pending workflow changesDOC-CP-notifications-api-promoteAllChanges#overview
RequestDOC-CP-notifications-api-promoteAllChanges#request
ResponsesDOC-CP-notifications-api-promoteAllChanges#responses