v2

latestOpenAPI 3.1.12026-07-2613060964.2 KB

Commit Preference Category

Commit draft changes to the preference category to make them live

patch/v1/{workspace}/preference_category/commit/

Path parameters

workspacestring required

Workspace slug (staging, production, etc.)

Query parameters

commit_messagestring required

Commit message describing the changes being made live.

Response

Successfully committed preference category

$schemastring

JSON schema reference for preference category structure

status'draft' | 'active'

Current status of the preference category

version_nointeger

Version number field as an identifier to track the version

commit_messagestring

Commit message describing the changes that were made live

committed_atstring date-time

Timestamp when the changes were committed

Example response

{
  "$schema": "https://schema.suprsend.com/preference_category/v1/schema.json",
  "root_categories": [
    {
      "root_category": "system",
      "sections": [
        {
          "name": "Account Updates",
          "description": "Important account-related notifications",
          "categories": [
            {
              "category": "password-reset",
              "name": "Password Reset",
              "default_preference": "opt_in",
              "default_mandatory_channels": [
                "email"
              ],
              "digest_schedule": {
                "options": [
                  {
                    "time": {
                      "default_value": "00:00"
                    },
                    "dtstart": {
                      "default_value": "2026-06-20T00:00:00Z"
                    }
                  }
                ]
              }
            }
          ]
        }
      ]
    }
  ],
  "status": "active",
  "version_no": 2,
  "commit_message": "Added password-reset category",
  "committed_at": "2025-10-03T09:52:55.273317+00:00"
}