Pickly

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "question",
    "options"
  ],
  "properties": {
    "options": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "url": {
            "type": "string",
            "description": "Text and place options: an http(s) link, e.g. a menu or a listing."
          },
          "date": {
            "type": "string",
            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
            "description": "Date options: YYYY-MM-DD."
          },
          "note": {
            "type": "string",
            "description": "Date and time options: a short note, e.g. \"after work\"."
          },
          "time": {
            "type": "string",
            "pattern": "^\\d{2}:\\d{2}$",
            "description": "Time options: HH:MM, 24-hour. Optional on date options."
          },
          "title": {
            "type": "string",
            "description": "The option's name. Needed for text and place options."
          },
          "address": {
            "type": "string",
            "description": "Place options: the place's own address, e.g. a restaurant's street address."
          }
        }
      },
      "maxItems": 20,
      "minItems": 2,
      "description": "2 to 20 options, all of the optionKind."
    },
    "question": {
      "type": "string",
      "description": "What the group is deciding, e.g. \"Where do we eat on Friday?\""
    },
    "maxChoices": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "multi polls only: how many options each person may tick. Leave out for no limit."
    },
    "optionKind": {
      "enum": [
        "text",
        "date",
        "time",
        "place"
      ],
      "type": "string",
      "default": "text",
      "description": "What every option is: a named thing, a calendar date, a time of day, or a place."
    },
    "description": {
      "type": "string",
      "description": "Optional extra context shown under the question."
    },
    "votingStyle": {
      "enum": [
        "multi",
        "ranked",
        "score",
        "swipe",
        "availability"
      ],
      "type": "string",
      "default": "multi",
      "description": "How people vote. multi: tick every option that works (the default, good for most choices). ranked: put the options in order; an instant runoff picks the winner. score: 1 to 5 stars each. swipe: yes or no per option, one card at a time. availability: yes, if need be, or no per option; best for finding a date that suits everyone."
    },
    "closesInHours": {
      "type": "number",
      "maximum": 8760,
      "description": "When voting closes, in hours from now. Defaults to 24.",
      "exclusiveMinimum": 0
    }
  }
}

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "poll"
  ],
  "properties": {
    "poll": {
      "type": "string",
      "description": "The poll's link (https://usepickly.com/p/…) or its id."
    }
  }
}