Wedding Seat

Create a new anonymous Wedding Seat project (no login). Returns a projectKey (your secret handle for all later calls) plus the workspace URL the couple opens in a browser. The projectKey is the ONLY way to access the project again — keep it.

{
  "type": "object",
  "properties": {
    "names": {
      "type": "string",
      "description": "Couple's names, e.g. 'Ana & Marko' — becomes the project title"
    },
    "date": {
      "type": "string",
      "description": "Reception date, ISO 8601 (YYYY-MM-DD)"
    },
    "locale": {
      "type": "string",
      "description": "UI language code (e.g. en, sr, de); defaults to en"
    },
    "culture": {
      "type": "string",
      "description": "Culture-pack key from list_culture_packs; omit to auto-pick"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Add guests to a project (deduped by name+email). Provide the projectKey from create_wedding_project and a list of guests.

{
  "type": "object",
  "properties": {
    "projectKey": {
      "type": "string",
      "description": "The projectKey returned by create_wedding_project"
    },
    "guests": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "Full name; split into first/last if firstName is absent"
          },
          "firstName": {
            "type": "string"
          },
          "lastName": {
            "type": "string"
          },
          "side": {
            "type": "string",
            "description": "bride/groom, a/b, or side_a/side_b — normalized to the pack"
          },
          "group": {
            "type": "string",
            "description": "Free-text group tag (e.g. 'college friends')"
          },
          "relationship": {
            "type": "string",
            "description": "Role slug (e.g. best_man, parent)"
          },
          "ageGroup": {
            "type": "string",
            "description": "adult | child | infant"
          },
          "plusOne": {
            "type": "boolean"
          },
          "email": {
            "type": "string"
          },
          "phone": {
            "type": "string"
          },
          "rsvp": {
            "type": "string",
            "description": "attending | declined | pending | maybe"
          }
        },
        "additionalProperties": false
      },
      "minItems": 1,
      "description": "Guests to add"
    }
  },
  "required": [
    "projectKey",
    "guests"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Auto-generate a reception seating plan: creates round tables and seats every guest with the constraint-aware solver (keeps must-sit-together groups together). Returns how many were seated and a link to the visual editor.

{
  "type": "object",
  "properties": {
    "projectKey": {
      "type": "string",
      "description": "The projectKey returned by create_wedding_project"
    },
    "tables": {
      "type": "integer",
      "minimum": 1,
      "maximum": 60,
      "description": "Number of tables; omit to size automatically"
    },
    "seatsPerTable": {
      "type": "integer",
      "minimum": 2,
      "maximum": 20,
      "description": "Seats per table (default 8)"
    }
  },
  "required": [
    "projectKey"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Read the current state of a project: guest counts by RSVP status, seating tables/capacity, and budget totals. Read-only.

{
  "type": "object",
  "properties": {
    "projectKey": {
      "type": "string",
      "description": "The projectKey returned by create_wedding_project"
    }
  },
  "required": [
    "projectKey"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

List the available wedding culture packs (key, English name, cluster, sides). Use a pack key as the `culture` argument to create_wedding_project. Grounding/read-only.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

List Wedding Seat's free planning tools (seating chart, guest list, budget, checklist, invitation wording) with their public URLs. Grounding/read-only.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}