action openlinksw_describe_service {
  label: "Describe service"
  description: "Returns a description of a given service"
  provider: openlinksw
  method: GET
  path: "/api/v1/services/{serviceId}"
  encoding: json
  input: {
    type: "object"
    properties: {
      serviceId: {
        type: "string"
      }
    }
    required: ["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: ["import_source_uri", "service_id", "service_name"]
        properties: {
          description: {
            type: "string"
            description: "A short description of the service."
          }
          import_source_uri: {
            type: "string"
            format: "uri"
            description: "The URI of the source service description document used to load the service into OSDB."
          }
          service_id: {
            type: "string"
            description: "A unique one word identifier for the service."
          }
          service_name: {
            type: "string"
            description: "A word or phrase naming the service."
          }
        }
      }
      status: {
        type: "string"
        enum: ["success"]
      }
    }
  }
}