Ugrás a tartalomhoz
Nupty
Miért a Nupty?ÁrakIngyenes eszközökÚtmutatókBelépésKezdjük el
HU·EN
BelépésKezdjük el
  1. Főoldal
  2. MI-asszisztenseknek
  3. API-leírás

API-leírás

A(z) Nupty API egyetlen pár esküvőjén dolgozik: azén, akié az API-kulcs. Ugyanazokból a szabályokból készül, amelyeket a tervező használ, ezért ez a lista mindig teljes. A parancsok leírása angol nyelvű.

https://my.nupty.app · OpenAPI 3.1 · MI-asszisztenseknek

Azonosítás

  • Kulcsot a Beállítások → API-kulcsok alatt lehet készíteni. Minden kéréshez küldd: Authorization: Bearer nupty_…
  • A csak olvasó kulcs csak olvashat; az „olvasás és módosítás” kulcs parancsot is küldhet.
  • Hibás vagy visszavont kulcsra 401 a válasz. Kulcs URL-ben sosem működik.

Végpontok

GET /api/v2/weddingolvasásA teljes esküvő és a revíziója.
GET /api/v2/wedding/revisionolvasásCsak a revízió: változott-e valami.
POST /api/v2/wedding/commandsolvasás és módosításEgy parancs: {"command": {"type": …}}. A válasz az új esküvő.

Hibák

  • 400 INVALID_COMMAND: a parancs nem illik a mezőihez.
  • 403 API_KEY_SCOPE (csak olvasó kulcs), PREMIUM_REQUIRED (okkal), SERVER_ONLY.
  • 409 CONFLICT vagy INVARIANT: közben változott a terv — olvasd újra, és próbáld meg ismét.
  • 422 kóddal: a tervező nemet mondott (például PARTY_SHAPE, TABLE_FULL, ITEM_NOT_FOUND).
  • 429: túl sok kérés ezzel a kulccsal — lassíts.

Parancsok

Minden változtatás ezek egyike. Az „optional” jelölésű mezők elhagyhatók, a többi kötelező.

DetailsVendorsBudgetTo-dosGuestsSeatingBig DayStudioMenu

Details

setDetails — Set wedding details: names, date (exact / month / unknown), guest range or the exact guest estimate (guestCount; it sets the range), ceremony, style template, time format, whether the Big Day board shows prices (showPrices), currency, total budget target, region. Only the given fields change; currency never converts amounts.

MezőTípus
patchobject { partner1Name, partner2Name, dateMode, date, month, guestRange, ceremony, templateIndex, timeFormat, showPrices, currency, budgetTarget, guestCount, region }

finishOnboarding — Mark the first-run questions as answered (the planner stops asking them).

Vendors

activateItem — Add a suggested vendor category (e.g. "fireworks", "bar") to the vendor list.

MezőTípus
itemIdstring ≤ 64

addCustomItem — Add the couple's own vendor type (id chosen by the caller), in a category.

MezőTípus
idstring ≤ 64
categoryplace | food | ceremony | music | media | look | attire | logistics
namestring ≤ 120

setItemStatus — Set a vendor status: idea, comparing, booked or done.

MezőTípus
itemIdstring ≤ 64
statusidea | comparing | booked | done

markItemCovered — Mark a vendor as included in the venue package.

MezőTípus
itemIdstring ≤ 64

markItemNotNeeded — Mark a vendor as not needed.

MezőTípus
itemIdstring ≤ 64

undoItemBanner — Undo "covered" / "not needed" (back to idea or comparing).

MezőTípus
itemIdstring ≤ 64

renameItem — Give a vendor item the couple's own name; on a catalogue item an empty name goes back to the catalogue name.

MezőTípus
itemIdstring ≤ 64
namestring ≤ 120

removeCustomItem — Delete one of the couple's own vendor items (catalogue items can only be marked not needed). Its moments stay, unlinked.

MezőTípus
itemIdstring ≤ 64

restoreItem — Put a deleted own vendor item back with its options, to-dos, payments and notes, re-linking its moments (undo).

MezőTípus
itemobject { id, catalogId, category, name, active, status, budget, chosen, coveredByVenue, statusBeforeVenue, custom, options, todos, payments, notes }
indexinteger 0–10000
linksarray of object { versionId, momentId } (≤ 50)
picks optionalobject

addItemNote — Add a dated entry to a vendor's "Agreements & notes" log (date YYYY-MM-DD or empty; multi-line text).

MezőTípus
itemIdstring ≤ 64
noteIdstring ≤ 64
date"" or date YYYY-MM-DD
textstring ≤ 2000

updateItemNote — Change the date or text of an "Agreements & notes" entry.

MezőTípus
itemIdstring ≤ 64
noteIdstring ≤ 64
patchobject { date, text }

removeItemNote — Remove an "Agreements & notes" entry.

MezőTípus
itemIdstring ≤ 64
noteIdstring ≤ 64

restoreItemNote — Put a removed "Agreements & notes" entry back (undo).

MezőTípus
itemIdstring ≤ 64
noteobject { id, date, text }
indexinteger 0–10000

addOption — Add an option (a concrete vendor / offer) to compare under a vendor item; optional name and fixed amount.

MezőTípus
itemIdstring ≤ 64
optionIdstring ≤ 64
name optionalstring ≤ 200
amount optionalinteger 0–10000000000

updateOption — Change an option: name, price model (fixed / per person / both), amounts, contact, web, notes.

MezőTípus
itemIdstring ≤ 64
optionIdstring ≤ 64
patchobject { name, model, amount, pp, ppChild, contact, web, notes }

setOptionField — Set a comparison field of an option (e.g. capacity, style).

MezőTípus
itemIdstring ≤ 64
optionIdstring ≤ 64
keystring ≤ 40
valuestring ≤ 300

toggleOptionInclude — Venue options: toggle what the venue package includes (catering, stay, decor, music, rentals).

MezőTípus
itemIdstring ≤ 64
optionIdstring ≤ 64
keycatering | stay | decor | music | rentals

rateOption — Rate an option 1–5 for one partner (the same stars again clears it).

MezőTípus
itemIdstring ≤ 64
optionIdstring ≤ 64
partner0 or 1
starsinteger 1–5

toggleChosen — Choose / un-choose an option (multi-choice items keep several).

MezőTípus
itemIdstring ≤ 64
optionIdstring ≤ 64

setChosen — Choose exactly this option (null = none).

MezőTípus
itemIdstring ≤ 64
optionIdstring ≤ 64 or null

removeOption — Remove an option.

MezőTípus
itemIdstring ≤ 64
optionIdstring ≤ 64

restoreOption — Put a removed option back (undo).

MezőTípus
itemIdstring ≤ 64
optionobject { id, name, model, amount, pp, ppChild, ratings, contact, web, notes, fields, includes }
indexinteger 0–10000
chosenboolean
pickedInarray of string ≤ 64 (≤ 20)

Budget

setItemBudget — Set the budget of one vendor item (0 = none).

MezőTípus
itemIdstring ≤ 64
budgetinteger 0–10000000000

addPayment — Add a payment to a vendor item.

MezőTípus
itemIdstring ≤ 64
paymentIdstring ≤ 64

updatePayment — Change a payment: label, amount, due date, paid.

MezőTípus
itemIdstring ≤ 64
paymentIdstring ≤ 64
patchobject { label, amount, due, paid }

removePayment — Remove a payment.

MezőTípus
itemIdstring ≤ 64
paymentIdstring ≤ 64

restorePayment — Put a removed payment back (undo).

MezőTípus
itemIdstring ≤ 64
paymentobject { id, label, amount, due, paid }
indexinteger 0–10000

To-dos

addTodo — Add a to-do, either general (with a section) or on a vendor item, with optional multi-line notes.

MezőTípus
todoIdstring ≤ 64
titlestring ≤ 300
due"" or date YYYY-MM-DD
targetobject { section } or object { itemId }
notes optionalstring ≤ 2000

updateTodo — Change a to-do: title, due date, section, notes (empty = none).

MezőTípus
todoIdstring ≤ 64
itemIdstring ≤ 64 or null
patchobject { title, due, section, notes }

pinTodo — Pin one of the couple's own to-dos to the top of the list (pinned: false unpins).

MezőTípus
todoIdstring ≤ 64
itemIdstring ≤ 64 or null
pinnedboolean

movePinnedTodo — Move a pinned to-do up (-1) or down (1) among the pinned ones.

MezőTípus
todoIdstring ≤ 64
itemIdstring ≤ 64 or null
dir-1 or 1

toggleTodo — Tick / untick a to-do.

MezőTípus
todoIdstring ≤ 64
itemIdstring ≤ 64 or null

removeTodo — Remove a to-do.

MezőTípus
todoIdstring ≤ 64
itemIdstring ≤ 64 or null

dismissSuggestion — Hide a suggested to-do.

MezőTípus
keystring ≤ 200

restoreSuggestion — Show a hidden suggestion again.

MezőTípus
keystring ≤ 200

Guests

addParty — Add one invitation (a party: single, plus-one, couple or family) with its people. The caller chooses the ids; the server picks the RSVP token (send any 16–64 characters as `rsvpToken`; they are replaced). Read the link with GET /api/v2/guests/{partyId}/link.

MezőTípus
partyIdstring ≤ 64
rsvpTokenstring ≤ 64
partyobject { type, people, side, group, priority, email, phone, lang, invitedTo, hotel, bus, notes }

addParties — Add up to 500 invitations at once (bulk import). The server picks every RSVP token, as for addParty.

MezőTípus
partiesarray of object { partyId, rsvpToken, party } (≤ 500)

updateParty — Replace an invitation’s details and people (replies and seats are kept).

MezőTípus
partyIdstring ≤ 64
partyobject { type, people, side, group, priority, email, phone, lang, invitedTo, hotel, bus, notes }

removeParties — Remove invitations (and free their seats).

MezőTípus
partyIdsarray of string ≤ 64 (≤ 2000)

setReply — Record an RSVP answer by hand: waiting, yes (with who is coming) or no, plus diets (free text and fixed `dietTags`), room and bus (null = not answered). Shown as "Manually entered".

MezőTípus
partyIdstring ≤ 64
replywaiting | yes | no
attendingPersonIds optionalarray of string ≤ 64 (≤ 30)
diets optionalobject
dietTags optionalobject
names optionalobject
hotel optionalboolean or null
bus optionalboolean or null

setInvited — Mark invitations as invited without e-mail (paper, WhatsApp): not-sent ones become "waiting for a reply" and use no free send. `invited: false` puts still-waiting ones back to "not invited yet".

MezőTípus
partyIdsarray of string ≤ 64 (≤ 2000)
invitedboolean

newRsvpLink — Give an invitation a new personal RSVP link; the old link stops working. The server picks the new token (send any 16–64 characters; they are replaced).

MezőTípus
partyIdstring ≤ 64
rsvpTokenstring ≤ 64

revertToGuestAnswer — Put back the guest’s own last answer from the RSVP page over changes made by hand (NOTHING_TO_REVERT when the guest never answered online).

MezőTípus
partyIdstring ≤ 64

updateRsvpSettings — RSVP form settings: ask dietary / accommodation / bus, PIN, message templates.

MezőTípus
patchobject { askDietary, askAccommodation, askBus, pin, emailTemplate, textTemplate }

setBusPickupPlace — Where the guest bus picks up.

MezőTípus
placestring ≤ 200

Seating

seatParty — Seat everyone of an invitation who has no seat yet at one table, from `seatIndex` on (all or nothing: NOT_ENOUGH_SEATS).

MezőTípus
tableIdstring ≤ 64
partyIdstring ≤ 64
seatIndex optionalinteger

addTable — Add a table (round, 8 seats; it appears on the floor plan).

MezőTípus
tableIdstring ≤ 64

updateTable — Change a table: name, shape, capacity (2–24).

MezőTípus
tableIdstring ≤ 64
patchobject { name, shape, capacity }

removeTable — Remove a table.

MezőTípus
tableIdstring ≤ 64

seat — Seat one person of an invitation on a given seat.

MezőTípus
tableIdstring ≤ 64
seatIndexinteger
partyIdstring ≤ 64

unseat — Free one seat.

MezőTípus
tableIdstring ≤ 64
seatIndexinteger

seatFirstFree — Seat one person of an invitation on the first free seat of a table.

MezőTípus
tableIdstring ≤ 64
partyIdstring ≤ 64

unseatOne — Free one seat of an invitation at a table.

MezőTípus
tableIdstring ≤ 64
partyIdstring ≤ 64

applySeatingPreset — Lay out a whole empty seat planner at once: "round" (round head table + rounds), "banquet" (long head table + long rows of 20–24) or "mixed" (long head table + rounds), sized for `guests` (default: the guest estimate or the yes count, whichever is larger), on the floor plan with the head table at the front. Table ids are `{presetId}-1`… and `{presetId}-h` (head). Refused once tables exist (TABLES_EXIST) or when the stored room is too small (ROOM_TOO_SMALL).

MezőTípus
presetIdstring ≤ 48
presetround | banquet | mixed
sizeinteger 4–24
guests optionalinteger 1–1000
lang optionalEN | HU

addTablesLike — Add tables with the same shape and capacity as an existing one, numbered after the last "Table n".

MezőTípus
tableIdstring ≤ 64
tableIdsarray of string ≤ 64 (≤ 100)
lang optionalEN | HU

removeTables — Remove several tables at once (frees their seats). `restoreRoom` puts the room size back (undo of applySeatingPreset; null = the automatic room).

MezőTípus
tableIdsarray of string ≤ 64 (≤ 300)
restoreRoom optionalobject { width, length } or null

moveTable — Place a table on the floor plan (centre, metres from the top-left corner).

MezőTípus
tableIdstring ≤ 64
xnumber 0–100
ynumber 0–100

rotateTable — Rotate a table on the floor plan (degrees).

MezőTípus
tableIdstring ≤ 64
rotationinteger 0–359

setFloorSize — Set the room size (metres).

MezőTípus
widthnumber 5–100
lengthnumber 5–100

addFloorElement — Add a dance floor, stage, bar, buffet… to the floor plan.

MezőTípus
elementIdstring ≤ 64
kinddancefloor | stage | bar | buffet | cake | photobooth | entrance | dj | gifts | custom
label optionalstring ≤ 40
x optionalnumber 0–100
y optionalnumber 0–100
w optionalnumber 0.3–50
h optionalnumber 0.3–50
rotation optionalinteger 0–359

updateFloorElement — Move, resize, rotate or rename a floor plan element.

MezőTípus
elementIdstring ≤ 64
patchobject { label, x, y, w, h, rotation }

removeFloorElement — Remove a floor plan element.

MezőTípus
elementIdstring ≤ 64

Big Day

createVersion — Copy a day version into a new alternative day (Premium).

MezőTípus
versionIdstring ≤ 64
namestring ≤ 80
sourceVersionIdstring ≤ 64

renameVersion — Rename a day version.

MezőTípus
versionIdstring ≤ 64
namestring ≤ 80

removeVersion — Remove an alternative day version.

MezőTípus
versionIdstring ≤ 64

restoreVersion — Put a removed version back (undo; Premium).

MezőTípus
versionobject { id, name, isPlan, moments, picks }
indexinteger 0–10000

makePlan — Make an alternative day the plan.

MezőTípus
versionIdstring ≤ 64

useOptionInPlan — Use an option of a vendor in the plan.

MezőTípus
itemIdstring ≤ 64
optionIdstring ≤ 64

useMomentInPlan — Copy a moment from an alternative day into the plan.

MezőTípus
versionIdstring ≤ 64
momentIdstring ≤ 64
newMomentIdstring ≤ 64

addMoment — Add a moment (time, name, lane, icon) to a day version; the plan is the version with isPlan = true.

MezőTípus
versionIdstring ≤ 64
momentobject { id, time, name, lane, icon, link }

updateMoment — Change a moment: name, time, lane, icon, duration; oldPick null dismisses the "in your old plan this moment used…" note a migrated plan may carry.

MezőTípus
versionIdstring ≤ 64
momentIdstring ≤ 64
patchobject { name, time, lane, icon, durationMin, oldPick }

moveMoment — Move a moment to a lane and a time slot.

MezőTípus
versionIdstring ≤ 64
momentIdstring ≤ 64
lanestage | back
slotinteger 0–2160

linkMoment — Link a moment to a vendor item (null unlinks).

MezőTípus
versionIdstring ≤ 64
momentIdstring ≤ 64
itemIdstring ≤ 64 or null

createItemForMoment — Create a vendor item for a moment and link it.

MezőTípus
versionIdstring ≤ 64
momentIdstring ≤ 64
itemIdstring ≤ 64
namestring ≤ 120
categoryplace | food | ceremony | music | media | look | attire | logistics

setMomentOption — Alternative days: pick which option a linked vendor uses.

MezőTípus
versionIdstring ≤ 64
momentIdstring ≤ 64
optionIdstring ≤ 64 or null
followPlan optionalboolean

addOptionForMoment — Add an option to the vendor linked to a moment.

MezőTípus
versionIdstring ≤ 64
momentIdstring ≤ 64
optionIdstring ≤ 64
namestring ≤ 200
amountinteger 0–10000000000

setMomentItemStatus — Set the status of the vendor linked to a moment.

MezőTípus
versionIdstring ≤ 64
momentIdstring ≤ 64
statusidea | comparing | booked | done

duplicateMoment — Duplicate a moment.

MezőTípus
versionIdstring ≤ 64
momentIdstring ≤ 64
newMomentIdstring ≤ 64

removeMoment — Remove a moment.

MezőTípus
versionIdstring ≤ 64
momentIdstring ≤ 64

addItemToDay — Put a vendor item on the plan as a moment.

MezőTípus
itemIdstring ≤ 64
momentIdstring ≤ 64

Studio

setTemplate — Choose the design template (0 blush, 1 midnight, 2 industrial, 3 garden, 4 golden hour).

MezőTípus
templateIndexinteger 0–4

setAccent — Set the couple’s own accent colour (#rrggbb) for the website and printables; null = the template’s.

MezőTípus
accentstring or null

newSiteLink — Give the wedding website a new public link; the old link stops working. The server picks the new slug.

MezőTípus
slugstring

setSiteSection — Show / hide a section of the wedding website.

MezőTípus
keycover | welcome | countdown | day | location | travel | stay | dress | story | gallery | rsvp
onboolean

moveSiteSection — Move a website section up or down.

MezőTípus
keycover | welcome | countdown | day | location | travel | stay | dress | story | gallery | rsvp
dir-1 or 1

setSitePublished — Publish / unpublish the wedding website (publishing needs Premium).

MezőTípus
publishedboolean

updateSite — Change website texts: guest language, welcome, story, dress code, venue name and address, getting there (travelText), where to stay (stayText), RSVP deadline and RSVP note, vendor names on the day timeline (showVendors), search-engine visibility (indexable).

MezőTípus
patchobject { guestLanguage, welcomeText, storyText, dressCode, venueDisplayName, venueAddress, rsvpDeadline, travelText, stayText, rsvpNote, showVendors, indexable }

updatePhoto — Rename a photo.

MezőTípus
photoIdstring ≤ 64
labelstring ≤ 200

removePhoto — Remove a photo.

MezőTípus
photoIdstring ≤ 64

setDesignStatus — Set a design’s status: not started, draft, done.

MezőTípus
keysite | savethedate | invitations | seating | menu | namecards | tablenumbers | welcome | order | thankyou
statusnotStarted | draft | done

setDesignText — Override a text block of a design (null = follow the planner again).

MezőTípus
keysite | savethedate | invitations | seating | menu | namecards | tablenumbers | welcome | order | thankyou
blockstring ≤ 40
textstring ≤ 5000 or null

setDesignPhotos — Set the photos of a design slot, in order.

MezőTípus
keysite | savethedate | invitations | seating | menu | namecards | tablenumbers | welcome | order | thankyou
slotstring ≤ 40
photoIdsarray of string ≤ 64 (≤ 100)

setDesignStyle — Design style: show photo, alignment, paper size, include guests who haven't replied (seating chart, name cards; on unless false), print cards for people without a name (name cards), landscape orientation (every printable with a paper choice), a QR code to the published website (save-the-date, invitation).

MezőTípus
keysite | savethedate | invitations | seating | menu | namecards | tablenumbers | welcome | order | thankyou
patchobject { showPhoto, align, paper, includeUnreplied, printUnnamed, orientation, showQr }

Menu

addMenuSection — Add a section to the table menu (Starters, Main course…).

MezőTípus
sectionIdstring ≤ 64
titlestring ≤ 80
index optionalinteger 0–1000

renameMenuSection — Rename a menu section.

MezőTípus
sectionIdstring ≤ 64
titlestring ≤ 80

moveMenuSection — Move a menu section up or down.

MezőTípus
sectionIdstring ≤ 64
dir-1 or 1

removeMenuSection — Remove a menu section.

MezőTípus
sectionIdstring ≤ 64

restoreMenuSection — Put a removed menu section back (undo).

MezőTípus
sectionobject { id, title, items }
indexinteger 0–1000

addMenuItem — Add a dish or drink to a menu section.

MezőTípus
sectionIdstring ≤ 64
itemIdstring ≤ 64
namestring ≤ 200
note optionalstring ≤ 300

updateMenuItem — Change a dish: name, note.

MezőTípus
sectionIdstring ≤ 64
itemIdstring ≤ 64
patchobject { name, note }

moveMenuItem — Move a dish up or down.

MezőTípus
sectionIdstring ≤ 64
itemIdstring ≤ 64
dir-1 or 1

removeMenuItem — Remove a dish.

MezőTípus
sectionIdstring ≤ 64
itemIdstring ≤ 64

restoreMenuItem — Put a removed dish back (undo).

MezőTípus
sectionIdstring ≤ 64
itemobject { id, name, note }
indexinteger 0–1000

Mit tud a Nupty

A tervező, amit a pár kap, hét területen. Minden oldal felsorolja a funkciókat Ingyenes vagy Prémium jelöléssel, és linkkel a demóhoz.

  • A nagy nap idővonala: A nap pillanatról pillanatra: a Színpad, amit a vendégek látnak, és a Kulisszák a csapatnak.
  • Szolgáltatók és helyszín: Minden ajánlat egy helyen, egymás mellett, az első ötlettől a foglalásig.
  • Vendégek és visszajelzések: A vendéglista, a meghívók és a válaszok, személyenként.
  • Ültetés és teremrajz: Asztalok, helyek és méretarányos teremrajz, a válaszokkal összhangban.
  • Költségvetés és fizetések: Költségvetés, ami követi a döntéseiteket, és minden fizetés a kifizetésig.
  • Design Stúdió: Az esküvői oldal és minden nyomtatvány egy stílusban, a tervetekből kitöltve.
  • Fiók, belépés és MI-asszisztensek: Belépés, a Kezdőlap és a teendők, nyelvek, és MI-asszisztensek, akik segítenek a tervben.

A teljes funkciólista →

Nupty

Ez a ti napotok. Keltsük életre együtt.

Nincs reklám · Nincs kéretlen ajánlat · Az adataitok az EU-ban maradnak

A tervező

  • Az összes funkció
  • Árak

Ingyenes eszközök

  • Esküvői költségkalkulátor
  • Esküvői visszaszámláló
  • MI-asszisztenseknek

Ellenőrzőlisták

  • 12 hónapos esküvői checklista
  • 6 hónapos esküvői checklista
  • 3 hónapos esküvői checklista

Jogi

  • ÁSZF
  • Adatkezelés
  • Cookie-k
  • Elállás
  • Impresszum

Nyelvek

  • Magyar
  • English

Esküvőtervezési tippek, havonta egyszer

Feliratkozás után egy megerősítő e-mailt küldünk. Bármikor leiratkozhatsz.

© 2026 Nupty