{"openapi":"3.1.0","info":{"title":"Magic Envelope API","version":"1.0.0","description":"Create and send beautiful invitations and letters. Free, no account. Each guest gets a personal link; use {name} in texts to address them."},"servers":[{"url":"https://magic-envelope.com"}],"components":{"securitySchemes":{"editKey":{"type":"http","scheme":"bearer","description":"The letter's editKey, returned on creation."}},"schemas":{"LetterInput":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"lang":{"default":"en","description":"Language guests read the letter in","type":"string","enum":["es","en","fr","pt","it","de"]},"style":{"default":"parchment","description":"Look of the letter and envelope (see catalog.styles)","type":"string","enum":["parchment","midnight","romance","botanical","notebook","minimal","launch","groovy","deco","ivory","brutal","bubblegum","confetti","typewriter","pocket"]},"preset":{"description":"Start from an occasion preset (pre-filled blocks). Omit for a blank letter.","type":"string","enum":["birthday","wedding","party","baby","dinner","graduation","event","letter"]},"blocks":{"description":"Letter blocks, top to bottom. Replaces the preset's blocks. Use {name} in text to address each guest.","maxItems":60,"type":"array","items":{"oneOf":[{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"heading"},"text":{"type":"string","maxLength":200},"size":{"default":"xl","type":"string","enum":["md","lg","xl"]}},"required":["id","type","text"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"text"},"text":{"type":"string","maxLength":4000},"align":{"default":"center","type":"string","enum":["left","center"]}},"required":["id","type","text"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"image"},"src":{"type":"string","maxLength":2048},"shape":{"default":"wide","type":"string","enum":["wide","square","round"]}},"required":["id","type","src"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"date"},"start":{"type":"string","maxLength":40},"end":{"type":"string","maxLength":40},"title":{"type":"string","maxLength":200},"interactive":{"default":true,"type":"boolean"}},"required":["id","type","start"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"place"},"name":{"type":"string","maxLength":200},"address":{"type":"string","maxLength":200},"interactive":{"default":true,"type":"boolean"}},"required":["id","type","name","address"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"countdown"},"to":{"default":"","type":"string","maxLength":40}},"required":["id","type"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"link"},"label":{"type":"string","maxLength":200},"href":{"type":"string","maxLength":2048},"icon":{"default":"link","type":"string","enum":["link","gift","music","video","map","camera"]},"interactive":{"default":true,"type":"boolean"}},"required":["id","type","label","href"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"qr"},"data":{"type":"string","maxLength":2048},"caption":{"type":"string","maxLength":200}},"required":["id","type","data"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"rsvp"},"channel":{"type":"string","enum":["whatsapp","sms","email"]},"contacts":{"type":"object","properties":{"whatsapp":{"default":"","type":"string","maxLength":200},"sms":{"default":"","type":"string","maxLength":200},"email":{"default":"","type":"string","maxLength":200}}},"deadline":{"type":"string","maxLength":40},"interactive":{"default":true,"type":"boolean"}},"required":["id","type","channel","contacts"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"agenda"},"items":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"time":{"type":"string","maxLength":10},"what":{"type":"string","maxLength":200}},"required":["time","what"]}}},"required":["id","type","items"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"dress"},"text":{"type":"string","maxLength":200},"board":{"default":[],"maxItems":12,"type":"array","items":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"color"},"value":{"type":"string","pattern":"^#[0-9a-f]{6}$"}},"required":["kind","value"]},{"type":"object","properties":{"kind":{"type":"string","const":"emoji"},"value":{"type":"string","maxLength":16}},"required":["kind","value"]},{"type":"object","properties":{"kind":{"type":"string","const":"text"},"value":{"type":"string","maxLength":60}},"required":["kind","value"]},{"type":"object","properties":{"kind":{"type":"string","const":"image"},"value":{"type":"string","maxLength":2048}},"required":["kind","value"]}]}}},"required":["id","type","text"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"gift"},"text":{"type":"string","maxLength":200},"iban":{"type":"string","maxLength":200},"href":{"type":"string","maxLength":2048},"interactive":{"default":true,"type":"boolean"}},"required":["id","type","text"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"signature"},"text":{"type":"string","maxLength":200}},"required":["id","type","text"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"divider"},"style":{"default":"flourish","type":"string","enum":["flourish","stars","line"]}},"required":["id","type"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"music"},"href":{"type":"string","maxLength":2048}},"required":["id","type","href"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"stamp"},"stamp":{"anyOf":[{"type":"string","enum":["love","rose","dove","castle","moon","cake","sunflower","shell","butterfly","star","key","rocket","disco","invader"]},{"type":"string","const":""}]}},"required":["id","type","stamp"]}]}},"custom":{"description":"Overrides on top of the style: accent/paper/ink/envelope colours, head/body fonts","type":"object","properties":{"accent":{"type":"string","pattern":"^#[0-9a-f]{6}$"},"paper":{"type":"string","pattern":"^#[0-9a-f]{6}$"},"ink":{"type":"string","pattern":"^#[0-9a-f]{6}$"},"envelope":{"type":"string","pattern":"^#[0-9a-f]{6}$"},"head":{"type":"string","enum":["medieval","fell","playfair","kalam","inter","grotesk","monoton","righteous","pixel","vt323","cinzel","fredoka","courier","bebas"]},"body":{"type":"string","enum":["medieval","fell","playfair","kalam","inter","grotesk","monoton","righteous","pixel","vt323","cinzel","fredoka","courier","bebas"]}}},"seal":{"description":"Wax seal mark: \"\" none, \"_\" plain, \"icon:<id>\", \"ini:ABC\", \"duo:A|J\"","type":"string","maxLength":16},"sealShape":{"type":"string","enum":["scallop","round","flower","octagon"]},"envelope":{"description":"Envelope slot blocks, partial like letter blocks (see catalog.envelope for each slot's block type)","type":"object","properties":{"blocks":{"type":"object","propertyNames":{"type":"string","enum":["front-center","front-tl","front-tr","front-bl","back-center"]},"additionalProperties":{"oneOf":[{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"heading"},"text":{"type":"string","maxLength":200},"size":{"default":"xl","type":"string","enum":["md","lg","xl"]}},"required":["id","type","text"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"text"},"text":{"type":"string","maxLength":4000},"align":{"default":"center","type":"string","enum":["left","center"]}},"required":["id","type","text"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"image"},"src":{"type":"string","maxLength":2048},"shape":{"default":"wide","type":"string","enum":["wide","square","round"]}},"required":["id","type","src"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"date"},"start":{"type":"string","maxLength":40},"end":{"type":"string","maxLength":40},"title":{"type":"string","maxLength":200},"interactive":{"default":true,"type":"boolean"}},"required":["id","type","start"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"place"},"name":{"type":"string","maxLength":200},"address":{"type":"string","maxLength":200},"interactive":{"default":true,"type":"boolean"}},"required":["id","type","name","address"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"countdown"},"to":{"default":"","type":"string","maxLength":40}},"required":["id","type"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"link"},"label":{"type":"string","maxLength":200},"href":{"type":"string","maxLength":2048},"icon":{"default":"link","type":"string","enum":["link","gift","music","video","map","camera"]},"interactive":{"default":true,"type":"boolean"}},"required":["id","type","label","href"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"qr"},"data":{"type":"string","maxLength":2048},"caption":{"type":"string","maxLength":200}},"required":["id","type","data"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"rsvp"},"channel":{"type":"string","enum":["whatsapp","sms","email"]},"contacts":{"type":"object","properties":{"whatsapp":{"default":"","type":"string","maxLength":200},"sms":{"default":"","type":"string","maxLength":200},"email":{"default":"","type":"string","maxLength":200}}},"deadline":{"type":"string","maxLength":40},"interactive":{"default":true,"type":"boolean"}},"required":["id","type","channel","contacts"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"agenda"},"items":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"time":{"type":"string","maxLength":10},"what":{"type":"string","maxLength":200}},"required":["time","what"]}}},"required":["id","type","items"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"dress"},"text":{"type":"string","maxLength":200},"board":{"default":[],"maxItems":12,"type":"array","items":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"color"},"value":{"type":"string","pattern":"^#[0-9a-f]{6}$"}},"required":["kind","value"]},{"type":"object","properties":{"kind":{"type":"string","const":"emoji"},"value":{"type":"string","maxLength":16}},"required":["kind","value"]},{"type":"object","properties":{"kind":{"type":"string","const":"text"},"value":{"type":"string","maxLength":60}},"required":["kind","value"]},{"type":"object","properties":{"kind":{"type":"string","const":"image"},"value":{"type":"string","maxLength":2048}},"required":["kind","value"]}]}}},"required":["id","type","text"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"gift"},"text":{"type":"string","maxLength":200},"iban":{"type":"string","maxLength":200},"href":{"type":"string","maxLength":2048},"interactive":{"default":true,"type":"boolean"}},"required":["id","type","text"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"signature"},"text":{"type":"string","maxLength":200}},"required":["id","type","text"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"divider"},"style":{"default":"flourish","type":"string","enum":["flourish","stars","line"]}},"required":["id","type"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"music"},"href":{"type":"string","maxLength":2048}},"required":["id","type","href"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"stamp"},"stamp":{"anyOf":[{"type":"string","enum":["love","rose","dove","castle","moon","cake","sunflower","shell","butterfly","star","key","rocket","disco","invader"]},{"type":"string","const":""}]}},"required":["id","type","stamp"]}]}}},"required":["blocks"]},"nameFallback":{"description":"What {name} reads as without a guest (default: \"Dear Guest\" in the letter language)","type":"string","maxLength":60},"guests":{"default":[],"description":"Each guest gets their own addressed link","maxItems":1000,"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":80}},"required":["name"]}}}},"LetterPatch":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"lang":{"default":"en","description":"Language guests read the letter in","type":"string","enum":["es","en","fr","pt","it","de"]},"style":{"default":"parchment","description":"Look of the letter and envelope (see catalog.styles)","type":"string","enum":["parchment","midnight","romance","botanical","notebook","minimal","launch","groovy","deco","ivory","brutal","bubblegum","confetti","typewriter","pocket"]},"preset":{"description":"Start from an occasion preset (pre-filled blocks). Omit for a blank letter.","type":"string","enum":["birthday","wedding","party","baby","dinner","graduation","event","letter"]},"blocks":{"description":"Letter blocks, top to bottom. Replaces the preset's blocks. Use {name} in text to address each guest.","maxItems":60,"type":"array","items":{"oneOf":[{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"heading"},"text":{"type":"string","maxLength":200},"size":{"default":"xl","type":"string","enum":["md","lg","xl"]}},"required":["id","type","text"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"text"},"text":{"type":"string","maxLength":4000},"align":{"default":"center","type":"string","enum":["left","center"]}},"required":["id","type","text"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"image"},"src":{"type":"string","maxLength":2048},"shape":{"default":"wide","type":"string","enum":["wide","square","round"]}},"required":["id","type","src"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"date"},"start":{"type":"string","maxLength":40},"end":{"type":"string","maxLength":40},"title":{"type":"string","maxLength":200},"interactive":{"default":true,"type":"boolean"}},"required":["id","type","start"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"place"},"name":{"type":"string","maxLength":200},"address":{"type":"string","maxLength":200},"interactive":{"default":true,"type":"boolean"}},"required":["id","type","name","address"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"countdown"},"to":{"default":"","type":"string","maxLength":40}},"required":["id","type"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"link"},"label":{"type":"string","maxLength":200},"href":{"type":"string","maxLength":2048},"icon":{"default":"link","type":"string","enum":["link","gift","music","video","map","camera"]},"interactive":{"default":true,"type":"boolean"}},"required":["id","type","label","href"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"qr"},"data":{"type":"string","maxLength":2048},"caption":{"type":"string","maxLength":200}},"required":["id","type","data"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"rsvp"},"channel":{"type":"string","enum":["whatsapp","sms","email"]},"contacts":{"type":"object","properties":{"whatsapp":{"default":"","type":"string","maxLength":200},"sms":{"default":"","type":"string","maxLength":200},"email":{"default":"","type":"string","maxLength":200}}},"deadline":{"type":"string","maxLength":40},"interactive":{"default":true,"type":"boolean"}},"required":["id","type","channel","contacts"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"agenda"},"items":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"time":{"type":"string","maxLength":10},"what":{"type":"string","maxLength":200}},"required":["time","what"]}}},"required":["id","type","items"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"dress"},"text":{"type":"string","maxLength":200},"board":{"default":[],"maxItems":12,"type":"array","items":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"color"},"value":{"type":"string","pattern":"^#[0-9a-f]{6}$"}},"required":["kind","value"]},{"type":"object","properties":{"kind":{"type":"string","const":"emoji"},"value":{"type":"string","maxLength":16}},"required":["kind","value"]},{"type":"object","properties":{"kind":{"type":"string","const":"text"},"value":{"type":"string","maxLength":60}},"required":["kind","value"]},{"type":"object","properties":{"kind":{"type":"string","const":"image"},"value":{"type":"string","maxLength":2048}},"required":["kind","value"]}]}}},"required":["id","type","text"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"gift"},"text":{"type":"string","maxLength":200},"iban":{"type":"string","maxLength":200},"href":{"type":"string","maxLength":2048},"interactive":{"default":true,"type":"boolean"}},"required":["id","type","text"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"signature"},"text":{"type":"string","maxLength":200}},"required":["id","type","text"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"divider"},"style":{"default":"flourish","type":"string","enum":["flourish","stars","line"]}},"required":["id","type"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"music"},"href":{"type":"string","maxLength":2048}},"required":["id","type","href"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"stamp"},"stamp":{"anyOf":[{"type":"string","enum":["love","rose","dove","castle","moon","cake","sunflower","shell","butterfly","star","key","rocket","disco","invader"]},{"type":"string","const":""}]}},"required":["id","type","stamp"]}]}},"custom":{"description":"Overrides on top of the style: accent/paper/ink/envelope colours, head/body fonts","type":"object","properties":{"accent":{"type":"string","pattern":"^#[0-9a-f]{6}$"},"paper":{"type":"string","pattern":"^#[0-9a-f]{6}$"},"ink":{"type":"string","pattern":"^#[0-9a-f]{6}$"},"envelope":{"type":"string","pattern":"^#[0-9a-f]{6}$"},"head":{"type":"string","enum":["medieval","fell","playfair","kalam","inter","grotesk","monoton","righteous","pixel","vt323","cinzel","fredoka","courier","bebas"]},"body":{"type":"string","enum":["medieval","fell","playfair","kalam","inter","grotesk","monoton","righteous","pixel","vt323","cinzel","fredoka","courier","bebas"]}}},"seal":{"description":"Wax seal mark: \"\" none, \"_\" plain, \"icon:<id>\", \"ini:ABC\", \"duo:A|J\"","type":"string","maxLength":16},"sealShape":{"type":"string","enum":["scallop","round","flower","octagon"]},"envelope":{"description":"Envelope slot blocks, partial like letter blocks (see catalog.envelope for each slot's block type)","type":"object","properties":{"blocks":{"type":"object","propertyNames":{"type":"string","enum":["front-center","front-tl","front-tr","front-bl","back-center"]},"additionalProperties":{"oneOf":[{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"heading"},"text":{"type":"string","maxLength":200},"size":{"default":"xl","type":"string","enum":["md","lg","xl"]}},"required":["id","type","text"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"text"},"text":{"type":"string","maxLength":4000},"align":{"default":"center","type":"string","enum":["left","center"]}},"required":["id","type","text"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"image"},"src":{"type":"string","maxLength":2048},"shape":{"default":"wide","type":"string","enum":["wide","square","round"]}},"required":["id","type","src"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"date"},"start":{"type":"string","maxLength":40},"end":{"type":"string","maxLength":40},"title":{"type":"string","maxLength":200},"interactive":{"default":true,"type":"boolean"}},"required":["id","type","start"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"place"},"name":{"type":"string","maxLength":200},"address":{"type":"string","maxLength":200},"interactive":{"default":true,"type":"boolean"}},"required":["id","type","name","address"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"countdown"},"to":{"default":"","type":"string","maxLength":40}},"required":["id","type"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"link"},"label":{"type":"string","maxLength":200},"href":{"type":"string","maxLength":2048},"icon":{"default":"link","type":"string","enum":["link","gift","music","video","map","camera"]},"interactive":{"default":true,"type":"boolean"}},"required":["id","type","label","href"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"qr"},"data":{"type":"string","maxLength":2048},"caption":{"type":"string","maxLength":200}},"required":["id","type","data"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"rsvp"},"channel":{"type":"string","enum":["whatsapp","sms","email"]},"contacts":{"type":"object","properties":{"whatsapp":{"default":"","type":"string","maxLength":200},"sms":{"default":"","type":"string","maxLength":200},"email":{"default":"","type":"string","maxLength":200}}},"deadline":{"type":"string","maxLength":40},"interactive":{"default":true,"type":"boolean"}},"required":["id","type","channel","contacts"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"agenda"},"items":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"time":{"type":"string","maxLength":10},"what":{"type":"string","maxLength":200}},"required":["time","what"]}}},"required":["id","type","items"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"dress"},"text":{"type":"string","maxLength":200},"board":{"default":[],"maxItems":12,"type":"array","items":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"color"},"value":{"type":"string","pattern":"^#[0-9a-f]{6}$"}},"required":["kind","value"]},{"type":"object","properties":{"kind":{"type":"string","const":"emoji"},"value":{"type":"string","maxLength":16}},"required":["kind","value"]},{"type":"object","properties":{"kind":{"type":"string","const":"text"},"value":{"type":"string","maxLength":60}},"required":["kind","value"]},{"type":"object","properties":{"kind":{"type":"string","const":"image"},"value":{"type":"string","maxLength":2048}},"required":["kind","value"]}]}}},"required":["id","type","text"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"gift"},"text":{"type":"string","maxLength":200},"iban":{"type":"string","maxLength":200},"href":{"type":"string","maxLength":2048},"interactive":{"default":true,"type":"boolean"}},"required":["id","type","text"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"signature"},"text":{"type":"string","maxLength":200}},"required":["id","type","text"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"divider"},"style":{"default":"flourish","type":"string","enum":["flourish","stars","line"]}},"required":["id","type"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"music"},"href":{"type":"string","maxLength":2048}},"required":["id","type","href"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"stamp"},"stamp":{"anyOf":[{"type":"string","enum":["love","rose","dove","castle","moon","cake","sunflower","shell","butterfly","star","key","rocket","disco","invader"]},{"type":"string","const":""}]}},"required":["id","type","stamp"]}]}}},"required":["blocks"]},"nameFallback":{"description":"What {name} reads as without a guest (default: \"Dear Guest\" in the letter language)","type":"string","maxLength":60},"guests":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string","minLength":1,"maxLength":80}},"required":["name"]}}}},"Block":{"$schema":"https://json-schema.org/draft/2020-12/schema","oneOf":[{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"heading"},"text":{"type":"string","maxLength":200},"size":{"default":"xl","type":"string","enum":["md","lg","xl"]}},"required":["id","type","text"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"text"},"text":{"type":"string","maxLength":4000},"align":{"default":"center","type":"string","enum":["left","center"]}},"required":["id","type","text"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"image"},"src":{"type":"string","maxLength":2048},"shape":{"default":"wide","type":"string","enum":["wide","square","round"]}},"required":["id","type","src"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"date"},"start":{"type":"string","maxLength":40},"end":{"type":"string","maxLength":40},"title":{"type":"string","maxLength":200},"interactive":{"default":true,"type":"boolean"}},"required":["id","type","start"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"place"},"name":{"type":"string","maxLength":200},"address":{"type":"string","maxLength":200},"interactive":{"default":true,"type":"boolean"}},"required":["id","type","name","address"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"countdown"},"to":{"default":"","type":"string","maxLength":40}},"required":["id","type"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"link"},"label":{"type":"string","maxLength":200},"href":{"type":"string","maxLength":2048},"icon":{"default":"link","type":"string","enum":["link","gift","music","video","map","camera"]},"interactive":{"default":true,"type":"boolean"}},"required":["id","type","label","href"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"qr"},"data":{"type":"string","maxLength":2048},"caption":{"type":"string","maxLength":200}},"required":["id","type","data"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"rsvp"},"channel":{"type":"string","enum":["whatsapp","sms","email"]},"contacts":{"type":"object","properties":{"whatsapp":{"default":"","type":"string","maxLength":200},"sms":{"default":"","type":"string","maxLength":200},"email":{"default":"","type":"string","maxLength":200}}},"deadline":{"type":"string","maxLength":40},"interactive":{"default":true,"type":"boolean"}},"required":["id","type","channel","contacts"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"agenda"},"items":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"time":{"type":"string","maxLength":10},"what":{"type":"string","maxLength":200}},"required":["time","what"]}}},"required":["id","type","items"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"dress"},"text":{"type":"string","maxLength":200},"board":{"default":[],"maxItems":12,"type":"array","items":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"color"},"value":{"type":"string","pattern":"^#[0-9a-f]{6}$"}},"required":["kind","value"]},{"type":"object","properties":{"kind":{"type":"string","const":"emoji"},"value":{"type":"string","maxLength":16}},"required":["kind","value"]},{"type":"object","properties":{"kind":{"type":"string","const":"text"},"value":{"type":"string","maxLength":60}},"required":["kind","value"]},{"type":"object","properties":{"kind":{"type":"string","const":"image"},"value":{"type":"string","maxLength":2048}},"required":["kind","value"]}]}}},"required":["id","type","text"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"gift"},"text":{"type":"string","maxLength":200},"iban":{"type":"string","maxLength":200},"href":{"type":"string","maxLength":2048},"interactive":{"default":true,"type":"boolean"}},"required":["id","type","text"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"signature"},"text":{"type":"string","maxLength":200}},"required":["id","type","text"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"divider"},"style":{"default":"flourish","type":"string","enum":["flourish","stars","line"]}},"required":["id","type"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"music"},"href":{"type":"string","maxLength":2048}},"required":["id","type","href"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"stamp"},"stamp":{"anyOf":[{"type":"string","enum":["love","rose","dove","castle","moon","cake","sunflower","shell","butterfly","star","key","rocket","disco","invader"]},{"type":"string","const":""}]}},"required":["id","type","stamp"]}]},"Card":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"v":{"type":"number","const":1},"lang":{"type":"string","enum":["es","en","fr","pt","it","de"]},"kind":{"type":"string","enum":["birthday","wedding","party","baby","dinner","graduation","event","letter"]},"style":{"type":"string","enum":["parchment","midnight","romance","botanical","notebook","minimal","launch","groovy","deco","ivory","brutal","bubblegum","confetti","typewriter","pocket"]},"custom":{"type":"object","properties":{"accent":{"type":"string","pattern":"^#[0-9a-f]{6}$"},"paper":{"type":"string","pattern":"^#[0-9a-f]{6}$"},"ink":{"type":"string","pattern":"^#[0-9a-f]{6}$"},"envelope":{"type":"string","pattern":"^#[0-9a-f]{6}$"},"head":{"type":"string","enum":["medieval","fell","playfair","kalam","inter","grotesk","monoton","righteous","pixel","vt323","cinzel","fredoka","courier","bebas"]},"body":{"type":"string","enum":["medieval","fell","playfair","kalam","inter","grotesk","monoton","righteous","pixel","vt323","cinzel","fredoka","courier","bebas"]}}},"seal":{"default":"icon:sparkle","type":"string","maxLength":16},"sealShape":{"default":"scallop","type":"string","enum":["scallop","round","flower","octagon"]},"envelope":{"type":"object","properties":{"blocks":{"type":"object","propertyNames":{"type":"string","enum":["front-center","front-tl","front-tr","front-bl","back-center"]},"additionalProperties":{"oneOf":[{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"heading"},"text":{"type":"string","maxLength":200},"size":{"default":"xl","type":"string","enum":["md","lg","xl"]}},"required":["id","type","text"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"text"},"text":{"type":"string","maxLength":4000},"align":{"default":"center","type":"string","enum":["left","center"]}},"required":["id","type","text"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"image"},"src":{"type":"string","maxLength":2048},"shape":{"default":"wide","type":"string","enum":["wide","square","round"]}},"required":["id","type","src"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"date"},"start":{"type":"string","maxLength":40},"end":{"type":"string","maxLength":40},"title":{"type":"string","maxLength":200},"interactive":{"default":true,"type":"boolean"}},"required":["id","type","start"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"place"},"name":{"type":"string","maxLength":200},"address":{"type":"string","maxLength":200},"interactive":{"default":true,"type":"boolean"}},"required":["id","type","name","address"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"countdown"},"to":{"default":"","type":"string","maxLength":40}},"required":["id","type"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"link"},"label":{"type":"string","maxLength":200},"href":{"type":"string","maxLength":2048},"icon":{"default":"link","type":"string","enum":["link","gift","music","video","map","camera"]},"interactive":{"default":true,"type":"boolean"}},"required":["id","type","label","href"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"qr"},"data":{"type":"string","maxLength":2048},"caption":{"type":"string","maxLength":200}},"required":["id","type","data"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"rsvp"},"channel":{"type":"string","enum":["whatsapp","sms","email"]},"contacts":{"type":"object","properties":{"whatsapp":{"default":"","type":"string","maxLength":200},"sms":{"default":"","type":"string","maxLength":200},"email":{"default":"","type":"string","maxLength":200}}},"deadline":{"type":"string","maxLength":40},"interactive":{"default":true,"type":"boolean"}},"required":["id","type","channel","contacts"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"agenda"},"items":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"time":{"type":"string","maxLength":10},"what":{"type":"string","maxLength":200}},"required":["time","what"]}}},"required":["id","type","items"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"dress"},"text":{"type":"string","maxLength":200},"board":{"default":[],"maxItems":12,"type":"array","items":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"color"},"value":{"type":"string","pattern":"^#[0-9a-f]{6}$"}},"required":["kind","value"]},{"type":"object","properties":{"kind":{"type":"string","const":"emoji"},"value":{"type":"string","maxLength":16}},"required":["kind","value"]},{"type":"object","properties":{"kind":{"type":"string","const":"text"},"value":{"type":"string","maxLength":60}},"required":["kind","value"]},{"type":"object","properties":{"kind":{"type":"string","const":"image"},"value":{"type":"string","maxLength":2048}},"required":["kind","value"]}]}}},"required":["id","type","text"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"gift"},"text":{"type":"string","maxLength":200},"iban":{"type":"string","maxLength":200},"href":{"type":"string","maxLength":2048},"interactive":{"default":true,"type":"boolean"}},"required":["id","type","text"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"signature"},"text":{"type":"string","maxLength":200}},"required":["id","type","text"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"divider"},"style":{"default":"flourish","type":"string","enum":["flourish","stars","line"]}},"required":["id","type"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"music"},"href":{"type":"string","maxLength":2048}},"required":["id","type","href"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"stamp"},"stamp":{"anyOf":[{"type":"string","enum":["love","rose","dove","castle","moon","cake","sunflower","shell","butterfly","star","key","rocket","disco","invader"]},{"type":"string","const":""}]}},"required":["id","type","stamp"]}]}}},"required":["blocks"]},"nameFallback":{"type":"string","maxLength":60},"blocks":{"maxItems":60,"type":"array","items":{"oneOf":[{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"heading"},"text":{"type":"string","maxLength":200},"size":{"default":"xl","type":"string","enum":["md","lg","xl"]}},"required":["id","type","text"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"text"},"text":{"type":"string","maxLength":4000},"align":{"default":"center","type":"string","enum":["left","center"]}},"required":["id","type","text"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"image"},"src":{"type":"string","maxLength":2048},"shape":{"default":"wide","type":"string","enum":["wide","square","round"]}},"required":["id","type","src"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"date"},"start":{"type":"string","maxLength":40},"end":{"type":"string","maxLength":40},"title":{"type":"string","maxLength":200},"interactive":{"default":true,"type":"boolean"}},"required":["id","type","start"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"place"},"name":{"type":"string","maxLength":200},"address":{"type":"string","maxLength":200},"interactive":{"default":true,"type":"boolean"}},"required":["id","type","name","address"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"countdown"},"to":{"default":"","type":"string","maxLength":40}},"required":["id","type"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"link"},"label":{"type":"string","maxLength":200},"href":{"type":"string","maxLength":2048},"icon":{"default":"link","type":"string","enum":["link","gift","music","video","map","camera"]},"interactive":{"default":true,"type":"boolean"}},"required":["id","type","label","href"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"qr"},"data":{"type":"string","maxLength":2048},"caption":{"type":"string","maxLength":200}},"required":["id","type","data"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"rsvp"},"channel":{"type":"string","enum":["whatsapp","sms","email"]},"contacts":{"type":"object","properties":{"whatsapp":{"default":"","type":"string","maxLength":200},"sms":{"default":"","type":"string","maxLength":200},"email":{"default":"","type":"string","maxLength":200}}},"deadline":{"type":"string","maxLength":40},"interactive":{"default":true,"type":"boolean"}},"required":["id","type","channel","contacts"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"agenda"},"items":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"time":{"type":"string","maxLength":10},"what":{"type":"string","maxLength":200}},"required":["time","what"]}}},"required":["id","type","items"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"dress"},"text":{"type":"string","maxLength":200},"board":{"default":[],"maxItems":12,"type":"array","items":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"color"},"value":{"type":"string","pattern":"^#[0-9a-f]{6}$"}},"required":["kind","value"]},{"type":"object","properties":{"kind":{"type":"string","const":"emoji"},"value":{"type":"string","maxLength":16}},"required":["kind","value"]},{"type":"object","properties":{"kind":{"type":"string","const":"text"},"value":{"type":"string","maxLength":60}},"required":["kind","value"]},{"type":"object","properties":{"kind":{"type":"string","const":"image"},"value":{"type":"string","maxLength":2048}},"required":["kind","value"]}]}}},"required":["id","type","text"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"gift"},"text":{"type":"string","maxLength":200},"iban":{"type":"string","maxLength":200},"href":{"type":"string","maxLength":2048},"interactive":{"default":true,"type":"boolean"}},"required":["id","type","text"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"signature"},"text":{"type":"string","maxLength":200}},"required":["id","type","text"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"divider"},"style":{"default":"flourish","type":"string","enum":["flourish","stars","line"]}},"required":["id","type"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"music"},"href":{"type":"string","maxLength":2048}},"required":["id","type","href"]},{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"type":{"type":"string","const":"stamp"},"stamp":{"anyOf":[{"type":"string","enum":["love","rose","dove","castle","moon","cake","sunflower","shell","butterfly","star","key","rocket","disco","invader"]},{"type":"string","const":""}]}},"required":["id","type","stamp"]}]}}},"required":["v","lang","kind","style","blocks"]},"LetterLinks":{"type":"object","properties":{"id":{"type":"string"},"editKey":{"type":"string","description":"Secret: needed to read/update. Keep it."},"url":{"type":"string"},"editUrl":{"type":"string"},"previewImage":{"type":"string"},"printUrl":{"type":"string"},"guests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"url":{"type":"string"}}}}}},"Error":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}},"paths":{"/api/v1/catalog":{"get":{"operationId":"getCatalog","summary":"Styles, presets, block types, envelope slots, stamps, seals","responses":{"200":{"description":"Catalog"}}}},"/api/v1/letters":{"post":{"operationId":"createLetter","summary":"Create and publish a letter","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LetterInput"}}}},"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LetterLinks"}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/letters/{id}":{"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"get":{"operationId":"getLetter","summary":"Read a letter","security":[{"editKey":[]}],"responses":{"200":{"description":"Letter and links"},"403":{"description":"Unknown letter or wrong key"}}},"patch":{"operationId":"updateLetter","summary":"Update a letter (links keep working)","security":[{"editKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LetterPatch"}}}},"responses":{"200":{"description":"Updated letter and links"},"403":{"description":"Unknown letter or wrong key"}}}}}}