{
  "type": "object",
  "properties": {
    "limit": {
      "description": "How many templates to return. Default 5.",
      "maximum": 25,
      "minimum": 1,
      "type": "integer"
    },
    "query": {
      "description": "Title Case phrases separated by commas, the way the catalogue describes itself. Five or six covering occasion, subject and mood.",
      "type": "string"
    },
    "segment": {
      "description": "Optional shape filter, e.g. story or carousel.",
      "type": "string"
    }
  },
  "required": [
    "query"
  ]
}

{
  "type": "object",
  "properties": {
    "count": {
      "description": "Only when uploading the bytes yourself: how many links to mint.",
      "maximum": 10,
      "minimum": 1,
      "type": "integer"
    },
    "files": {
      "description": "The photos themselves, base64 encoded. We store them and hand back a url each. Use this unless you have a reason not to.",
      "items": {
        "properties": {
          "data": {
            "description": "The image file's bytes, base64 encoded.",
            "type": "string"
          },
          "mimeType": {
            "description": "e.g. image/jpeg or image/png.",
            "type": "string"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "mimeType": {
      "description": "The images' media type, e.g. image/png or image/jpeg.",
      "type": "string"
    }
  }
}

{
  "type": "object",
  "properties": {
    "brief": {
      "description": "The SEARCH QUERY for the template catalogue — you write it, we do not build it from anything else. Title Case phrases separated by commas, the way the catalogue describes itself: \"Birthday Party, Friends, Celebration, Confetti, Party Invite\". Five or six covering occasion, subject and mood. Written this way it scores about 0.11 higher than the same intent as a sentence, and a single word is worst of all. If you were given photos, look at them and let what you see inform the phrases.",
      "type": "string"
    },
    "count": {
      "description": "How many finished designs to return. Default 5, at most 10.",
      "maximum": 10,
      "minimum": 1,
      "type": "integer"
    },
    "images": {
      "description": "Publicly reachable image URLs, in placement order.",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "photos": {
      "description": "Photos the person attached in this conversation, in placement order. Use this OR images, not both.",
      "items": {
        "additionalProperties": false,
        "properties": {
          "download_url": {
            "type": "string"
          },
          "file_id": {
            "type": "string"
          },
          "file_name": {
            "type": "string"
          },
          "mime_type": {
            "type": "string"
          }
        },
        "required": [
          "download_url",
          "file_id"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "segment": {
      "description": "Optional shape filter, e.g. story or carousel.",
      "type": "string"
    },
    "text": {
      "description": "The words to put ON the designs — headline first, then any supporting lines. WRITE THESE YOURSELF from the brief: a template ships with the designer's placeholder copy, and leaving it means a coffee shop opening goes out reading whatever they typed. Keep a headline to a few words; templates lay out short lines.",
      "items": {
        "type": "string"
      },
      "type": "array"
    }
  },
  "required": [
    "brief"
  ]
}

{
  "type": "object",
  "properties": {
    "coverId": {
      "description": "Template id, from a search_templates result.",
      "type": "string"
    },
    "images": {
      "description": "Publicly reachable image URLs, in placement order.",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "photos": {
      "description": "Photos the person attached in this conversation, in placement order. Use this OR images, not both.",
      "items": {
        "additionalProperties": false,
        "properties": {
          "download_url": {
            "type": "string"
          },
          "file_id": {
            "type": "string"
          },
          "file_name": {
            "type": "string"
          },
          "mime_type": {
            "type": "string"
          }
        },
        "required": [
          "download_url",
          "file_id"
        ],
        "type": "object"
      },
      "type": "array"
    }
  },
  "required": [
    "coverId"
  ]
}