action groundhog_day_predictions {
  label: "Get predictions for a given year"
  description: "Get all predictions for a given year."
  provider: groundhog_day
  method: GET
  path: "/api/v1/predictions"
  encoding: json
  input: {
    type: "object"
    properties: {
      year: {
        type: "integer"
      }
    }
    additionalProperties: false
  }
  output: {
    type: "object"
    properties: {
      predictions: {
        type: "array"
        items: {
          type: "object"
          description: "An annual prediction of an early spring or a longer winter."
          required: ["year", "shadow", "details"]
          properties: {
            details: {
              type: "string"
            }
            groundhog: {
              type: "object"
              description: "An animal that makes an annual prediction on Groundhog Day."
              required: ["id", "slug", "shortname", "name", "city", "region", "country", "coordinates", "source", "contact", "currentPrediction", "isGroundhog", "type", "active", "description", "image"]
              properties: {
                active: {
                  type: "integer"
                  enum: [0, 1]
                }
                city: {
                  type: "string"
                }
                contact: {
                  type: "string"
                }
                coordinates: {
                  type: "string"
                }
                country: {
                  type: "string"
                }
                currentPrediction: {
                  type: "string"
                }
                description: {
                  type: "string"
                }
                id: {
                  type: "integer"
                }
                image: {
                  type: "string"
                }
                isGroundhog: {
                  type: "integer"
                }
                name: {
                  type: "string"
                }
                predictions: {
                  type: "array"
                  items: {
                    type: "object"
                    additionalProperties: true
                  }
                }
                predictionsCount: {
                  type: "integer"
                  description: "All predictions, excluding nulls."
                }
                region: {
                  type: "string"
                }
                shortname: {
                  type: "string"
                }
                slug: {
                  type: "string"
                }
                source: {
                  type: "string"
                }
                type: {
                  type: "string"
                }
              }
            }
            shadow: {
              type: "integer"
            }
            year: {
              type: "integer"
            }
          }
        }
      }
    }
  }
}