action ndhm_post_v0_5_subscription_requests_cm_init {
  label: "Request for subscription"
  description: "creates a request for subscription. The subscription categories can be for care-contexts linkages or availability of data against existing care-contexts. Note that the requester must have HIU role"
  provider: ndhm
  method: POST
  path: "/v0.5/subscription-requests/cm/init"
  encoding: json
  input: {
    type: "object"
    properties: {
      Authorization: {
        type: "string"
      }
      requestId: {
        type: "string"
        format: "uuid"
        description: "a nonce, unique for each HTTP request."
      }
      subscription: {
        type: "object"
        required: ["categories", "hiu", "patient", "period", "purpose"]
        properties: {
          categories: {
            type: "array"
            items: {
              type: "string"
              enum: ["LINK"]
            }
          }
          hips: {
            type: "array"
            items: {
              type: "object"
              required: ["id"]
              properties: {
                id: {
                  type: "string"
                }
              }
            }
          }
          hiu: {
            type: "object"
            required: ["id"]
            properties: {
              id: {
                type: "string"
              }
            }
          }
          patient: {
            type: "object"
            required: ["id"]
            properties: {
              id: {
                type: "string"
                format: "<user-id>@<ndhm>"
              }
            }
          }
          period: {
            type: "object"
            required: ["from", "to"]
            properties: {
              from: {
                type: "string"
                format: "date-time"
              }
              to: {
                type: "string"
                format: "date-time"
              }
            }
          }
          purpose: {
            type: "object"
            required: ["code", "text"]
            properties: {
              code: {
                type: "string"
                description: "From the fixed set, documented at refUri"
              }
              refUri: {
                type: "string"
                format: "uri"
              }
              text: {
                type: "string"
              }
            }
          }
        }
      }
      timestamp: {
        type: "string"
        format: "date-time"
        description: "Date time format in UTC, includes miliseconds YYYY-MM-DDThh:mm:ss.vZ"
      }
    }
    required: ["Authorization", "requestId", "subscription", "timestamp"]
    additionalProperties: false
  }
  output: {
    type: "object"
    additionalProperties: true
  }
}