WedBliss — Wedding OS for AI Agents

Add an event to the wedding-day schedule (title, start/end time, optional date and location). Requires JWT; writes restricted to couple/coordinator.

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "wedding_id",
    "title",
    "start_time"
  ],
  "properties": {
    "title": {
      "type": "string",
      "maxLength": 300,
      "minLength": 1
    },
    "end_time": {
      "type": "string",
      "pattern": "^\\d{2}:\\d{2}(:\\d{2})?$"
    },
    "event_date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "ISO date. Omit for the main wedding day."
    },
    "start_time": {
      "type": "string",
      "pattern": "^\\d{2}:\\d{2}(:\\d{2})?$",
      "description": "HH:MM or HH:MM:SS."
    },
    "wedding_id": {
      "type": "string",
      "format": "uuid"
    },
    "description": {
      "type": "string",
      "maxLength": 4000
    },
    "location_name": {
      "type": "string",
      "maxLength": 300
    },
    "responsible_person": {
      "type": "string",
      "maxLength": 200
    }
  },
  "additionalProperties": false
}

Mark a checklist task as completed. Requires JWT; RLS allows the couple, coordinator, or the assignee.

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "task_id"
  ],
  "properties": {
    "task_id": {
      "type": "string",
      "format": "uuid"
    }
  },
  "additionalProperties": false
}

Add a task to the wedding checklist (title, optional due date, priority low/medium/high/urgent). Requires JWT and wedding membership.

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "wedding_id",
    "title"
  ],
  "properties": {
    "title": {
      "type": "string",
      "maxLength": 300,
      "minLength": 1
    },
    "category": {
      "type": "string",
      "maxLength": 100
    },
    "due_date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "ISO calendar date (YYYY-MM-DD)."
    },
    "priority": {
      "enum": [
        "low",
        "medium",
        "high",
        "urgent"
      ],
      "type": "string"
    },
    "wedding_id": {
      "type": "string",
      "format": "uuid"
    },
    "description": {
      "type": "string",
      "maxLength": 4000
    }
  },
  "additionalProperties": false
}

Fetch the wedding budget: categories, items with payment status, and planned vs actual totals. Requires JWT and wedding membership.

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "wedding_id"
  ],
  "properties": {
    "wedding_id": {
      "type": "string",
      "format": "uuid"
    }
  },
  "additionalProperties": false
}

Fetch the seating plan: tables with capacity and the guests seated at each. Requires JWT and wedding membership. (Seat assignment writes are not exposed in v1 — conflict checks live in the app.)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "wedding_id"
  ],
  "properties": {
    "wedding_id": {
      "type": "string",
      "format": "uuid"
    }
  },
  "additionalProperties": false
}

Fetch the wedding-day schedule (or a specific date): times, locations, responsible people, completion state. Requires JWT and wedding membership.

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "wedding_id"
  ],
  "properties": {
    "event_date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Filter to a single day (ISO date). Omit for the whole schedule."
    },
    "wedding_id": {
      "type": "string",
      "format": "uuid"
    }
  },
  "additionalProperties": false
}

Fetch one wedding with its live health numbers: peace score, tasks done/total, guests confirmed/total, planned vs actual budget. Requires JWT and membership.

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "wedding_id"
  ],
  "properties": {
    "wedding_id": {
      "type": "string",
      "format": "uuid"
    }
  },
  "additionalProperties": false
}

List the agency's contractual vendor partners (category, city, price range, rating, preferred flag). Requires JWT of an agency member; RLS scopes results to your agency.

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "city": {
      "type": "string",
      "maxLength": 120
    },
    "limit": {
      "type": "integer",
      "default": 50,
      "maximum": 100,
      "minimum": 1
    },
    "category": {
      "enum": [
        "venue",
        "catering",
        "photographer",
        "videographer",
        "florist",
        "music",
        "dj",
        "band",
        "cake",
        "dress",
        "suit",
        "makeup",
        "hair",
        "jewelry",
        "decoration",
        "lighting",
        "transport",
        "accommodation",
        "stationery",
        "officiant",
        "planner",
        "coordinator",
        "rentals",
        "security",
        "other"
      ],
      "type": "string"
    }
  },
  "additionalProperties": false
}

Browse public digital wedding-announcement templates (name, dimensions, preview). No authentication required.

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 25,
      "maximum": 50,
      "minimum": 1
    },
    "premium_only": {
      "type": "boolean",
      "description": "Return only premium templates."
    }
  },
  "additionalProperties": false
}

List wedding guests with RSVP status, dietary needs, plus-ones and table assignment, plus an RSVP summary. Personal data — requires JWT and wedding membership; there is no anonymous access.

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "wedding_id"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "default": 150,
      "maximum": 300,
      "minimum": 1
    },
    "wedding_id": {
      "type": "string",
      "format": "uuid"
    },
    "rsvp_status": {
      "enum": [
        "pending",
        "yes",
        "no",
        "maybe"
      ],
      "type": "string"
    }
  },
  "additionalProperties": false
}

Read the communication thread between the couple and their agency (notes with topic tags, pinned/resolved state). Requires JWT; visible to wedding members and the agency's staff.

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "wedding_id"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "default": 50,
      "maximum": 200,
      "minimum": 1
    },
    "wedding_id": {
      "type": "string",
      "format": "uuid"
    },
    "unresolved_only": {
      "type": "boolean"
    }
  },
  "additionalProperties": false
}

List the wedding music playlist with votes, must-play and do-not-play flags. Requires JWT and wedding membership.

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "wedding_id"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "default": 100,
      "maximum": 300,
      "minimum": 1
    },
    "status": {
      "enum": [
        "pending",
        "approved",
        "rejected",
        "played"
      ],
      "type": "string"
    },
    "wedding_id": {
      "type": "string",
      "format": "uuid"
    }
  },
  "additionalProperties": false
}

List the wedding checklist, optionally filtered by status (pending, in_progress, completed, canceled). Requires JWT and wedding membership.

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "wedding_id"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "default": 100,
      "maximum": 200,
      "minimum": 1
    },
    "status": {
      "enum": [
        "pending",
        "in_progress",
        "completed",
        "canceled"
      ],
      "type": "string"
    },
    "wedding_id": {
      "type": "string",
      "format": "uuid"
    }
  },
  "additionalProperties": false
}

Browse the public catalog of wedding extras (fireworks, drones, limousines, entertainment...). Filterable by category, sorted by popularity. No authentication required.

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 50,
      "maximum": 100,
      "minimum": 1
    },
    "category": {
      "type": "string",
      "maxLength": 60,
      "minLength": 1,
      "description": "Filter by extras category (e.g. \"fireworks\", \"transport\", \"entertainment\")."
    },
    "premium_only": {
      "type": "boolean",
      "description": "Return only premium extras."
    }
  },
  "additionalProperties": false
}

List weddings visible to the authenticated caller — as a couple member, wedding owner, or agency owner. Requires a Supabase JWT in the Authorization header. Note: agency staff who are not the agency owner only see weddings where they were added as wedding members.

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 25,
      "maximum": 50,
      "minimum": 1
    },
    "status": {
      "enum": [
        "draft",
        "planning",
        "active",
        "completed",
        "archived"
      ],
      "type": "string",
      "description": "Filter by wedding status."
    }
  },
  "additionalProperties": false
}

Post a note into the couple ↔ agency thread (optionally tagged with a topic like "budget" or "timeline"). Requires JWT.

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "wedding_id",
    "content"
  ],
  "properties": {
    "content": {
      "type": "string",
      "maxLength": 8000,
      "minLength": 1
    },
    "related_to": {
      "type": "string",
      "maxLength": 100,
      "description": "Optional topic tag (e.g. \"budget\", \"timeline\", \"vendors\")."
    },
    "wedding_id": {
      "type": "string",
      "format": "uuid"
    },
    "author_role": {
      "enum": [
        "couple",
        "agency",
        "coordinator"
      ],
      "type": "string",
      "description": "Which hat the author wears in this thread."
    }
  },
  "additionalProperties": false
}

Attach a catalog extra (from list_wedding_extras) to a wedding, optionally with a chosen variant and note. Requires JWT and wedding membership.

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "wedding_id",
    "extra_id"
  ],
  "properties": {
    "notes": {
      "type": "string",
      "maxLength": 2000
    },
    "extra_id": {
      "type": "string",
      "format": "uuid",
      "description": "wedding_extras.id from list_wedding_extras."
    },
    "wedding_id": {
      "type": "string",
      "format": "uuid",
      "description": "Wedding the extra is selected for."
    },
    "selected_variant": {
      "type": "object",
      "description": "Chosen variant object as advertised in the extra's `variants` field.",
      "additionalProperties": {}
    }
  },
  "additionalProperties": false
}

Suggest a song for the wedding playlist (artist, title, optional YouTube/Spotify link and note). Requires JWT and wedding membership; lands as "pending" for the couple to approve.

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "wedding_id",
    "artist",
    "title"
  ],
  "properties": {
    "note": {
      "type": "string",
      "maxLength": 1000
    },
    "title": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1
    },
    "artist": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1
    },
    "wedding_id": {
      "type": "string",
      "format": "uuid"
    },
    "spotify_url": {
      "type": "string",
      "format": "uri",
      "maxLength": 500
    },
    "youtube_url": {
      "type": "string",
      "format": "uri",
      "maxLength": 500
    }
  },
  "additionalProperties": false
}

Update a guest's RSVP (yes/no/maybe/pending), plus-one confirmation, dietary needs, allergies, or song suggestion. Requires JWT; the couple/coordinator can update any guest, a logged-in guest only their own row.

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "guest_id",
    "rsvp_status"
  ],
  "properties": {
    "dietary": {
      "enum": [
        "meat",
        "vegetarian",
        "vegan",
        "gluten_free",
        "lactose_free",
        "halal",
        "kosher",
        "other"
      ],
      "type": "string"
    },
    "guest_id": {
      "type": "string",
      "format": "uuid"
    },
    "allergies": {
      "type": "string",
      "maxLength": 1000
    },
    "rsvp_status": {
      "enum": [
        "pending",
        "yes",
        "no",
        "maybe"
      ],
      "type": "string"
    },
    "song_suggestion": {
      "type": "string",
      "maxLength": 300
    },
    "plus_one_confirmed": {
      "type": "boolean"
    }
  },
  "additionalProperties": false
}