Raw schema
{
"type": "object",
"properties": {
"feed_id": {
"type": "string",
"format": "uuid",
"description": "Feed identity returned by a previous feed tool; used to address the selected calendar only."
},
"expected_revision": {
"type": "integer",
"minimum": 0,
"description": "Last read feed revision; prevents overwriting concurrent edits."
},
"request_id": {
"type": "string",
"minLength": 1,
"maxLength": 160,
"pattern": "^[A-Za-z0-9:_.-]+$",
"description": "Generate an opaque key for this save and reuse it unchanged for retries, to prevent duplicate changes. Not a user identifier, chat/session ID, or telemetry. Do not include personal data."
},
"operations": {
"type": "array",
"maxItems": 250,
"items": {
"oneOf": [
{
"type": "object",
"properties": {
"op": {
"const": "add"
},
"event": {
"type": "object",
"properties": {
"title": {
"type": [
"string",
"null"
],
"maxLength": 20000
},
"description": {
"type": [
"string",
"null"
],
"maxLength": 20000,
"description": "Only event notes the user intends to publish with this calendar. Never send chat history, credentials, health records or unrelated personal context."
},
"location": {
"type": [
"string",
"null"
],
"maxLength": 20000,
"description": "The event venue explicitly supplied in the schedule or requested correction, not the user’s current, home or device location. Do not request or infer user geolocation."
},
"start_date": {
"type": [
"string",
"null"
],
"maxLength": 20000
},
"end_date": {
"type": [
"string",
"null"
],
"maxLength": 20000,
"description": "Inclusive last calendar date, YYYY-MM-DD. Keep a printed multi-day range as one event unless the user asks otherwise."
},
"start_time": {
"type": [
"string",
"null"
],
"maxLength": 20000
},
"end_time": {
"type": [
"string",
"null"
],
"maxLength": 20000
},
"timezone": {
"type": [
"string",
"null"
],
"maxLength": 20000
},
"assignee": {
"type": [
"string",
"null"
],
"maxLength": 20000,
"description": "Optional event assignee explicitly named in the schedule; not the connected account identity, email address or a user profile."
},
"facet_venue": {
"type": [
"string",
"null"
],
"maxLength": 20000,
"description": "Source-grounded venue name. Extract from the source in the host. Reuse available facet values or existing tags with consistent spelling and language; do not retag unchanged fields."
},
"facet_topic": {
"type": [
"string",
"null"
],
"maxLength": 20000,
"description": "Source-grounded stable category, not the full event title. Extract from the source in the host. Reuse available facet values or existing tags with consistent spelling and language; do not retag unchanged fields."
},
"is_all_day": {
"type": "boolean"
},
"facet_actors": {
"type": [
"array",
"null"
],
"items": {
"type": "string"
},
"maxItems": 50,
"description": "Source-grounded participants or organizers (people, teams or organizations), not an invented audience such as everyone at a school. Extract from the source in the host. Reuse available facet values or existing tags with consistent spelling and language; do not retag unchanged fields."
}
},
"required": [
"title",
"start_date",
"is_all_day"
],
"additionalProperties": false
},
"external_key": {
"type": "string",
"minLength": 3,
"maxLength": 255,
"pattern": "^[A-Za-z0-9._-]{1,64}:[^\\s\\u0000-\\u001f]{1,190}$",
"description": "Source-stable, namespaced event identity, for example school-a:session-104. Do not derive it from a mutable title or date. A duplicate add does not update the event; use its event_id with update."
}
},
"required": [
"op",
"event"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"op": {
"const": "update"
},
"event_id": {
"type": "string",
"format": "uuid"
},
"set": {
"type": "object",
"properties": {
"title": {
"type": [
"string",
"null"
],
"maxLength": 20000
},
"description": {
"type": [
"string",
"null"
],
"maxLength": 20000,
"description": "Only event notes the user intends to publish with this calendar. Never send chat history, credentials, health records or unrelated personal context."
},
"location": {
"type": [
"string",
"null"
],
"maxLength": 20000,
"description": "The event venue explicitly supplied in the schedule or requested correction, not the user’s current, home or device location. Do not request or infer user geolocation."
},
"start_date": {
"type": [
"string",
"null"
],
"maxLength": 20000
},
"end_date": {
"type": [
"string",
"null"
],
"maxLength": 20000,
"description": "Inclusive last calendar date, YYYY-MM-DD. Keep a printed multi-day range as one event unless the user asks otherwise."
},
"start_time": {
"type": [
"string",
"null"
],
"maxLength": 20000
},
"end_time": {
"type": [
"string",
"null"
],
"maxLength": 20000
},
"timezone": {
"type": [
"string",
"null"
],
"maxLength": 20000
},
"assignee": {
"type": [
"string",
"null"
],
"maxLength": 20000,
"description": "Optional event assignee explicitly named in the schedule; not the connected account identity, email address or a user profile."
},
"facet_venue": {
"type": [
"string",
"null"
],
"maxLength": 20000,
"description": "Source-grounded venue name. Extract from the source in the host. Reuse available facet values or existing tags with consistent spelling and language; do not retag unchanged fields."
},
"facet_topic": {
"type": [
"string",
"null"
],
"maxLength": 20000,
"description": "Source-grounded stable category, not the full event title. Extract from the source in the host. Reuse available facet values or existing tags with consistent spelling and language; do not retag unchanged fields."
},
"is_all_day": {
"type": "boolean"
},
"facet_actors": {
"type": [
"array",
"null"
],
"items": {
"type": "string"
},
"maxItems": 50,
"description": "Source-grounded participants or organizers (people, teams or organizations), not an invented audience such as everyone at a school. Extract from the source in the host. Reuse available facet values or existing tags with consistent spelling and language; do not retag unchanged fields."
}
},
"required": [],
"additionalProperties": false,
"description": "Change only the supplied fields. Omitted fields stay unchanged. Explicit null clears a nullable field, for example {\"location\":null,\"description\":null}; it does not restore its baseline."
},
"reset_fields": {
"type": "array",
"items": {
"enum": [
"title",
"description",
"location",
"start_date",
"end_date",
"start_time",
"end_time",
"timezone",
"assignee",
"facet_venue",
"facet_topic",
"is_all_day",
"facet_actors"
]
},
"minItems": 1,
"uniqueItems": true,
"description": "Remove selected overrides and restore their saved baseline. This does not clear fields: location Court 1 changed to Court 2 resets to Court 1. A field without an override stays unchanged, including values supplied when adding the event. To clear a nullable field use set with null. Do not include a field in both set and reset_fields."
}
},
"required": [
"op",
"event_id"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"op": {
"const": "delete"
},
"event_id": {
"type": "string",
"format": "uuid"
}
},
"required": [
"op",
"event_id"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"op": {
"const": "restore"
},
"event_id": {
"type": "string",
"format": "uuid"
},
"set": {
"type": "object",
"properties": {
"title": {
"type": [
"string",
"null"
],
"maxLength": 20000
},
"description": {
"type": [
"string",
"null"
],
"maxLength": 20000,
"description": "Only event notes the user intends to publish with this calendar. Never send chat history, credentials, health records or unrelated personal context."
},
"location": {
"type": [
"string",
"null"
],
"maxLength": 20000,
"description": "The event venue explicitly supplied in the schedule or requested correction, not the user’s current, home or device location. Do not request or infer user geolocation."
},
"start_date": {
"type": [
"string",
"null"
],
"maxLength": 20000
},
"end_date": {
"type": [
"string",
"null"
],
"maxLength": 20000,
"description": "Inclusive last calendar date, YYYY-MM-DD. Keep a printed multi-day range as one event unless the user asks otherwise."
},
"start_time": {
"type": [
"string",
"null"
],
"maxLength": 20000
},
"end_time": {
"type": [
"string",
"null"
],
"maxLength": 20000
},
"timezone": {
"type": [
"string",
"null"
],
"maxLength": 20000
},
"assignee": {
"type": [
"string",
"null"
],
"maxLength": 20000,
"description": "Optional event assignee explicitly named in the schedule; not the connected account identity, email address or a user profile."
},
"facet_venue": {
"type": [
"string",
"null"
],
"maxLength": 20000,
"description": "Source-grounded venue name. Extract from the source in the host. Reuse available facet values or existing tags with consistent spelling and language; do not retag unchanged fields."
},
"facet_topic": {
"type": [
"string",
"null"
],
"maxLength": 20000,
"description": "Source-grounded stable category, not the full event title. Extract from the source in the host. Reuse available facet values or existing tags with consistent spelling and language; do not retag unchanged fields."
},
"is_all_day": {
"type": "boolean"
},
"facet_actors": {
"type": [
"array",
"null"
],
"items": {
"type": "string"
},
"maxItems": 50,
"description": "Source-grounded participants or organizers (people, teams or organizations), not an invented audience such as everyone at a school. Extract from the source in the host. Reuse available facet values or existing tags with consistent spelling and language; do not retag unchanged fields."
}
},
"required": [],
"additionalProperties": false,
"description": "Change only the supplied fields. Omitted fields stay unchanged. Explicit null clears a nullable field, for example {\"location\":null,\"description\":null}; it does not restore its baseline."
}
},
"required": [
"op",
"event_id"
],
"additionalProperties": false
}
]
}
},
"feed_patch": {
"type": "object",
"properties": {
"title": {
"type": "string"
},
"description": {
"type": [
"string",
"null"
]
}
},
"required": [],
"additionalProperties": false
},
"dry_run": {
"type": "boolean",
"default": false
},
"recover_preview": {
"type": "boolean",
"default": false,
"description": "Read the exact temporarily stored preview after losing its receipt or proposal. Requires dry_run=true and only feed_id and the original request_id; omit all other arguments. Does not save, extend expiry or authorize a charge. Show the recovered preview and obtain fresh approval before saving. Never guess a request ID or select a latest preview."
},
"preview_receipt": {
"type": "string",
"minLength": 1,
"maxLength": 2048,
"description": "Opaque receipt returned by a successful dry_run=true preview. Required when saving with dry_run=false. Return it unchanged with the same feed, revision, request_id and proposed changes. It is not user approval."
},
"confirm_credit_charge": {
"type": "boolean",
"default": false
}
},
"required": [
"feed_id",
"request_id"
],
"additionalProperties": false
}