Output schema
{
"additionalProperties": false,
"properties": {
"data": {
"additionalProperties": false,
"description": "Successful result.",
"properties": {
"events": {
"description": "Accessible events.",
"items": {
"additionalProperties": false,
"properties": {
"address": {
"oneOf": [
{
"description": "Venue address.",
"type": "string"
},
{
"type": "null"
}
]
},
"allow_plus_ones": {
"description": "Whether RSVP parties may include additional guests.",
"type": "boolean"
},
"created_at": {
"description": "ISO 8601 creation timestamp.",
"type": "string"
},
"design": {
"additionalProperties": false,
"description": "Selected design, or type none while an MCP draft has no design.",
"properties": {
"cover_url": {
"oneOf": [
{
"description": "Selected cover URL.",
"type": "string"
},
{
"type": "null"
}
]
},
"id": {
"oneOf": [
{
"description": "Template or generation identifier.",
"type": "integer"
},
{
"type": "null"
}
]
},
"type": {
"description": "Design source.",
"enum": [
"template",
"generation",
"none"
]
}
},
"required": [
"type"
],
"type": "object"
},
"guest_count": {
"description": "Number of guest records.",
"type": "integer"
},
"host_message": {
"description": "Message shown to invited guests.",
"type": "string"
},
"id": {
"description": "Event identifier.",
"type": "integer"
},
"name": {
"description": "Host-visible event name.",
"type": "string"
},
"party_date": {
"description": "Venue-local ISO 8601 date (YYYY-MM-DD).",
"type": "string"
},
"role": {
"description": "Authenticated actor's role on this event.",
"enum": [
"owner",
"cohost",
"system"
]
},
"rsvp_summary": {
"additionalProperties": false,
"description": "Current RSVP rollup.",
"properties": {
"confirmed": {
"description": "Confirmed guest records.",
"type": "integer"
},
"declined": {
"description": "Declined guest records.",
"type": "integer"
},
"pending": {
"description": "Pending guest records.",
"type": "integer"
},
"plus_ones_total": {
"description": "Additional confirmed attendees.",
"type": "integer"
}
},
"required": [
"pending",
"confirmed",
"declined",
"plus_ones_total"
],
"type": "object"
},
"status": {
"description": "Event lifecycle state.",
"enum": [
"draft",
"sent",
"cancelled"
]
},
"tier": {
"description": "Current pricing tier.",
"type": "string"
},
"time_from": {
"description": "Venue-local 24-hour start time.",
"type": "string"
},
"time_to": {
"oneOf": [
{
"description": "Venue-local 24-hour end time.",
"type": "string"
},
{
"type": "null"
}
]
},
"timezone": {
"description": "IANA timezone used for event timing.",
"type": "string"
},
"timezone_inferred": {
"description": "True only when a historical timezone was backfilled.",
"type": "boolean"
},
"updated_at": {
"description": "ISO 8601 update timestamp.",
"type": "string"
}
},
"required": [
"id",
"name",
"status",
"role",
"updated_at",
"timezone",
"created_at",
"guest_count",
"party_date",
"tier",
"allow_plus_ones",
"host_message",
"time_from",
"design",
"timezone_inferred",
"rsvp_summary"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"events"
],
"type": "object"
},
"meta": {
"additionalProperties": false,
"description": "Response metadata.",
"properties": {
"next_cursor": {
"oneOf": [
{
"description": "Opaque cursor for the next page.",
"type": "string"
},
{
"type": "null"
}
]
},
"request_id": {
"description": "Stable request identifier for support, auditing, and retries.",
"type": "string"
},
"warnings": {
"oneOf": [
{
"description": "Non-fatal machine-readable response warnings.",
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
]
}
},
"required": [
"request_id"
],
"type": "object"
}
},
"required": [
"data",
"meta"
],
"type": "object",
"x-errorSchema": {
"additionalProperties": false,
"properties": {
"error": {
"additionalProperties": false,
"description": "Structured tool error envelope.",
"properties": {
"code": {
"description": "Stable error code; never branch on the human message.",
"enum": [
"unsupported_image_type",
"image_too_large",
"invalid_image",
"not_found",
"malformed_request",
"validation_failed",
"invalid_state",
"not_draft",
"design_missing",
"payment_required",
"guest_limit_reached",
"quota_exceeded",
"contact_blocked",
"duplicate_contact",
"confirmation_required",
"confirmation_expired",
"rate_limited",
"conflict",
"idempotency_conflict",
"request_too_large",
"response_too_large",
"temporarily_unavailable",
"unauthorized",
"insufficient_scope"
]
},
"details": {
"additionalProperties": false,
"description": "Safe structured context for recovery.",
"properties": {
"confirmation_token": {
"description": "Actor- and argument-bound confirmation token.",
"type": "string"
},
"expires_at": {
"description": "ISO 8601 confirmation expiry.",
"type": "string"
},
"index": {
"description": "Zero-based invalid row index.",
"type": "integer"
},
"preview": {
"additionalProperties": false,
"description": "Reviewed confirmation preview.",
"properties": {
"effects": {
"description": "Machine-readable effects that will occur on commit.",
"items": {
"additionalProperties": false,
"properties": {
"action": {
"description": "Tool operation that will be committed.",
"type": "string"
},
"channel": {
"description": "Delivery channel.",
"enum": [
"email",
"sms"
]
},
"count": {
"description": "Number of affected records.",
"type": "integer"
},
"fields": {
"description": "Fields that will change.",
"items": {
"type": "string"
},
"type": "array"
},
"resource_id": {
"description": "Affected resource identifier.",
"type": "integer"
},
"resource_type": {
"description": "Affected resource type.",
"type": "string"
}
},
"required": [
"action",
"resource_type"
],
"type": "object"
},
"type": "array"
},
"summary": {
"description": "Human-readable summary of the proposed commit.",
"type": "string"
}
},
"required": [
"summary",
"effects"
],
"type": "object"
},
"reason": {
"description": "Stable nested reason code.",
"type": "string"
},
"required_tier": {
"description": "Tier required before retrying.",
"type": "string"
},
"retry_after_seconds": {
"description": "Delay before a rate-limited retry.",
"type": "integer"
},
"rows": {
"description": "Redacted invalid or blocked rows.",
"items": {
"additionalProperties": false,
"properties": {
"fields": {
"description": "Redacted fields responsible for rejection.",
"items": {
"type": "string"
},
"type": "array"
},
"index": {
"description": "Zero-based row index.",
"type": "integer"
}
},
"required": [
"index",
"fields"
],
"type": "object"
},
"type": "array"
}
},
"type": "object"
},
"message": {
"description": "Short human-readable explanation.",
"type": "string"
},
"next_action": {
"additionalProperties": false,
"description": "Machine-readable recovery action.",
"properties": {
"retry": {
"description": "Whether to retry after satisfying details.",
"type": "boolean"
},
"tool": {
"description": "Recovery tool to call next.",
"type": "string"
}
},
"type": "object"
},
"retryable": {
"description": "Whether retrying later without changing arguments may work.",
"type": "boolean"
}
},
"required": [
"code",
"message",
"details",
"retryable",
"next_action"
],
"type": "object"
},
"meta": {
"additionalProperties": false,
"description": "Error response metadata.",
"properties": {
"request_id": {
"description": "Stable request identifier for support correlation.",
"type": "string"
}
},
"required": [
"request_id"
],
"type": "object"
}
},
"required": [
"error",
"meta"
],
"type": "object"
}
}