action openlinksw_action_help {
  label: "Action help"
  description: "Returns the help text for a given service action"
  provider: openlinksw
  method: GET
  path: "/api/v1/actions/{serviceId}/{actionId}/help"
  encoding: json
  input: {
    type: "object"
    properties: {
      actionId: {
        type: "string"
      }
      serviceId: {
        type: "string"
      }
    }
    required: ["actionId", "serviceId"]
    additionalProperties: false
  }
  output: {
    type: "object"
    required: ["api", "method", "response", "status"]
    properties: {
      api: {
        type: "string"
        description: "The path of the REST API method"
      }
      method: {
        type: "string"
        description: "The name of the REST API method"
      }
      response: {
        type: "object"
        required: ["action_id", "help_text", "service_id"]
        properties: {
          action_id: {
            type: "string"
            description: "A unique one word identifier for the action."
          }
          help_text: {
            type: "string"
            description: "The help text for the action."
          }
          service_id: {
            type: "string"
            description: "A unique one word identifier for the service."
          }
        }
      }
      status: {
        type: "string"
        enum: ["success"]
      }
    }
  }
}