action bbci_get_highlights_by_category {
  label: "List the highlights for a category."
  description: "Get the editorial highlights of a given category in TV & iPlayer."
  provider: bbci
  method: GET
  path: "/categories/{category}/highlights"
  encoding: json
  input: {
    type: "object"
    properties: {
      availability: {
        type: "string"
        enum: ["all", "available"]
      }
      category: {
        type: "string"
      }
      lang: {
        type: "string"
        enum: ["en", "cy", "ga", "gd", "pi"]
      }
      mixin: {
        type: "array"
        enum: ["live", "promotions"]
        items: {
          type: "string"
        }
      }
      rights: {
        type: "string"
        enum: ["mobile", "tv", "web"]
      }
    }
    required: ["availability", "category", "lang", "rights"]
    additionalProperties: false
  }
  output: {
    type: "object"
  }
}