Widget

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/weatherai-io/json-schema/weatherai-io-widget-schema.json",
  "title": "Widget",
  "x-generated": "2026-10-31",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/_original/weatherai-io-api-openapi.json#/components/schemas/Widget",
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "location": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string"
        },
        "region": {
          "type": "string"
        },
        "country": {
          "type": "string"
        }
      }
    },
    "activity": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string"
        },
        "name": {
          "type": "string"
        }
      }
    },
    "theme": {
      "type": "string",
      "enum": [
        "auto",
        "light",
        "dark"
      ]
    },
    "best_date": {
      "type": [
        "string",
        "null"
      ],
      "description": "The best go day when more than one day is shown."
    },
    "days": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "date": {
            "type": "string",
            "format": "date"
          },
          "weekday": {
            "type": "string"
          },
          "label": {
            "type": "string",
            "description": "\"Today\", \"Tomorrow\" or the short weekday, by the place's local date."
          },
          "verdict": {
            "type": "string"
          },
          "score": {
            "type": "integer"
          },
          "go": {
            "type": "boolean"
          },
          "window_start": {
            "type": [
              "string",
              "null"
            ]
          },
          "window_end": {
            "type": [
              "string",
              "null"
            ]
          },
          "summary": {
            "type": "string"
          }
        }
      }
    },
    "updated_utc": {
      "type": "string",
      "format": "date-time"
    },
    "link": {
      "type": "string",
      "description": "Link for the required \"Powered by weatherAI.io\" credit."
    }
  }
}