{"openapi":"3.1.0","info":{"title":"SignUpSpot API","version":"1.0.0","description":"Create and manage SignUpSpot sign-up sheets. Every sheet has two links: the organizer link (https://signup.spot/m/o_…), where it is edited, and the participant link (https://signup.spot/s/p_…), the share link. createSheet works without a session, and the sheet then has no owner until someone opens its organizer link signed in; until then its organizer link is the credential for everything on it and must be treated like a password. Once a sheet has an owner, its organizer link opens only for the owner and the organizers they added: an operation on it answers 401 sign_in_required without a session and 403 organizer_access_required for an account that is not on the sheet's list (unless an organizer set the link to \"Anyone with the link\"). The participant link never needs a session. A SignUpSpot session bearer (Authorization: Bearer <the set-auth-token header from signing in>) is therefore optional on every operation: with one, createSheet makes a sheet owned by that account, an organizer link opens for its organizers, and sign-ups made on a participant link belong to the account. JSON Schemas for the request bodies, and the MCP server, are listed at https://signup.spot/api/schemas.","contact":{"name":"SignUpSpot","url":"https://signup.spot/for-ai"}},"servers":[{"url":"https://signup.spot/api","description":"SignUpSpot API"}],"security":[{},{"sessionBearer":[]}],"paths":{"/v1/sheets":{"post":{"operationId":"createSheet","summary":"Create a sign-up sheet","description":"Create a sheet from a SheetDefinition and get both links back; the sheet is open for sign-ups at once and there is no separate publish step. Without a session the sheet has no owner until someone opens the organizer link signed in (or signs in from that page), and an ownerless sheet with no sign-ups and no edits is removed after a while (getMeta says how long). With a session (Authorization: Bearer <set-auth-token>) the sheet belongs to that account from the start. Over the anonymous create limit the answer is 429 with details.createUrl: hand the user a create link (https://signup.spot/new?t=…) instead.","x-openai-isConsequential":true,"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SheetDefinition"}}}},"responses":{"201":{"description":"Created. Give the user both links. Without a session the sheet has no owner: say the organizer link is private until they open it signed in.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SheetLinks"}}}},"400":{"description":"invalid_definition: the body is not a valid SheetDefinition (unknown keys are rejected).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"rate_limited: too many sheets created without a session in the last hour; details.createUrl is the fallback.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/s/{organizerToken}/definition":{"parameters":[{"name":"organizerToken","in":"path","required":true,"description":"The organizer link's token: the o_… part of https://signup.spot/m/o_…. While the sheet has no owner it is the credential, so treat it like a password; once the sheet has an owner the operation also needs a session of one of its organizers.","schema":{"type":"string","pattern":"^o_[0-9A-Za-z]{22}$"}}],"get":{"operationId":"getDefinition","summary":"Read the sheet as a definition with ids","description":"The sheet as a SheetDefinition with id on the sheet, every section, slot and question. Use those ids in applyPatch and in createSignup's slotId.","x-openai-isConsequential":false,"responses":{"200":{"description":"The definition with ids.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SheetDefinition"}}}},"401":{"description":"sign_in_required: the sheet has an owner, so its organizer link needs a session of one of its organizers.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"forbidden: a participant link was given; the organizer link is needed.; or organizer_access_required: the session's account is not one of the sheet's organizers.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"not_found: no sheet for that token.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"put":{"operationId":"replaceDefinition","summary":"Replace the whole sheet while nobody has signed up","description":"Send a full SheetDefinition: sections and slots whose ids match are updated in place, new ones are created, live ones left out are removed. Allowed only while the sheet has no confirmed sign-ups; afterwards the answer is 409 has_signups and applyPatch is the way to change it. The links never change.","x-openai-isConsequential":true,"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SheetDefinition"}}}},"responses":{"200":{"description":"Replaced.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReplaceDefinitionResponse"}}}},"400":{"description":"invalid_definition.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"sign_in_required: the sheet has an owner, so its organizer link needs a session of one of its organizers.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"forbidden: organizer link needed.; or organizer_access_required: the session's account is not one of the sheet's organizers.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"not_found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"has_signups: someone has signed up, use applyPatch; or id_conflict: an id you supplied belongs to another sheet.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/s/{organizerToken}/apply":{"parameters":[{"name":"organizerToken","in":"path","required":true,"description":"The organizer link's token: the o_… part of https://signup.spot/m/o_…. While the sheet has no owner it is the credential, so treat it like a password; once the sheet has an owner the operation also needs a session of one of its organizers.","schema":{"type":"string","pattern":"^o_[0-9A-Za-z]{22}$"}}],"post":{"operationId":"applyPatch","summary":"Change a live sheet with semantic ops","description":"Apply a SheetPatch (updateSheet, addSection, updateSection, removeSection, addSlots, updateSlot, removeSlot, reorderSlots, reorderSections) in one transaction; a bad id fails the whole patch and nothing changes. Open or close the sheet with updateSheet set.status. If an op would affect existing sign-ups (removing a slot or section that has sign-ups, lowering a capacity below what is taken, changing a slot's time, lowering maxPerSignup below a claim, dropping an answered question) the answer is 409 needs_confirmation with details.impacts and nothing is written: show the impacts to the user, ask, and only if they agree send the same patch again with confirmSignupImpact: true. Confirming a removal cancels the sign-ups on what was removed. dryRun: true returns what the sheet would become, with the impacts, without writing and without the 409.","x-openai-isConsequential":true,"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SheetPatch"}}}},"responses":{"200":{"description":"Applied (or, with dryRun, previewed).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApplyPatchResponse"}}}},"400":{"description":"invalid_patch, or a placement or op the sheet cannot take.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"sign_in_required: the sheet has an owner, so its organizer link needs a session of one of its organizers.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"forbidden: organizer link needed.; or organizer_access_required: the session's account is not one of the sheet's organizers.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"not_found: the sheet, or an id in the ops.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"needs_confirmation (see the description), or id_conflict: an id you supplied belongs to another sheet.","content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/NeedsConfirmationError"},{"$ref":"#/components/schemas/Error"}]}}}}}}},"/v1/s/{token}/meta":{"parameters":[{"name":"token","in":"path","required":true,"description":"Either link's token: o_… from the organizer link (https://signup.spot/m/o_…) or p_… from the participant link (https://signup.spot/s/p_…). What the call may do follows from which one it is.","schema":{"type":"string","pattern":"^[op]_[0-9A-Za-z]{22}$"}}],"get":{"operationId":"getMeta","summary":"Read the sheet's header and totals","description":"Title, status, totals (open spots, confirmed sign-ups) and, on the organizer link, whether the sheet has an owner (hasOwner), how long an ownerless one is kept (unclaimedTtlDays) and, once owned, the share link.","x-openai-isConsequential":false,"responses":{"200":{"description":"The header.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SheetMetaResponse"}}}},"401":{"description":"sign_in_required: the sheet has an owner, so its organizer link needs a session of one of its organizers.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"organizer_access_required: the session's account is not one of the sheet's organizers.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"not_found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/s/{token}/snapshot":{"parameters":[{"name":"token","in":"path","required":true,"description":"Either link's token: o_… from the organizer link (https://signup.spot/m/o_…) or p_… from the participant link (https://signup.spot/s/p_…). What the call may do follows from which one it is.","schema":{"type":"string","pattern":"^[op]_[0-9A-Za-z]{22}$"}}],"get":{"operationId":"getSnapshot","summary":"Read everything on the sheet","description":"The sheet, its sections and slots with ids, and every sign-up with names only. Works with either link; the participant link is the one way to read slot ids without the organizer link.","x-openai-isConsequential":false,"responses":{"200":{"description":"The snapshot.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SnapshotResponse"}}}},"401":{"description":"sign_in_required: the sheet has an owner, so its organizer link needs a session of one of its organizers.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"organizer_access_required: the session's account is not one of the sheet's organizers.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"not_found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/s/{token}/signups":{"parameters":[{"name":"token","in":"path","required":true,"description":"Either link's token: o_… from the organizer link (https://signup.spot/m/o_…) or p_… from the participant link (https://signup.spot/s/p_…). What the call may do follows from which one it is.","schema":{"type":"string","pattern":"^[op]_[0-9A-Za-z]{22}$"}}],"get":{"operationId":"listSignups","summary":"Who is signed up for what","description":"Every confirmed sign-up in sheet order with its section title and slot label, names only (listContacts has emails and phones). On the participant link, other people's sign-ups come as the page shows them: names by the sheet's privacy setting, without answers or comments.","x-openai-isConsequential":false,"responses":{"200":{"description":"The sign-ups.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignupsResponse"}}}},"401":{"description":"sign_in_required: the sheet has an owner, so its organizer link needs a session of one of its organizers.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"organizer_access_required: the session's account is not one of the sheet's organizers.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"not_found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"operationId":"createSignup","summary":"Sign someone up","description":"On the organizer link this is the roster's \"sign up for another person\": the sign-up belongs to no device, and an email names the account it belongs to (created on the spot if unknown). The organizer may sign people up after the sheet has closed. On the participant link it is the page's own sign-up: the response carries an editKey once, which later updateSignup and cancelSignup calls pass as ?editKey=. Strict capacity (409 capacity_exceeded, the message says how many are left), maxPerSignup and required questions (400 invalid) are enforced and a refusal changes nothing. Ask the user before signing someone up.","x-openai-isConsequential":true,"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateSignupRequest"}}}},"responses":{"201":{"description":"Signed up. On the participant link, keep editKey.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignupResponse"}}}},"400":{"description":"invalid_signup (shape) or invalid (over maxPerSignup, a required answer missing).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"sign_in_required: the sheet has an owner, so its organizer link needs a session of one of its organizers.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"organizer_access_required: the session's account is not one of the sheet's organizers.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"not_found: the sheet or the slot.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"capacity_exceeded: the slot is full under strict capacity; or sheet_closed on the participant link.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/s/{token}/signups/{signupId}":{"parameters":[{"name":"token","in":"path","required":true,"description":"Either link's token: o_… from the organizer link (https://signup.spot/m/o_…) or p_… from the participant link (https://signup.spot/s/p_…). What the call may do follows from which one it is.","schema":{"type":"string","pattern":"^[op]_[0-9A-Za-z]{22}$"}},{"name":"signupId","in":"path","required":true,"description":"The sign-up's id, from listSignups or from the response that created it.","schema":{"type":"string","format":"uuid"}}],"patch":{"operationId":"updateSignup","summary":"Change a sign-up","description":"Change a sign-up's quantity, answers or comment; only the fields sent change (answers replaces the whole set). Capacity is re-checked without counting the sign-up's own current quantity. The person and slot cannot change: cancel and create a new sign-up for that. On the participant link, pass the editKey from createSignup.","x-openai-isConsequential":true,"parameters":[{"name":"editKey","in":"query","required":false,"description":"Participant link only: the editKey returned when the sign-up was created on that link, which proves the sign-up is the caller's. Not needed on the organizer link, and not needed when a session for the account the sign-up belongs to is sent.","schema":{"type":"string","minLength":16,"maxLength":64}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateSignupRequest"}}}},"responses":{"200":{"description":"Updated.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignupResponse"}}}},"400":{"description":"invalid_signup, invalid_edit_key, or invalid (limits, answers).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"sign_in_required: the sheet has an owner, so its organizer link needs a session of one of its organizers.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"forbidden: the participant link needs the sign-up's editKey or its account's session.; or organizer_access_required: the session's account is not one of the sheet's organizers.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"not_found: no such live sign-up on this sheet.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"capacity_exceeded or sheet_closed (participant link).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"delete":{"operationId":"cancelSignup","summary":"Cancel a sign-up","description":"Cancels rather than deletes: the row stays, marked organizer_canceled or participant_canceled, so every open page learns of it and the spot is free again. A second cancel returns the same answer. On the participant link, pass the editKey from createSignup. Confirm with the user first: say whose sign-up and for which slot.","x-openai-isConsequential":true,"parameters":[{"name":"editKey","in":"query","required":false,"description":"Participant link only: the editKey returned when the sign-up was created on that link, which proves the sign-up is the caller's. Not needed on the organizer link, and not needed when a session for the account the sign-up belongs to is sent.","schema":{"type":"string","minLength":16,"maxLength":64}}],"responses":{"200":{"description":"Canceled; the signup comes back with status canceled.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignupResponse"}}}},"400":{"description":"invalid_edit_key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"sign_in_required: the sheet has an owner, so its organizer link needs a session of one of its organizers.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"forbidden: the participant link needs the sign-up's editKey or its account's session.; or organizer_access_required: the session's account is not one of the sheet's organizers.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"not_found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/s/{organizerToken}/contacts":{"parameters":[{"name":"organizerToken","in":"path","required":true,"description":"The organizer link's token: the o_… part of https://signup.spot/m/o_…. While the sheet has no owner it is the credential, so treat it like a password; once the sheet has an owner the operation also needs a session of one of its organizers.","schema":{"type":"string","pattern":"^o_[0-9A-Za-z]{22}$"}}],"get":{"operationId":"listContacts","summary":"Participants' contact details","description":"The emails and phone numbers participants chose to leave, with the name and slot of each sign-up, canceled ones included. Organizer link only. Private: only share them with the organizer.","x-openai-isConsequential":false,"responses":{"200":{"description":"The contacts.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContactsResponse"}}}},"401":{"description":"sign_in_required: the sheet has an owner, so its organizer link needs a session of one of its organizers.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"forbidden: a participant link was given.; or organizer_access_required: the session's account is not one of the sheet's organizers.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"not_found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/s/{organizerToken}":{"parameters":[{"name":"organizerToken","in":"path","required":true,"description":"The organizer link's token: the o_… part of https://signup.spot/m/o_…. While the sheet has no owner it is the credential, so treat it like a password; once the sheet has an owner the operation also needs a session of one of its organizers.","schema":{"type":"string","pattern":"^o_[0-9A-Za-z]{22}$"}}],"delete":{"operationId":"deleteUnclaimedSheet","summary":"Delete a sheet nobody owns yet","description":"While a sheet has no owner (getMeta says hasOwner: false), its organizer link can delete it: both links stop working and it leaves every listing. Once someone has claimed it the answer is 403 not_owner and only the owner can delete it, signed in, from SignUpSpot. Confirm with the user first: say the sheet's title and how many sign-ups it has.","x-openai-isConsequential":true,"responses":{"204":{"description":"Deleted."},"401":{"description":"sign_in_required: the sheet has an owner, so its organizer link needs a session of one of its organizers.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"not_owner: the sheet has an owner; or forbidden: a participant link was given.; or organizer_access_required: the session's account is not one of the sheet's organizers.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"not_found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"schemas":{"SheetDefinition":{"type":"object","properties":{"formatVersion":{"type":"number","const":1},"id":{"description":"Ignored; exported definitions carry it.","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"title":{"type":"string","minLength":1,"maxLength":200},"description":{"type":"string","maxLength":5000},"location":{"type":"string","maxLength":500},"organizerName":{"type":"string","maxLength":200},"timezone":{"description":"IANA, e.g. \"America/Chicago\". Defaults to UTC.","type":"string","minLength":1,"maxLength":64},"closesAt":{"description":"When sign-ups close; null or omitted = never.","anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"status":{"description":"Defaults to open.","type":"string","enum":["draft","open"]},"settings":{"type":"object","properties":{"showNames":{"description":"How names show to other participants.","type":"string","enum":["full","initials","hidden"]},"capacityPolicy":{"description":"strict: refuse sign-ups past capacity; overfill: accept them.","type":"string","enum":["strict","overfill"]},"theme":{"description":"The participant page's look; omit for the default, which follows the viewer's light/dark mode.","type":"object","properties":{"preset":{"type":"string","enum":["savvy","peach","mist","honey","nightfall","paper"],"description":"Base look; the other fields override parts of it."},"accent":{"description":"Buttons, links and progress bars.","type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"background":{"description":"Page background; text, borders and fills adapt to it.","type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"titleFont":{"description":"Font for titles.","type":"string","enum":["inter","plus-jakarta-sans","newsreader","dm-sans","source-sans","nunito","space-grotesk","fraunces","playfair","lora","young-serif","nunito-sans","manrope","bricolage","figtree","instrument-serif","libre-caslon","public-sans"]},"bodyFont":{"description":"Font for other text.","type":"string","enum":["inter","plus-jakarta-sans","newsreader","dm-sans","source-sans","nunito","space-grotesk","fraunces","playfair","lora","young-serif","nunito-sans","manrope","bricolage","figtree","instrument-serif","libre-caslon","public-sans"]},"sectionStyle":{"description":"band: tinted title bar; card: bordered card; plain: ruled rows.","type":"string","enum":["plain","card","band"]},"backgroundEffect":{"description":"In the theme's colors. none: flat; glow: corner blooms; wash: accent fade; grain: fine noise; linen: crosshatch.","type":"string","enum":["none","glow","wash","grain","linen"]}},"required":["preset"],"additionalProperties":false},"reminders":{"description":"Emailed to each person signed up before their slot (or its section) starts; undated slots get none. New sheets default to 5 days and 1 day before.","type":"object","properties":{"offsets":{"maxItems":5,"type":"array","items":{"type":"object","properties":{"amount":{"type":"integer","minimum":1,"maximum":9007199254740991},"unit":{"type":"string","enum":["minutes","hours","days"],"description":"days: at 9:00 in the sheet's timezone, that many days before the slot's date; hours, minutes: exactly that long before."}},"required":["amount","unit"]},"description":"Empty for none."}},"required":["offsets"]}},"additionalProperties":false},"sections":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"type":{"type":"string","enum":["timeslot","items","rsvp"],"description":"timeslot: shifts; items: things to bring; rsvp: headcount."},"title":{"type":"string","maxLength":200},"description":{"type":"string","maxLength":2000},"startsAt":{"description":"When the section's activity starts, if scheduled; an items section is headed by it.","anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"endsAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"questions":{"description":"Asked of everyone who signs up in this section.","maxItems":30,"type":"array","items":{"type":"object","properties":{"id":{"description":"Keep an existing id to keep its answers; omit for a new question.","type":"string","minLength":1,"maxLength":64},"label":{"type":"string","minLength":1,"maxLength":200,"description":"e.g. \"Student name\"."},"kind":{"type":"string","enum":["text","select","checkbox","number"]},"required":{"type":"boolean"},"options":{"description":"Choices for kind select.","maxItems":50,"type":"array","items":{"type":"string","minLength":1,"maxLength":200}}},"required":["label","kind"],"additionalProperties":false}},"slots":{"default":[],"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"description":"An existing slot's id, to keep that slot; omit for a new one.","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"label":{"default":"","type":"string","maxLength":200,"description":"What is claimed, e.g. \"Juice boxes\". May be blank for a timed slot."},"category":{"type":"string","maxLength":100,"description":"Group within the section, e.g. \"Drinks\"."},"description":{"type":"string","maxLength":2000,"description":"Shown to participants under the label or time."},"startsAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$","description":"With offset. Required in a timeslot section."},"endsAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"allDay":{"type":"boolean"},"capacity":{"anyOf":[{"type":"integer","minimum":1,"maximum":9007199254740991},{"type":"null"}],"description":"Spots, units or guests in total; null or omitted = unlimited."},"maxPerSignup":{"anyOf":[{"type":"integer","minimum":1,"maximum":9007199254740991},{"type":"null"}],"description":"Cap per sign-up (party size, units per person)."}},"additionalProperties":false}}},"required":["type"],"additionalProperties":false}}},"required":["formatVersion","title","sections"],"additionalProperties":false,"description":"A whole sign-up sheet: title, optional details, and typed sections each holding claimable slots. Section types: timeslot (shifts; capacity = people per shift; startsAt/endsAt in ISO 8601 with offset), items (potluck or supply list; capacity = units needed), rsvp (headcount; capacity = guest cap, maxPerSignup caps a party). Omit capacity for unlimited. Responses carry id on the sheet, sections, slots and questions; omit ids when creating."},"SheetPatch":{"type":"object","properties":{"formatVersion":{"type":"number","const":1},"ops":{"minItems":1,"maxItems":200,"type":"array","items":{"oneOf":[{"type":"object","properties":{"op":{"type":"string","const":"updateSheet"},"set":{"type":"object","properties":{"title":{"type":"string","minLength":1,"maxLength":200},"description":{"type":"string","maxLength":5000},"location":{"type":"string","maxLength":500},"organizerName":{"type":"string","maxLength":200},"timezone":{"type":"string","minLength":1,"maxLength":64},"closesAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"status":{"type":"string","enum":["draft","open","closed","archived"]},"settings":{"type":"object","properties":{"showNames":{"description":"How names show to other participants.","type":"string","enum":["full","initials","hidden"]},"capacityPolicy":{"description":"strict: refuse sign-ups past capacity; overfill: accept them.","type":"string","enum":["strict","overfill"]},"theme":{"description":"The participant page's look; omit for the default, which follows the viewer's light/dark mode.","type":"object","properties":{"preset":{"type":"string","enum":["savvy","peach","mist","honey","nightfall","paper"],"description":"Base look; the other fields override parts of it."},"accent":{"description":"Buttons, links and progress bars.","type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"background":{"description":"Page background; text, borders and fills adapt to it.","type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"titleFont":{"description":"Font for titles.","type":"string","enum":["inter","plus-jakarta-sans","newsreader","dm-sans","source-sans","nunito","space-grotesk","fraunces","playfair","lora","young-serif","nunito-sans","manrope","bricolage","figtree","instrument-serif","libre-caslon","public-sans"]},"bodyFont":{"description":"Font for other text.","type":"string","enum":["inter","plus-jakarta-sans","newsreader","dm-sans","source-sans","nunito","space-grotesk","fraunces","playfair","lora","young-serif","nunito-sans","manrope","bricolage","figtree","instrument-serif","libre-caslon","public-sans"]},"sectionStyle":{"description":"band: tinted title bar; card: bordered card; plain: ruled rows.","type":"string","enum":["plain","card","band"]},"backgroundEffect":{"description":"In the theme's colors. none: flat; glow: corner blooms; wash: accent fade; grain: fine noise; linen: crosshatch.","type":"string","enum":["none","glow","wash","grain","linen"]}},"required":["preset"],"additionalProperties":false},"reminders":{"description":"Emailed to each person signed up before their slot (or its section) starts; undated slots get none. New sheets default to 5 days and 1 day before.","type":"object","properties":{"offsets":{"maxItems":5,"type":"array","items":{"type":"object","properties":{"amount":{"type":"integer","minimum":1,"maximum":9007199254740991},"unit":{"type":"string","enum":["minutes","hours","days"],"description":"days: at 9:00 in the sheet's timezone, that many days before the slot's date; hours, minutes: exactly that long before."}},"required":["amount","unit"]},"description":"Empty for none."}},"required":["offsets"]}},"additionalProperties":false}},"additionalProperties":false}},"required":["op","set"],"additionalProperties":false},{"type":"object","properties":{"op":{"type":"string","const":"addSection"},"section":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"type":{"type":"string","enum":["timeslot","items","rsvp"],"description":"timeslot: shifts; items: things to bring; rsvp: headcount."},"title":{"type":"string","maxLength":200},"description":{"type":"string","maxLength":2000},"startsAt":{"description":"When the section's activity starts, if scheduled; an items section is headed by it.","anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"endsAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"questions":{"description":"Asked of everyone who signs up in this section.","maxItems":30,"type":"array","items":{"type":"object","properties":{"id":{"description":"Keep an existing id to keep its answers; omit for a new question.","type":"string","minLength":1,"maxLength":64},"label":{"type":"string","minLength":1,"maxLength":200,"description":"e.g. \"Student name\"."},"kind":{"type":"string","enum":["text","select","checkbox","number"]},"required":{"type":"boolean"},"options":{"description":"Choices for kind select.","maxItems":50,"type":"array","items":{"type":"string","minLength":1,"maxLength":200}}},"required":["label","kind"],"additionalProperties":false}},"slots":{"default":[],"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"description":"An existing slot's id, to keep that slot; omit for a new one.","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"label":{"default":"","type":"string","maxLength":200,"description":"What is claimed, e.g. \"Juice boxes\". May be blank for a timed slot."},"category":{"type":"string","maxLength":100,"description":"Group within the section, e.g. \"Drinks\"."},"description":{"type":"string","maxLength":2000,"description":"Shown to participants under the label or time."},"startsAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$","description":"With offset. Required in a timeslot section."},"endsAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"allDay":{"type":"boolean"},"capacity":{"anyOf":[{"type":"integer","minimum":1,"maximum":9007199254740991},{"type":"null"}],"description":"Spots, units or guests in total; null or omitted = unlimited."},"maxPerSignup":{"anyOf":[{"type":"integer","minimum":1,"maximum":9007199254740991},{"type":"null"}],"description":"Cap per sign-up (party size, units per person)."}},"additionalProperties":false}}},"required":["type"],"additionalProperties":false},"placement":{"anyOf":[{"type":"object","properties":{"at":{"type":"string","enum":["start","end"]}},"required":["at"],"additionalProperties":false},{"type":"object","properties":{"after":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["after"],"additionalProperties":false},{"type":"object","properties":{"before":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["before"],"additionalProperties":false}],"description":"Where to insert. Defaults to { \"at\": \"end\" }."}},"required":["op","section"],"additionalProperties":false},{"type":"object","properties":{"op":{"type":"string","const":"updateSection"},"sectionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"set":{"type":"object","properties":{"title":{"type":"string","maxLength":200},"description":{"type":"string","maxLength":2000},"startsAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"endsAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"questions":{"maxItems":30,"type":"array","items":{"type":"object","properties":{"id":{"description":"Keep an existing id to keep its answers; omit for a new question.","type":"string","minLength":1,"maxLength":64},"label":{"type":"string","minLength":1,"maxLength":200,"description":"e.g. \"Student name\"."},"kind":{"type":"string","enum":["text","select","checkbox","number"]},"required":{"type":"boolean"},"options":{"description":"Choices for kind select.","maxItems":50,"type":"array","items":{"type":"string","minLength":1,"maxLength":200}}},"required":["label","kind"],"additionalProperties":false}}},"additionalProperties":false}},"required":["op","sectionId","set"],"additionalProperties":false},{"type":"object","properties":{"op":{"type":"string","const":"removeSection"},"sectionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["op","sectionId"],"additionalProperties":false},{"type":"object","properties":{"op":{"type":"string","const":"addSlots"},"sectionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"slots":{"minItems":1,"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"description":"An existing slot's id, to keep that slot; omit for a new one.","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"label":{"default":"","type":"string","maxLength":200,"description":"What is claimed, e.g. \"Juice boxes\". May be blank for a timed slot."},"category":{"type":"string","maxLength":100,"description":"Group within the section, e.g. \"Drinks\"."},"description":{"type":"string","maxLength":2000,"description":"Shown to participants under the label or time."},"startsAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$","description":"With offset. Required in a timeslot section."},"endsAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"allDay":{"type":"boolean"},"capacity":{"anyOf":[{"type":"integer","minimum":1,"maximum":9007199254740991},{"type":"null"}],"description":"Spots, units or guests in total; null or omitted = unlimited."},"maxPerSignup":{"anyOf":[{"type":"integer","minimum":1,"maximum":9007199254740991},{"type":"null"}],"description":"Cap per sign-up (party size, units per person)."}},"additionalProperties":false}},"placement":{"anyOf":[{"type":"object","properties":{"at":{"type":"string","enum":["start","end"]}},"required":["at"],"additionalProperties":false},{"type":"object","properties":{"after":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["after"],"additionalProperties":false},{"type":"object","properties":{"before":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["before"],"additionalProperties":false}],"description":"Where to insert. Defaults to { \"at\": \"end\" }."}},"required":["op","sectionId","slots"],"additionalProperties":false},{"type":"object","properties":{"op":{"type":"string","const":"updateSlot"},"slotId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"set":{"type":"object","properties":{"label":{"type":"string","maxLength":200,"description":"What is claimed, e.g. \"Juice boxes\". May be blank for a timed slot."},"category":{"anyOf":[{"type":"string","maxLength":100,"description":"Group within the section, e.g. \"Drinks\"."},{"type":"null"}]},"description":{"type":"string","maxLength":2000,"description":"Shown to participants under the label or time."},"startsAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$","description":"With offset. Required in a timeslot section."},{"type":"null"}]},"endsAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"allDay":{"type":"boolean"},"capacity":{"anyOf":[{"type":"integer","minimum":1,"maximum":9007199254740991},{"type":"null"}],"description":"Spots, units or guests in total; null or omitted = unlimited."},"maxPerSignup":{"anyOf":[{"type":"integer","minimum":1,"maximum":9007199254740991},{"type":"null"}],"description":"Cap per sign-up (party size, units per person)."}},"additionalProperties":false}},"required":["op","slotId","set"],"additionalProperties":false},{"type":"object","properties":{"op":{"type":"string","const":"removeSlot"},"slotId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["op","slotId"],"additionalProperties":false},{"type":"object","properties":{"op":{"type":"string","const":"reorderSlots"},"sectionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"orderedIds":{"minItems":1,"maxItems":500,"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}},"required":["op","sectionId","orderedIds"],"additionalProperties":false},{"type":"object","properties":{"op":{"type":"string","const":"reorderSections"},"orderedIds":{"minItems":1,"maxItems":50,"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}},"required":["op","orderedIds"],"additionalProperties":false}]}},"confirmSignupImpact":{"description":"Ops that affect existing sign-ups (see PatchImpact) are refused with 409 needs_confirmation, whose details list the impacts, until the same patch is re-sent with this set to true. Show the impacts to the user first. Confirming the removal of a slot or section cancels its confirmed sign-ups with statusReason slot_unavailable.","type":"boolean"},"dryRun":{"description":"Validate the patch and compute its result without writing anything. The response carries the would-be definition, the impacts and dryRun: true, and never answers 409 needs_confirmation.","type":"boolean"}},"required":["formatVersion","ops"],"additionalProperties":false,"description":"An ordered list of semantic operations applied to a live sheet in one transaction. Ids come from getDefinition. Ops never create or edit sign-ups; when they would affect existing ones the server answers 409 needs_confirmation until the same patch is re-sent with confirmSignupImpact: true."},"PatchImpact":{"type":"object","properties":{"code":{"type":"string","enum":["slot_has_signups","section_has_signups","capacity_below_taken","slot_time_changed","max_per_signup_below_taken","questions_replaced_with_answers"],"description":"slot_has_signups: removeSlot on a slot with confirmed sign-ups (confirming cancels them). section_has_signups: removeSection while a slot in it has confirmed sign-ups (confirming cancels them). capacity_below_taken: updateSlot lowers capacity below the quantity already claimed. slot_time_changed: updateSlot changes startsAt, endsAt or allDay on a slot with sign-ups. max_per_signup_below_taken: updateSlot lowers maxPerSignup below what some sign-up already claims. questions_replaced_with_answers: updateSection replaces questions that sign-ups have answered, dropping those answers."},"message":{"type":"string","description":"Human-readable description of the impact, ready to show the user."},"opIndex":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Index into `ops` of the operation that causes this impact."},"slotId":{"description":"The affected slot, for slot-level impacts.","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"slotLabel":{"type":"string"},"sectionId":{"description":"The section the affected slot is in, or the affected section.","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"sectionTitle":{"type":"string"},"signupCount":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"How many confirmed sign-ups are affected."},"quantity":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"The total quantity those sign-ups claim (spots, units or guests)."},"participants":{"maxItems":10,"type":"array","items":{"type":"string"},"description":"Names of the affected participants, at most 10; signupCount says how many there are in all."}},"required":["code","message","opIndex","signupCount","quantity","participants"],"additionalProperties":false,"description":"An operation's effect on existing sign-ups. A patch with impacts is refused until re-sent with confirmSignupImpact: true."},"PatchWarning":{"type":"object","properties":{"code":{"type":"string","enum":["slot_has_signups","section_has_signups","capacity_below_taken"]},"message":{"type":"string"},"slotId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"sectionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"signupCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["code","message"],"additionalProperties":false},"ApplyPatchResponse":{"type":"object","description":"The result of applyPatch: the sheet as it is now (or would be, on a dry run).","properties":{"warnings":{"type":"array","items":{"$ref":"#/components/schemas/PatchWarning"}},"impacts":{"type":"array","items":{"$ref":"#/components/schemas/PatchImpact"},"description":"On a confirmed patch, the impacts that were applied (sign-ups canceled on removed slots). On a dry run, what applying would do."},"definition":{"$ref":"#/components/schemas/SheetDefinition"},"dryRun":{"type":"boolean","const":true,"description":"Present only on a dry run: nothing was written."}},"required":["warnings","impacts","definition"]},"ReplaceDefinitionResponse":{"type":"object","properties":{"definition":{"$ref":"#/components/schemas/SheetDefinition"}},"required":["definition"]},"SheetLinks":{"type":"object","description":"The two links of a sheet. The organizer link is where the sheet is edited and its sign-ups and contact details are managed. A sheet created without a session has no owner, and until someone claims it anyone holding the organizer link can change it: give it to the user, say it is private, never post it publicly. Once a sheet has an owner the organizer link opens only for the owner and the organizers they added, signed in. The participant link is the share link people sign up on.","properties":{"sheetId":{"type":"string","format":"uuid"},"organizerToken":{"type":"string"},"organizerUrl":{"type":"string","format":"uri","description":"https://signup.spot/m/o_…, private while the sheet has no owner; its organizers' once it has one."},"participantToken":{"type":"string"},"participantUrl":{"type":"string","format":"uri","description":"https://signup.spot/s/p_…, the share link."}},"required":["sheetId","organizerToken","organizerUrl","participantToken","participantUrl"]},"SheetSummary":{"type":"object","properties":{"sectionCount":{"type":"integer"},"slotCount":{"type":"integer"},"openSpots":{"type":["integer","null"],"description":"Remaining capacity across limited slots; null when every slot is unlimited."},"confirmedSignups":{"type":"integer"}},"required":["sectionCount","slotCount","openSpots","confirmedSignups"]},"Sheet":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"title":{"type":"string","minLength":1,"maxLength":200},"description":{"type":"string","maxLength":5000},"location":{"type":"string","maxLength":500},"organizerName":{"type":"string","maxLength":200},"timezone":{"type":"string","minLength":1,"maxLength":64},"status":{"type":"string","enum":["draft","open","closed","archived"]},"closesAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"settings":{"type":"object","properties":{"showNames":{"default":"full","description":"How names show to other participants.","type":"string","enum":["full","initials","hidden"]},"capacityPolicy":{"default":"strict","description":"strict: refuse sign-ups past capacity; overfill: accept them.","type":"string","enum":["strict","overfill"]},"theme":{"description":"The participant page's look; omit for the default, which follows the viewer's light/dark mode.","type":"object","properties":{"preset":{"type":"string","enum":["savvy","peach","mist","honey","nightfall","paper"],"description":"Base look; the other fields override parts of it."},"accent":{"description":"Buttons, links and progress bars.","type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"background":{"description":"Page background; text, borders and fills adapt to it.","type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"titleFont":{"description":"Font for titles.","type":"string","enum":["inter","plus-jakarta-sans","newsreader","dm-sans","source-sans","nunito","space-grotesk","fraunces","playfair","lora","young-serif","nunito-sans","manrope","bricolage","figtree","instrument-serif","libre-caslon","public-sans"]},"bodyFont":{"description":"Font for other text.","type":"string","enum":["inter","plus-jakarta-sans","newsreader","dm-sans","source-sans","nunito","space-grotesk","fraunces","playfair","lora","young-serif","nunito-sans","manrope","bricolage","figtree","instrument-serif","libre-caslon","public-sans"]},"sectionStyle":{"description":"band: tinted title bar; card: bordered card; plain: ruled rows.","type":"string","enum":["plain","card","band"]},"backgroundEffect":{"description":"In the theme's colors. none: flat; glow: corner blooms; wash: accent fade; grain: fine noise; linen: crosshatch.","type":"string","enum":["none","glow","wash","grain","linen"]}},"required":["preset"],"additionalProperties":false},"reminders":{"description":"Emailed to each person signed up before their slot (or its section) starts; undated slots get none. New sheets default to 5 days and 1 day before.","type":"object","properties":{"offsets":{"maxItems":5,"type":"array","items":{"type":"object","properties":{"amount":{"type":"integer","minimum":1,"maximum":9007199254740991},"unit":{"type":"string","enum":["minutes","hours","days"],"description":"days: at 9:00 in the sheet's timezone, that many days before the slot's date; hours, minutes: exactly that long before."}},"required":["amount","unit"],"additionalProperties":false},"description":"Empty for none."}},"required":["offsets"],"additionalProperties":false},"logo":{"description":"The sheet's logo, shown above the title. Set by uploading an image to PUT /v1/s/{token}/logo (PNG, JPEG or SVG, up to 2 MB) and cleared with DELETE; the upload writes this field itself.","type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"The image is served at GET /v1/logos/{id}; a new id is minted on every upload."}},"required":["id"],"additionalProperties":false}},"required":["showNames","capacityPolicy"],"additionalProperties":false},"docVersion":{"type":"number","const":1},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"_deleted":{"type":"boolean"}},"required":["id","title","description","location","organizerName","timezone","status","closesAt","settings","docVersion","createdAt","updatedAt","_deleted"],"additionalProperties":false},"Section":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"sheetId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"type":{"type":"string","enum":["timeslot","items","rsvp"]},"title":{"type":"string","maxLength":200},"description":{"type":"string","maxLength":2000},"position":{"type":"string","minLength":1,"maxLength":64},"startsAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"endsAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"questions":{"maxItems":30,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":64},"label":{"type":"string","minLength":1,"maxLength":200},"kind":{"type":"string","enum":["text","select","checkbox","number"]},"required":{"default":false,"type":"boolean"},"options":{"maxItems":50,"type":"array","items":{"type":"string","minLength":1,"maxLength":200}}},"required":["id","label","kind","required"],"additionalProperties":false}},"recurrence":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"null"}]},"docVersion":{"type":"number","const":1},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"_deleted":{"type":"boolean"}},"required":["id","sheetId","type","title","description","position","startsAt","endsAt","questions","recurrence","docVersion","createdAt","updatedAt","_deleted"],"additionalProperties":false},"Slot":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"sheetId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"sectionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"position":{"type":"string","minLength":1,"maxLength":64},"label":{"type":"string","maxLength":200},"category":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}]},"startsAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"endsAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"allDay":{"type":"boolean"},"capacity":{"anyOf":[{"type":"integer","minimum":1,"maximum":9007199254740991},{"type":"null"}]},"maxPerSignup":{"anyOf":[{"type":"integer","minimum":1,"maximum":9007199254740991},{"type":"null"}]},"occurrenceKey":{"anyOf":[{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},{"type":"null"}]},"isDetached":{"type":"boolean"},"price":{"anyOf":[{"type":"object","properties":{"amountCents":{"type":"integer","minimum":0,"maximum":9007199254740991},"currency":{"type":"string","minLength":3,"maxLength":3}},"required":["amountCents","currency"],"additionalProperties":false},{"type":"null"}]},"description":{"default":"","type":"string","maxLength":2000},"image":{"default":null,"anyOf":[{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"The image is served at GET /v1/slot-images/{id}; a new id is minted on every upload."}},"required":["id"],"additionalProperties":false},{"type":"null"}]},"link":{"default":null,"anyOf":[{"type":"string","maxLength":2048,"format":"uri","description":"The item's product page. Server-owned: set by PUT /v1/s/{organizerToken}/slots/{slotId}/link, which also reads the page for a name and picture; a push or patch never sets it."},{"type":"null"}]},"docVersion":{"type":"number","const":1},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"_deleted":{"type":"boolean"}},"required":["id","sheetId","sectionId","position","label","category","startsAt","endsAt","allDay","capacity","maxPerSignup","occurrenceKey","isDetached","price","description","image","link","docVersion","createdAt","updatedAt","_deleted"],"additionalProperties":false},"Signup":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"sheetId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"slotId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"participantName":{"type":"string","minLength":1,"maxLength":200},"quantity":{"type":"integer","minimum":1,"maximum":10000},"answers":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"anyOf":[{"type":"string","maxLength":1000},{"type":"number"},{"type":"boolean"}]}},"comment":{"type":"string","maxLength":1000},"status":{"type":"string","enum":["confirmed","canceled"]},"statusReason":{"anyOf":[{"type":"string","enum":["participant_canceled","organizer_canceled","capacity_exceeded","slot_unavailable","sheet_closed","invalid"]},{"type":"null"}]},"clientId":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}]},"attendanceConfirmedAt":{"default":null,"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"docVersion":{"type":"number","const":1},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"_deleted":{"type":"boolean"}},"required":["id","sheetId","slotId","participantName","quantity","answers","comment","status","statusReason","clientId","attendanceConfirmedAt","docVersion","createdAt","updatedAt","_deleted"],"additionalProperties":false,"description":"A sign-up as every page sees it: names and answers, never emails or phones (listContacts has those). status canceled with a statusReason marks a canceled one."},"SheetMetaResponse":{"type":"object","description":"The sheet's header: what the link opens, how full it is, and (organizer link) whether it has an owner.","properties":{"sheetId":{"type":"string","format":"uuid"},"role":{"type":"string","enum":["organizer","participant"],"description":"Which link the token is."},"sheet":{"$ref":"#/components/schemas/Sheet"},"summary":{"$ref":"#/components/schemas/SheetSummary"},"seq":{"type":"integer"},"isOwner":{"type":"boolean","description":"Whether the session on the request owns the sheet: always on the organizer link (false without a session), on the participant link only with a session."},"hasOwner":{"type":"boolean","description":"Organizer link only: false while nobody has claimed the sheet (created without a session). Tell the user to open the organizer link signed in to keep it."},"unclaimedTtlDays":{"type":"integer","description":"Organizer link only, while the sheet has no owner: an ownerless sheet with no confirmed sign-ups and no edits for this many days is removed."},"participantToken":{"type":"string","description":"Organizer link only, once the sheet has an owner."},"participantUrl":{"type":"string","format":"uri","description":"Organizer link only, once the sheet has an owner: the share link."},"mySignupIds":{"type":"array","items":{"type":"string","format":"uuid"}}},"required":["sheetId","role","sheet","summary","seq"]},"SnapshotResponse":{"type":"object","description":"Everything on the sheet: the sheet, its sections and slots (with ids), and every sign-up (names only).","properties":{"role":{"type":"string","enum":["organizer","participant"]},"sheet":{"$ref":"#/components/schemas/Sheet"},"sections":{"type":"array","items":{"$ref":"#/components/schemas/Section"}},"slots":{"type":"array","items":{"$ref":"#/components/schemas/Slot"}},"signups":{"type":"array","items":{"$ref":"#/components/schemas/Signup"}},"seq":{"type":"integer"},"ownerName":{"type":"string","description":"How the owner is credited as the organizer; empty while unowned."}},"required":["role","sheet","sections","slots","signups","seq","ownerName"]},"SignupSummary":{"allOf":[{"$ref":"#/components/schemas/Signup"},{"type":"object","properties":{"sectionId":{"type":"string","format":"uuid","description":"The section the slot sits in."},"sectionTitle":{"type":"string"},"slotLabel":{"type":"string"}},"required":["sectionId","sectionTitle","slotLabel"]}]},"SignupsResponse":{"type":"object","properties":{"signups":{"type":"array","items":{"$ref":"#/components/schemas/SignupSummary"},"description":"Every confirmed sign-up in sheet order. On the participant link, other people's sign-ups come as the page shows them: names by the sheet's privacy setting, without answers or comments."}},"required":["signups"]},"CreateSignupRequest":{"type":"object","properties":{"slotId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"A slot of this sheet (ids come from GET …/definition or …/snapshot)."},"participantName":{"type":"string","minLength":1,"maxLength":200},"quantity":{"type":"integer","minimum":1,"maximum":10000,"description":"items: units brought; rsvp: headcount incl. guests; timeslot: usually 1. Default 1."},"answers":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"anyOf":[{"type":"string","maxLength":1000},{"type":"number"},{"type":"boolean"}]},"description":"Answers to the section's questions, keyed by question id."},"comment":{"type":"string","maxLength":1000,"description":"A note from the participant."},"email":{"description":"Contact email, seen by the organizer only; also the account the signup belongs to.","type":"string","maxLength":254,"format":"email","pattern":"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"phone":{"description":"Contact phone, seen by the organizer only.","type":"string","maxLength":40},"onBehalf":{"description":"Participant link with a session: this signup is for someone other than the signed-in account, so it is not filed under that account. Ignored on the organizer link and without a session.","type":"boolean"}},"required":["slotId","participantName"],"additionalProperties":false,"description":"Sign someone up for a slot. slotId is a slot of this sheet (ids from getDefinition on the organizer link or getSnapshot on either). quantity defaults to 1: units brought (items), headcount (rsvp) or spots (timeslot). An email also makes the sign-up belong to that person's account, so they see it after signing in; email and phone are only ever shown to the organizer."},"UpdateSignupRequest":{"type":"object","properties":{"quantity":{"type":"integer","minimum":1,"maximum":10000,"description":"items: units brought; rsvp: headcount incl. guests; timeslot: usually 1. Default 1."},"answers":{"description":"Replaces every answer: send the full set.","type":"object","propertyNames":{"type":"string"},"additionalProperties":{"anyOf":[{"type":"string","maxLength":1000},{"type":"number"},{"type":"boolean"}]}},"comment":{"type":"string","maxLength":1000,"description":"A note from the participant."}},"additionalProperties":false},"SignupResponse":{"type":"object","properties":{"signup":{"$ref":"#/components/schemas/Signup"},"editKey":{"type":"string","description":"Participant link only, from createSignup, once: keep it and pass it as ?editKey= on updateSignup and cancelSignup for this sign-up."}},"required":["signup"]},"ContactRecord":{"type":"object","properties":{"signupId":{"type":"string","format":"uuid"},"participantName":{"type":"string"},"slotLabel":{"type":"string"},"email":{"type":["string","null"]},"phone":{"type":["string","null"]},"image":{"type":["string","null"],"description":"The profile picture of the account the signup belongs to, when it has one."}},"required":["signupId","participantName","slotLabel","email","phone","image"]},"ContactsResponse":{"type":"object","properties":{"contacts":{"type":"array","items":{"$ref":"#/components/schemas/ContactRecord"},"description":"Every sign-up of the sheet, canceled ones included, with the contact details its participant left."}},"required":["contacts"]},"Error":{"type":"object","description":"Every error: a code the caller can act on and a message ready to show the user.","properties":{"error":{"type":"object","properties":{"code":{"type":"string","description":"invalid_definition, invalid_patch, invalid_signup (400, details: the validation issues); not_found (404); forbidden (403, a participant link on an organizer call, or a sign-up that is not the caller's); not_owner (403, deleting a sheet someone owns); needs_confirmation, has_signups, id_conflict, capacity_exceeded, sheet_closed, already_owned (409); rate_limited (429)."},"message":{"type":"string"},"details":{"description":"Code-specific. needs_confirmation: { impacts: PatchImpact[] }. rate_limited on createSheet: { createUrl } to fall back to a create link. Validation errors: the issues."}},"required":["code","message"]}},"required":["error"]},"NeedsConfirmationError":{"type":"object","description":"409 needs_confirmation: the patch would affect existing sign-ups, so nothing was changed. Show details.impacts to the user and, if they agree, send the same patch again with confirmSignupImpact: true.","properties":{"error":{"type":"object","properties":{"code":{"type":"string","const":"needs_confirmation"},"message":{"type":"string"},"details":{"type":"object","properties":{"impacts":{"type":"array","items":{"$ref":"#/components/schemas/PatchImpact"}}},"required":["impacts"]}},"required":["code","message","details"]}},"required":["error"]}},"securitySchemes":{"sessionBearer":{"type":"http","scheme":"bearer","description":"A SignUpSpot session: the set-auth-token response header of POST /v1/auth/sign-in/email-otp. Optional everywhere; needed on an organizer link once its sheet has an owner."}}}}