Restore template to system defaults

Overview

Clear the company's content overrides (header, body, footer, signature, subject_override) for a type, reverting to system/white-label defaults. Enable/disable and delivery settings are preserved; if the row is left fully default it is deleted.

Prerequisites

• A bearer token. Callable with Partner and Account tokens.

Base URL

Endpoint

POST /api/v1/account/white-label/email-templates/restore-default

Authentication

• Requires a bearer token in the Authorization: Bearer <bearer-token> header.

• Who can call it: Partner and Account tokens.

• Authentication plus an email-template feature check.

• company_id is scoped by an ownership check.

• Platform-owned types are forbidden (403) for non-platform companies.

• Only the reachable companies differ per role.

Rate limit

• No rate limit.

Request body

• Body:

{
  "company_id": 1,
  "type": "user_welcome"
}

Response

• data.status (string) — success.
• data.message (string) — Template restored to default.

200 OK · 200

{
  "data": {
    "status": "success",
    "message": "Template restored to default."
  }
}

422 Validation Error · 422

{
  "message": "The type field is required.",
  "errors": {
    "type": [
      "The type field is required."
    ]
  }
}

Errors

Example request

curl --request POST \
  --url "https://production-api.shoutaboutus.com/api/v1/account/white-label/email-templates/restore-default" \
  --header 'Authorization: Bearer <bearer-token>' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{"company_id": 1, "type": "user_welcome"}'