POST/transactional-api/create-document-template

Create Document Template

Creates a new document template.

Authorization: Bearer token (JWT). See Authentication.

Request

curl -L -X POST 'https://{tenantId}.api.england.medicus.health/transactional-api/create-document-template' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer <token>' \
  -d '{
    "name": "Cardiology Referral Letter",
    "description": "Referral letter template used when referring patients to cardiology.",
    "type": "referral-form"
  }'

Body parameters

Field	Type	Required	Description
name	string	Yes	Template name.
description	string	Yes	Template description.
type	enum	Yes	Document template type. One of: document, referral-form.

Responses

201 Created.

Response fields

Field	Type	Description
id	string<uuid>

{
  "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

Response fields

Field	Type	Description
errors[].code	string
errors[].description	string

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