POST/transactional-api/create-communication-template-version

Create Communication Template Version

Creates a new draft version of a communication template.

Authorization: Bearer token (JWT). See Authentication.

Request

curl -L -X POST 'https://{tenantId}.api.england.medicus.health/transactional-api/create-communication-template-version' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer <token>' \
  -d '{
    "templateId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "versionNumber": "string"
  }'

Body parameters

Field	Type	Required	Description
templateId	string<uuid>	Yes	ID of the communication template to create a version for.
versionNumber	string	Yes	Version identifier. Free-form string, for example 1.0 or 2025-01. Must be unique within the template (case-insensitive).

Responses

201 Created.

{
  "id": "00000000-0000-0000-0000-000000000000"
}

400 Invalid request.

3 possible code values

Code	Description	When
missing-required-field	fieldName is required	a required field is absent
invalid-operation	Human-readable reason.	business rule violation
invalid-field	fieldName must be a valid UUID	a UUID field is not a valid UUID

{
  "errors": [
    {
      "code": "missing-required-field",
      "description": "fieldName is required"
    }
  ]
}