**גרסאות API** · **V2 (Latest)** · [V1](/integrations/v1/docs?lang=he)

# Annual Events

OpenAPI 3.0.3 · API 2.0.0

```json
[
  {
    "url": "https://api.unisoft.world/integrations/v2",
    "description": "API"
  }
]
```

Managed ordinary events: create from structured data or a poster, publish the public page, registration form and/or fundraiser, then prepare a campaign draft. Shabbat and prefab-holiday events are deliberately outside this API. Scopes: `events:read` / `events:write`.

## פעולות

## GET /annual-events

List managed annual events

`list_annual_events`

Required scope: `events:read`. Lists event projects created through the guided annual-event facade. Includes one-off and recurring ordinary events, and excludes all Shabbat / prefab-holiday flows by construction.

### אימות

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### הרשאות נדרשות

```json
{
  "accepted": "events:read",
  "additional": []
}
```

### פרמטרים

```json
{
  "name": "limit",
  "in": "query",
  "schema": {
    "type": "integer",
    "minimum": 1,
    "maximum": 200,
    "default": 50
  },
  "description": "Number of results per page"
}
```

```json
{
  "name": "cursor",
  "in": "query",
  "schema": {
    "type": "string"
  },
  "description": "Opaque cursor returned by the previous request"
}
```

```json
{
  "name": "year",
  "in": "query",
  "schema": {
    "type": "integer",
    "minimum": 2000,
    "maximum": 2200
  }
}
```

```json
{
  "name": "publicationStatus",
  "in": "query",
  "schema": {
    "type": "string",
    "enum": [
      "CREATED",
      "PUBLISHED",
      "PUBLISHING",
      "PUBLISH_FAILED"
    ]
  }
}
```

### תגובות

#### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/AnnualEventProject"
            }
          },
          "meta": {
            "$ref": "#/components/schemas/Pagination"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        },
        "description": "INSUFFICIENT_SCOPE"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "events:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## POST /annual-events

Create and publish an ordinary event

`create_annual_event`

Required scope: `events:write`. Idempotently coordinates the page, group, sessions and requested form/fundraiser/campaign draft from one reviewed recipe. `idempotencyKey` is required in the JSON body for both REST and MCP; the optional `Idempotency-Key` header may override it for transport-level retries. A campaign is always left in draft and is never sent here.

### אימות

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### הרשאות נדרשות

```json
{
  "accepted": "events:write",
  "additional": []
}
```

### פרמטרים

```json
{
  "name": "Idempotency-Key",
  "in": "header",
  "schema": {
    "type": "string",
    "maxLength": 200
  }
}
```

### גוף הבקשה

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/UnisoftRequest_133a453e99d95d23090e"
      }
    }
  }
}
```

### תגובות

#### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/AnnualEventPublishResult"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        },
        "description": "INVALID_INPUT"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        },
        "description": "CONFLICT"
      }
    }
  }
}
```

#### HTTP 422

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        },
        "description": "VALIDATION_ERROR"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-mcp": {
    "category": "action",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  },
  "x-unisoft-scope": "events:write"
}
```

## GET /annual-events/groups

List compatible ordinary event groups

`list_annual_event_groups`

Required scope: `events:read`. Lists only ordinary single-session groups that can safely receive a new event. Shabbat, prefab-holiday and multi-session groups are excluded.

### אימות

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### הרשאות נדרשות

```json
{
  "accepted": "events:read",
  "additional": []
}
```

### פרמטרים

```json
{
  "name": "limit",
  "in": "query",
  "schema": {
    "type": "integer",
    "minimum": 1,
    "maximum": 200,
    "default": 50
  },
  "description": "Number of results per page"
}
```

```json
{
  "name": "cursor",
  "in": "query",
  "schema": {
    "type": "string"
  },
  "description": "Opaque cursor returned by the previous request"
}
```

### תגובות

#### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/AnnualEventCompatibleGroup"
            }
          },
          "meta": {
            "$ref": "#/components/schemas/Pagination"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        },
        "description": "INSUFFICIENT_SCOPE"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "events:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## POST /annual-events/poster-analysis

Prepare an event draft from a poster

`analyze_annual_event_poster`

Required scope: `events:write`. Reads a real poster image and returns a comprehensive suggested recipe. This does not publish anything; the caller must show the result for review, complete uncertain fields, then call `create_annual_event`.

### אימות

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### הרשאות נדרשות

```json
{
  "accepted": "events:write",
  "additional": []
}
```

### גוף הבקשה

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "poster": {
            "type": "string",
            "description": "Hosted image filename from `/uploads/image`, or an http(s) URL to re-host first."
          }
        },
        "required": [
          "poster"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

### תגובות

#### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/AnnualEventPosterAnalysis"
          }
        }
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        },
        "description": "INVALID_POSTER"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        },
        "description": "POSTER_NOT_FOUND"
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        },
        "description": "AI_UNAVAILABLE"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "events:write",
  "x-unisoft-mcp": {
    "category": "create",
    "readOnly": false,
    "destructive": false,
    "idempotent": false,
    "warn": false
  }
}
```

## GET /annual-events/{id}

Get a managed annual event

`get_annual_event`

Required scope: `events:read`. Returns the canonical project, its reviewed recipe, revision, public URL and the ids of its sessions, forms, fundraisers and campaign drafts.

### אימות

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### הרשאות נדרשות

```json
{
  "accepted": "events:read",
  "additional": []
}
```

### פרמטרים

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "pattern": "^[A-Za-z0-9_-]{3,128}$"
  },
  "description": "Annual-event project id."
}
```

### תגובות

#### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/AnnualEventProject"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        },
        "description": "EVENT_NOT_FOUND"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "events:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## PATCH /annual-events/{id}

Update and republish a managed annual event

`update_annual_event`

Required scope: `events:write`. Applies a partial patch to the stored recipe and republishes its managed resources. Send `expectedRevision` to reject a stale edit with 409. Arrays supplied in the patch replace their previous value. A campaign remains a draft and is never sent here.

### אימות

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### הרשאות נדרשות

```json
{
  "accepted": "events:write",
  "additional": []
}
```

### פרמטרים

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "pattern": "^[A-Za-z0-9_-]{3,128}$"
  },
  "description": "Annual-event project id."
}
```

### גוף הבקשה

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "expectedRevision": {
            "type": "integer",
            "minimum": 1
          },
          "patch": {
            "$ref": "#/components/schemas/UnisoftRequest_95690b6a2d37403c8838"
          },
          "idempotencyKey": {
            "type": "string",
            "minLength": 1,
            "maxLength": 200
          },
          "timeZone": {
            "type": "string"
          }
        },
        "required": [
          "expectedRevision",
          "patch",
          "idempotencyKey"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

### תגובות

#### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/AnnualEventPublishResult"
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        },
        "description": "EVENT_NOT_FOUND"
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        },
        "description": "REVISION_CONFLICT"
      }
    }
  }
}
```

#### HTTP 422

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        },
        "description": "VALIDATION_ERROR"
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "events:write",
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## POST /annual-events/{id}/series-plan

Preview exact managed series membership and canonical refresh effects

`preview_event_series_change`

Requires events:read plus conditional forms:read/caisses:read/messages:read and content_blocks:read, including retained historical child resources. Read-only preview: no publisher, media fetch, translation, resource/cache write, registration or provider call. Returns exact current/next UTC instants, selected/retired ids, added keys, required scopes and public-target changes. Read all refresh effects and manual-override limits before deciding on a command. Only ordinary currently published managed annual projects are supported; protected Shabbat/prefab groups, unpublished projects and unproven facade publication contexts are refused. Project id is not a group/session/form id. ADD_DATES adds explicit civil dates at the existing common hours. REMOVE_SESSIONS targets EXPLICIT session ids or FROM_SESSION (anchor and following native instants, inclusive, regardless of today). SET_RECURRENCE uses the native once/weekly/monthly/custom date owner for ALL or FROM_SESSION; earlier unselected dates remain equal, and generated dates before the anchor are refused. No caller time zone or new hours are accepted. ADD/REMOVE and targeted replacement store exact custom dates (or once when one remains); ALL recurrence keeps the selected native cadence. At most 200 sessions remain. Current or retired logical-key collisions, empty schedules, date drift, currency/time-zone changes and unknown data are refused. Global scalar identity uniqueness is required for existing resources/references, and prospective stable native child ids must be globally absent before publication; a local organisation match cannot bypass an alias. Existing retained logical keys keep their session ids; new ids remain null in the preview until the owner creates them. Retained inactive sessions remain inactive; new dates are active, and active flags are explicit in both lists. Retired PE/form/fundraiser rows become inactive; old products and livrets remain retained in their native state. No registration/ticket/payment deletion, refund or scan revocation occurs. The native publisher refreshes canonical configuration on ALL remaining managed sessions/forms/products/fundraisers and a prepared campaign, not only the selected membership. Manual overrides are NOT guaranteed to survive; the reviewed command therefore requires confirmCanonicalRefresh=true. A public target may change (including group versus first-session page); inspect the plan. No campaign is sent. Use reschedule_event_session for an identity-preserving date report, never this membership replacement as an equivalent. Reads and plans are optimistic observations, not reservations or a global transaction against internal writers.

### אימות

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### הרשאות נדרשות

```json
{
  "accepted": "events:read",
  "additional": []
}
```

### פרמטרים

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "pattern": "^[A-Za-z0-9_-]{3,128}$"
  }
}
```

### גוף הבקשה

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "change": {
            "$ref": "#/components/schemas/UnisoftRequest_0667b8aac019eb4d0f07"
          }
        },
        "required": [
          "change"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

### תגובות

#### HTTP 200

```json
{
  "description": "Reviewed native series plan or owner-recorded acknowledgement.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "data"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/EventSeriesPlan"
          }
        }
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "INVALID_EVENT_SERIES_INPUT / INVALID_EVENT_SERIES_SCHEDULE",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string",
            "pattern": "^[A-Za-z0-9_-]{3,128}$"
          },
          "reason": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "INSUFFICIENT_SCOPE / CAMPAIGN_RESTRICTED_KEY",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string",
            "pattern": "^[A-Za-z0-9_-]{3,128}$"
          },
          "reason": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "EVENT_NOT_FOUND / EVENT_REFERENCE_NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string",
            "pattern": "^[A-Za-z0-9_-]{3,128}$"
          },
          "reason": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "REVISION_CONFLICT / IDEMPOTENCY_KEY_CONFLICT / EVENT_SERIES_PLAN_CHANGED / EVENT_SERIES_UNSUPPORTED / EVENT_SERIES_NOT_PUBLIC / INVALID_EVENT_GRAPH / EVENT_WRITE_UNCERTAIN / EVENT_PUBLICATION_UNCERTAIN",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string",
            "pattern": "^[A-Za-z0-9_-]{3,128}$"
          },
          "reason": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "EVENT_SERIES_UNAVAILABLE",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string",
            "pattern": "^[A-Za-z0-9_-]{3,128}$"
          },
          "reason": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "events:read",
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## POST /annual-events/{id}/series

Apply a reviewed managed series membership change through its native publisher

`change_event_series`

Requires events:write and events:read plus conditional forms:write/caisses:write/messages:write and content_blocks:read. Child-domain scopes also apply to retained historical resources the owner may retire, including an old prepared campaign. First inspect preview_event_series_change, then send the identical change, planHash, native expectedRevision, stable idempotencyKey and confirmCanonicalRefresh=true. Source, scopes and plan are re-admitted before a durable external journal claim; the canonical annual publisher executes at most once. An unchanged completed retry returns its recorded acknowledgement. Captured scopes and source revision are bound to the original planHash; missing, weakened or contradictory admission metadata is uncertain, never a weaker-key replay grant. The complete native acknowledgement, revision increment and global result identities are re-admitted before a stored success and on completed replay. Pending/uncertain storage or owner results retain commandId/projectId and never authorise another key or forced revision; inspect existing resources/history to reconcile. Journal/CAS writes require exact positive ACK with explicit durability. Only ordinary currently published managed annual projects are supported; protected Shabbat/prefab groups, unpublished projects and unproven facade publication contexts are refused. Project id is not a group/session/form id. ADD_DATES adds explicit civil dates at the existing common hours. REMOVE_SESSIONS targets EXPLICIT session ids or FROM_SESSION (anchor and following native instants, inclusive, regardless of today). SET_RECURRENCE uses the native once/weekly/monthly/custom date owner for ALL or FROM_SESSION; earlier unselected dates remain equal, and generated dates before the anchor are refused. No caller time zone or new hours are accepted. ADD/REMOVE and targeted replacement store exact custom dates (or once when one remains); ALL recurrence keeps the selected native cadence. At most 200 sessions remain. Current or retired logical-key collisions, empty schedules, date drift, currency/time-zone changes and unknown data are refused. Global scalar identity uniqueness is required for existing resources/references, and prospective stable native child ids must be globally absent before publication; a local organisation match cannot bypass an alias. Existing retained logical keys keep their session ids; new ids remain null in the preview until the owner creates them. Retained inactive sessions remain inactive; new dates are active, and active flags are explicit in both lists. Retired PE/form/fundraiser rows become inactive; old products and livrets remain retained in their native state. No registration/ticket/payment deletion, refund or scan revocation occurs. The native publisher refreshes canonical configuration on ALL remaining managed sessions/forms/products/fundraisers and a prepared campaign, not only the selected membership. Manual overrides are NOT guaranteed to survive; the reviewed command therefore requires confirmCanonicalRefresh=true. A public target may change (including group versus first-session page); inspect the plan. No campaign is sent. Use reschedule_event_session for an identity-preserving date report, never this membership replacement as an equivalent. Reads and plans are optimistic observations, not reservations or a global transaction against internal writers.

### אימות

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### הרשאות נדרשות

```json
{
  "accepted": "events:write",
  "additional": [
    "events:read"
  ]
}
```

### פרמטרים

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "pattern": "^[A-Za-z0-9_-]{3,128}$"
  }
}
```

### גוף הבקשה

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "change": {
            "$ref": "#/components/schemas/UnisoftRequest_0667b8aac019eb4d0f07"
          },
          "idempotencyKey": {
            "type": "string",
            "minLength": 1,
            "maxLength": 200
          },
          "expectedRevision": {
            "type": "integer",
            "minimum": 1
          },
          "planHash": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "confirmCanonicalRefresh": {
            "type": "boolean",
            "enum": [
              true
            ]
          }
        },
        "required": [
          "change",
          "idempotencyKey",
          "expectedRevision",
          "planHash",
          "confirmCanonicalRefresh"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

### תגובות

#### HTTP 200

```json
{
  "description": "Reviewed native series plan or owner-recorded acknowledgement.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/EventSeriesCommandResult"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "INVALID_EVENT_SERIES_INPUT / INVALID_EVENT_SERIES_SCHEDULE",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string",
            "pattern": "^[A-Za-z0-9_-]{3,128}$"
          },
          "reason": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "INSUFFICIENT_SCOPE / CAMPAIGN_RESTRICTED_KEY",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string",
            "pattern": "^[A-Za-z0-9_-]{3,128}$"
          },
          "reason": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "EVENT_NOT_FOUND / EVENT_REFERENCE_NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string",
            "pattern": "^[A-Za-z0-9_-]{3,128}$"
          },
          "reason": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "REVISION_CONFLICT / IDEMPOTENCY_KEY_CONFLICT / EVENT_SERIES_PLAN_CHANGED / EVENT_SERIES_UNSUPPORTED / EVENT_SERIES_NOT_PUBLIC / INVALID_EVENT_GRAPH / EVENT_WRITE_UNCERTAIN / EVENT_PUBLICATION_UNCERTAIN",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string",
            "pattern": "^[A-Za-z0-9_-]{3,128}$"
          },
          "reason": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "EVENT_SERIES_UNAVAILABLE",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string",
            "pattern": "^[A-Za-z0-9_-]{3,128}$"
          },
          "reason": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "events:write",
  "x-unisoft-additional-scopes": [
    "events:read"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp": {
    "category": "action",
    "readOnly": false,
    "destructive": true,
    "idempotent": true,
    "warn": true
  }
}
```

## GET /annual-events/{id}/links

Read public event and registration links with native iframe snippets

`get_event_public_links`

Required scopes: `events:read` and `site:read`, plus forms:read or caisses:read when linked managed resources exist. Read-only observation for an existing ordinary managed annual project id, not a session/form/ticket id. No query body or unknown parameter is accepted. Omit virtualId for the main site, or supply its exact current facade UUID; Travel and currency-interface ids are not facade ids. A facade-scoped group cannot be read on another site. lang must be enabled for that site; omission uses its native default language. embedId optionally identifies a host iframe and is not a credential. Returns the recorded public page target and registration/fundraiser targets only after scalar organisation/reference admission. Global target-id uniqueness and native public parent joins are checked: foreign, duplicate or array identities in form/session/group resolution or linked children are refusals, never permission to reconstruct the same URL manually. Native public session/form windows and cutoff/end dates determine observed registration links; an independently active fundraiser can retain its direct public link even if an event page is hidden. WITHHELD returns url/embed null and is not proof that every old URL or payment capability has been revoked. Only PUBLISHED/CREATED owner states are admitted; CREATED can have no page. Custom editable links, private resources and raw owner data are not returned. URLs use the canonical site root and existing /evenement, /form and /don routes; they contain no API key, scan token, account token or payment capability. Every supplied iframe uses the existing render=embed route, escaped attributes and a fixed 800px height with normal scrolling. No script, host bridge, automatic resizing, host configuration or payment integration is installed by this read. No page is fetched, rendered, published or changed, and no registration, reservation, payment, subscription, ticket or message is created. OBSERVED_OPEN is an optimistic stored/public-window observation, not stock availability, payment readiness, browser rendering or successful registration. publicRenderingVerified=false, stockChecked=false and paymentReadiness=NOT_EVALUATED remain explicit. Missing, foreign, protected, malformed or ambiguously linked resources are refused before deriving URLs. Campaign-restricted keys are refused; an unknown or unavailable link never authorises publishing or an internal endpoint fallback.

### אימות

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### הרשאות נדרשות

```json
{
  "accepted": "events:read",
  "additional": [
    "site:read"
  ]
}
```

### פרמטרים

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "pattern": "^[A-Za-z0-9_-]{3,128}$"
  }
}
```

```json
{
  "name": "virtualId",
  "in": "query",
  "schema": {
    "type": "string",
    "format": "uuid"
  }
}
```

```json
{
  "name": "lang",
  "in": "query",
  "schema": {
    "type": "string",
    "enum": [
      "fr",
      "en",
      "he",
      "it",
      "ru",
      "pt",
      "de",
      "es",
      "gr",
      "ro"
    ]
  }
}
```

```json
{
  "name": "embedId",
  "in": "query",
  "schema": {
    "type": "string",
    "pattern": "^[A-Za-z0-9_-]{1,128}$"
  }
}
```

### תגובות

#### HTTP 200

```json
{
  "description": "Qualified public-link observation and optional native iframe snippets.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/EventPublicLinksResult"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "INVALID_EVENT_LINK_INPUT / EVENT_LINK_LANGUAGE_NOT_ENABLED",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "INSUFFICIENT_SCOPE / CAMPAIGN_RESTRICTED_KEY",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "EVENT_LINK_RESOURCE_NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "INVALID_EVENT_LINK_GRAPH / EVENT_LINK_SITE_UNPROVEN / EVENT_LINK_PUBLICATION_UNCERTAIN / EVENT_LINK_CLOCK_UNPROVEN",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "EVENT_LINKS_UNAVAILABLE",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "events:read",
  "x-unisoft-additional-scopes": [
    "site:read"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## GET /annual-events/history

List persisted external event commands in the organisation

`list_event_command_history`

Required scope: `events:read`. Read-only paginated observation of the real external event-command journal, ordered by createdAt and commandId descending. This never invents native history or executes reconciliation. No HTTP body or unknown query field is accepted. Optional state and operation filter stored command records; outcome PUBLISHED/CREATED/UNPUBLISHED selects only SUCCEEDED records with that stored result. from is inclusive and to exclusive UTC journal creation time, not event session time. limit is 1..100 (default 50); continue with nextCursor and unchanged filters. The id, when present, is an actual known native annual project or API draft id; related duplication records identify sourceProjectId and draftId separately. An empty result never proves that the resource exists or had no transitions. coverage.complete is always false: internal/native edits, older uncaptured actions and private-draft creation are not commands in this journal. Current resource existence/visibility is not evaluated. RUNNING/UNCERTAIN never authorises another key or automatic retry; REFUSED and SUCCEEDED are stored command states, not proof of payment, message delivery, browser rendering or present visibility. finishedAt and absent revisions stay null. IDs, timestamps and known revisions/outcomes are returned; no recipe, actor, idempotency key, hash, provider secret or raw result snapshot. Campaign-restricted keys and ambiguous historical identities are refused.

### אימות

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### הרשאות נדרשות

```json
{
  "accepted": "events:read",
  "additional": []
}
```

### פרמטרים

```json
{
  "name": "state",
  "in": "query",
  "schema": {
    "type": "string",
    "enum": [
      "RUNNING",
      "SUCCEEDED",
      "REFUSED",
      "UNCERTAIN"
    ]
  }
}
```

```json
{
  "name": "operation",
  "in": "query",
  "schema": {
    "type": "string",
    "enum": [
      "PUBLISH",
      "REPLACE_RECIPE",
      "DUPLICATE_DRAFT",
      "RESCHEDULE",
      "UNPUBLISH",
      "LEGACY_POST",
      "LEGACY_PATCH",
      "SERIES_UPDATE"
    ]
  }
}
```

```json
{
  "name": "outcome",
  "in": "query",
  "schema": {
    "type": "string",
    "enum": [
      "PUBLISHED",
      "CREATED",
      "UNPUBLISHED"
    ]
  }
}
```

```json
{
  "name": "from",
  "in": "query",
  "schema": {
    "type": "string",
    "format": "date-time"
  },
  "description": "Inclusive journal creation-time lower bound, as a UTC ISO instant ending in Z."
}
```

```json
{
  "name": "to",
  "in": "query",
  "schema": {
    "type": "string",
    "format": "date-time"
  },
  "description": "Exclusive journal creation-time upper bound, as a UTC ISO instant ending in Z."
}
```

```json
{
  "name": "limit",
  "in": "query",
  "schema": {
    "type": "integer",
    "minimum": 1,
    "maximum": 100,
    "default": 50
  }
}
```

```json
{
  "name": "cursor",
  "in": "query",
  "schema": {
    "type": "string",
    "maxLength": 2000
  },
  "description": "Opaque nextCursor returned by the previous page. Keep the same organisation/resource and filters. It is a position, never an access grant."
}
```

### תגובות

#### HTTP 200

```json
{
  "description": "Persisted external event-command observations with explicit partial coverage.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/EventLifecycleHistoryResult"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "INVALID_EVENT_HISTORY_QUERY / INVALID_EVENT_HISTORY_CURSOR / INVALID_EVENT_HISTORY_ID",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "INSUFFICIENT_SCOPE / CAMPAIGN_RESTRICTED_KEY",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "INVALID_EVENT_COMMAND_HISTORY",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "events:read",
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## GET /annual-events/{id}/history

Read persisted external commands related to an event or API draft

`get_event_command_history`

Required scope: `events:read`. Read-only paginated observation of the real external event-command journal, ordered by createdAt and commandId descending. This never invents native history or executes reconciliation. No HTTP body or unknown query field is accepted. Optional state and operation filter stored command records; outcome PUBLISHED/CREATED/UNPUBLISHED selects only SUCCEEDED records with that stored result. from is inclusive and to exclusive UTC journal creation time, not event session time. limit is 1..100 (default 50); continue with nextCursor and unchanged filters. The id, when present, is an actual known native annual project or API draft id; related duplication records identify sourceProjectId and draftId separately. An empty result never proves that the resource exists or had no transitions. coverage.complete is always false: internal/native edits, older uncaptured actions and private-draft creation are not commands in this journal. Current resource existence/visibility is not evaluated. RUNNING/UNCERTAIN never authorises another key or automatic retry; REFUSED and SUCCEEDED are stored command states, not proof of payment, message delivery, browser rendering or present visibility. finishedAt and absent revisions stay null. IDs, timestamps and known revisions/outcomes are returned; no recipe, actor, idempotency key, hash, provider secret or raw result snapshot. Campaign-restricted keys and ambiguous historical identities are refused.

### אימות

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### הרשאות נדרשות

```json
{
  "accepted": "events:read",
  "additional": []
}
```

### פרמטרים

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "pattern": "^[A-Za-z0-9_-]{3,128}$"
  }
}
```

```json
{
  "name": "state",
  "in": "query",
  "schema": {
    "type": "string",
    "enum": [
      "RUNNING",
      "SUCCEEDED",
      "REFUSED",
      "UNCERTAIN"
    ]
  }
}
```

```json
{
  "name": "operation",
  "in": "query",
  "schema": {
    "type": "string",
    "enum": [
      "PUBLISH",
      "REPLACE_RECIPE",
      "DUPLICATE_DRAFT",
      "RESCHEDULE",
      "UNPUBLISH",
      "LEGACY_POST",
      "LEGACY_PATCH",
      "SERIES_UPDATE"
    ]
  }
}
```

```json
{
  "name": "outcome",
  "in": "query",
  "schema": {
    "type": "string",
    "enum": [
      "PUBLISHED",
      "CREATED",
      "UNPUBLISHED"
    ]
  }
}
```

```json
{
  "name": "from",
  "in": "query",
  "schema": {
    "type": "string",
    "format": "date-time"
  },
  "description": "Inclusive journal creation-time lower bound, as a UTC ISO instant ending in Z."
}
```

```json
{
  "name": "to",
  "in": "query",
  "schema": {
    "type": "string",
    "format": "date-time"
  },
  "description": "Exclusive journal creation-time upper bound, as a UTC ISO instant ending in Z."
}
```

```json
{
  "name": "limit",
  "in": "query",
  "schema": {
    "type": "integer",
    "minimum": 1,
    "maximum": 100,
    "default": 50
  }
}
```

```json
{
  "name": "cursor",
  "in": "query",
  "schema": {
    "type": "string",
    "maxLength": 2000
  },
  "description": "Opaque nextCursor returned by the previous page. Keep the same organisation/resource and filters. It is a position, never an access grant."
}
```

### תגובות

#### HTTP 200

```json
{
  "description": "Persisted external event-command observations with explicit partial coverage.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/EventLifecycleHistoryResult"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "INVALID_EVENT_HISTORY_QUERY / INVALID_EVENT_HISTORY_CURSOR / INVALID_EVENT_HISTORY_ID",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "INSUFFICIENT_SCOPE / CAMPAIGN_RESTRICTED_KEY",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "INVALID_EVENT_COMMAND_HISTORY",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "events:read",
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## POST /annual-events/drafts

Save a private ordinary-event draft

`create_event_draft`

Required scope: `events:write`. Stores an ordinary-event recipe in an API-owned private draft, idempotently within the organisation. It does not publish a page, create a session/form/fundraiser, reserve stock or send a message. This draft is not visible in the admin browser draft list. Prices, targets, deposits and contributions are in major currency units; no collection or currency conversion occurs here. idempotencyKey and recipe are required; repeating unchanged input returns the same id, while changed input with the same key returns IDEMPOTENCY_KEY_CONFLICT (409). Known references are admitted before saving; campaign-restricted keys are refused. References to an existing group require an ordinary standalone group. A content block additionally requires content_blocks:read. The optional requestedTimeZone is a publication request, not an effective schedule. validation concerns the canonical recipe only: INCOMPLETE is a saved draft, not a failed creation; VALID is not permission or proof of publication. Do not call create_annual_event merely to save a draft: that existing operation publishes immediately. Existing-form attachment is not supported by the current publication owner and must not be invented. A lost response must be reconciled with the same key and identical input or by reading the returned draft id. Every adapter write requests w:1 and j:true. Journal claims require acknowledged=true and the exact inserted/upserted id; CAS requires positively acknowledged counters. A missing or mismatched acknowledgement stops before the following effect and returns EVENT_WRITE_UNCERTAIN or the operation-specific uncertainty. Keep the identity and key, reconcile, and never force a new key or revision to repeat effects.

### אימות

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### הרשאות נדרשות

```json
{
  "accepted": "events:write",
  "additional": []
}
```

### גוף הבקשה

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "idempotencyKey": {
            "type": "string",
            "minLength": 1,
            "maxLength": 200,
            "description": "Stable caller correlation key for this creation within the organisation. Reuse the same key and unchanged payload after an uncertain result; changed input with the same key returns 409."
          },
          "recipe": {
            "$ref": "#/components/schemas/UnisoftRequest_b6493128eea60f41ebb4"
          },
          "requestedTimeZone": {
            "type": "string",
            "minLength": 1,
            "maxLength": 100,
            "description": "Optional valid IANA time zone requested for later publication. No effective schedule is calculated or promised here; the existing publisher can prefer organisation coordinates."
          }
        },
        "required": [
          "idempotencyKey",
          "recipe"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

### תגובות

#### HTTP 200

```json
{
  "description": "Ordinary-event developer response.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/EventLifecycleResult"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "INVALID_EVENT_DRAFT_INPUT",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "draftId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string"
          },
          "sessionId": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "reason": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "INSUFFICIENT_SCOPE / CAMPAIGN_RESTRICTED_KEY",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "draftId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string"
          },
          "sessionId": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "reason": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "EVENT_REFERENCE_NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "draftId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string"
          },
          "sessionId": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "reason": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "IDEMPOTENCY_KEY_CONFLICT / INVALID_EVENT_DRAFT_HISTORY / PROTECTED_EVENT_GROUP / EVENT_WRITE_UNCERTAIN",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "draftId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string"
          },
          "sessionId": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "reason": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "EVENT_DRAFT_UNAVAILABLE",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "draftId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string"
          },
          "sessionId": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "reason": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "events:write",
  "x-unisoft-mcp": {
    "category": "create",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  },
  "x-unisoft-mcp-output-schema": true
}
```

## GET /annual-events/drafts/{id}

Read a private ordinary-event draft

`get_event_draft`

Required scope: `events:read`. Reads an API-owned ordinary-event recipe and its external publication acknowledgement by the returned UUID. No query parameter or HTTP body is accepted. Campaign-restricted keys are refused. DRAFT has not created a native project; after explicit publication, publication.projectId addresses the canonical annual project. The logical records are distinct even when their UUID is equal. MATERIALIZED corresponds to native CREATED without a public page; PUBLICATION_UNCERTAIN requires reconciliation and never proves publication. validation rechecks recipe completeness with the canonical pure validator only; it does not revalidate every current dependency or execute publication. Missing fields remain absent. API-owned recipes remain separate from browser-local admin drafts. Foreign or ambiguous identities are refused and private audit/hash fields are never returned.

### אימות

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### הרשאות נדרשות

```json
{
  "accepted": "events:read",
  "additional": []
}
```

### פרמטרים

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid"
  },
  "description": "Existing API draft UUID returned by create_event_draft."
}
```

### תגובות

#### HTTP 200

```json
{
  "description": "Ordinary-event developer response.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/EventLifecycleResult"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "INVALID_EVENT_DRAFT_ID",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "draftId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string"
          },
          "sessionId": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "reason": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "INSUFFICIENT_SCOPE / CAMPAIGN_RESTRICTED_KEY",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "draftId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string"
          },
          "sessionId": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "reason": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "EVENT_DRAFT_NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "draftId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string"
          },
          "sessionId": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "reason": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "INVALID_EVENT_DRAFT_HISTORY",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "draftId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string"
          },
          "sessionId": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "reason": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "events:read",
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## PUT /annual-events/drafts/{id}

Replace the recipe of an unpublished API event draft

`replace_event_draft`

Required scope: `events:write`. Replaces the complete recipe of an API-owned DRAFT, with explicit expectedRevision and a stable idempotencyKey. Read get_event_draft first and preserve every unrelated declared recipe field: omitted recipe fields are removed, not merged. requestedTimeZone omitted preserves its existing request; null explicitly clears it. This operation never republishes or edits a native event project. Only DRAFT is editable; PUBLISHING, PUBLISHED, MATERIALIZED and PUBLICATION_UNCERTAIN cannot be bypassed by changing the revision or key. References and conditional content_blocks:read are re-admitted before the atomic update. The initial creation key retains its identity after edits. A completed unchanged edit retry returns its recorded acknowledgement, which may precede later edits; use a fresh read for current state. An uncertain private edit is resolved only when the atomic row marker proves that exact command was applied; otherwise it remains uncertain. Arrays and nested objects in recipe are a full replacement, not an incremental patch. Every adapter write requests w:1 and j:true. Journal claims require acknowledged=true and the exact inserted/upserted id; CAS requires positively acknowledged counters. A missing or mismatched acknowledgement stops before the following effect and returns EVENT_WRITE_UNCERTAIN or the operation-specific uncertainty. Keep the identity and key, reconcile, and never force a new key or revision to repeat effects.

### אימות

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### הרשאות נדרשות

```json
{
  "accepted": "events:write",
  "additional": []
}
```

### פרמטרים

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid"
  },
  "description": "Existing API draft UUID returned by create_event_draft."
}
```

### גוף הבקשה

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "idempotencyKey": {
            "type": "string",
            "minLength": 1,
            "maxLength": 200
          },
          "expectedRevision": {
            "type": "integer",
            "minimum": 1
          },
          "recipe": {
            "$ref": "#/components/schemas/UnisoftRequest_b6493128eea60f41ebb4"
          },
          "requestedTimeZone": {
            "type": "string",
            "maxLength": 100,
            "nullable": true
          }
        },
        "required": [
          "idempotencyKey",
          "expectedRevision",
          "recipe"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

### תגובות

#### HTTP 200

```json
{
  "description": "Ordinary-event developer response.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/EventLifecycleResult"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "INVALID_EVENT_DRAFT_INPUT",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "draftId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string"
          },
          "sessionId": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "reason": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "INSUFFICIENT_SCOPE / CAMPAIGN_RESTRICTED_KEY",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "draftId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string"
          },
          "sessionId": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "reason": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "EVENT_DRAFT_NOT_FOUND / EVENT_REFERENCE_NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "draftId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string"
          },
          "sessionId": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "reason": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "REVISION_CONFLICT / IDEMPOTENCY_KEY_CONFLICT / EVENT_DRAFT_STATE_CONFLICT / EVENT_DRAFT_EDIT_UNCERTAIN / EVENT_WRITE_UNCERTAIN",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "draftId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string"
          },
          "sessionId": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "reason": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "events:write",
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  },
  "x-unisoft-mcp-output-schema": true
}
```

## GET /annual-events/drafts/{id}/publication-plan

Preview the canonical publication plan of an event draft

`get_event_draft_publication_plan`

Required scope: `events:read`. Read-only preflight of an API-owned DRAFT. Resolves the effective time zone through the canonical publisher, validates its UTC session instants and requires a proven organisation currency instead of inventing EUR or Europe/Paris. A valid requested time zone is required when organisation coordinates are unavailable. Returned planHash and expectedRevision must be sent unchanged to publish_event_draft. Inspect the exact UTC start/end instants before publication; native daylight-saving resolution is not replaced here. Group, content-block and hosted-poster references are re-admitted. A content block additionally requires content_blocks:read. A plan is an optimistic observation, not a stock reservation, permission grant or lock against internal writers; publication recomputes it. Publication targets the primary publicBaseUrl returned by this plan; no other façade is selected here. No public resources, media downloads, messages or translations are created by this read.

### אימות

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### הרשאות נדרשות

```json
{
  "accepted": "events:read",
  "additional": []
}
```

### פרמטרים

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid"
  },
  "description": "Existing API draft UUID returned by create_event_draft."
}
```

### תגובות

#### HTTP 200

```json
{
  "description": "Ordinary-event developer response.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "data"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/EventLifecyclePublicationPlan"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "INSUFFICIENT_SCOPE / CAMPAIGN_RESTRICTED_KEY",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "draftId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string"
          },
          "sessionId": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "reason": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "EVENT_DRAFT_NOT_FOUND / EVENT_REFERENCE_NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "draftId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string"
          },
          "sessionId": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "reason": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "EVENT_DRAFT_STATE_CONFLICT / EVENT_CURRENCY_UNAVAILABLE / EVENT_TIME_ZONE_REQUIRED / EVENT_PUBLIC_SITE_UNAVAILABLE / EVENT_PUBLICATION_CONTEXT_UNAVAILABLE",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "draftId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string"
          },
          "sessionId": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "reason": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 422

```json
{
  "description": "EVENT_DRAFT_NOT_READY",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "draftId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string"
          },
          "sessionId": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "reason": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "events:read",
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## POST /annual-events/drafts/{id}/publish

Publish a previously saved ordinary-event draft

`publish_event_draft`

Required scope: `events:write`. Explicit real publication through the canonical annual-event owner. First inspect get_event_draft_publication_plan, then supply idempotencyKey, expectedRevision and its unchanged planHash. Stale revision or recipe/context changes are refused before delegation. Additional scopes: forms:write for registration/both, caisses:write for fundraising/both, messages:write when a campaign draft is requested, content_blocks:read for a content block. Campaign creation never sends it. An external atomic claim admits at most one delegation; an unchanged successful retry returns the recorded acknowledgement. RUNNING or UNCERTAIN commands never re-execute the owner automatically: read the draft and existing annual project, retain the commandId, and reconcile. No new key or altered revision may bypass an uncertain result. The result reports the owner-recorded publication: PUBLISHED records a native public resource, while CREATED moves the private recipe to MATERIALIZED without a published page. Neither status proves attendance, payment, message delivery or browser rendering. The recipe remains an API-owned record and the published project becomes visible through the existing annual-event surface. Existing-form attachment remains unavailable. Internal writers are not transactionally locked by this adapter. Every adapter write requests w:1 and j:true. Journal claims require acknowledged=true and the exact inserted/upserted id; CAS requires positively acknowledged counters. A missing or mismatched acknowledgement stops before the following effect and returns EVENT_WRITE_UNCERTAIN or the operation-specific uncertainty. Keep the identity and key, reconcile, and never force a new key or revision to repeat effects.

### אימות

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### הרשאות נדרשות

```json
{
  "accepted": "events:write",
  "additional": []
}
```

### פרמטרים

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid"
  },
  "description": "Existing API draft UUID returned by create_event_draft."
}
```

### גוף הבקשה

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "idempotencyKey": {
            "type": "string",
            "minLength": 1,
            "maxLength": 200
          },
          "expectedRevision": {
            "type": "integer",
            "minimum": 1
          },
          "planHash": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$",
            "description": "Unchanged publication plan hash returned by get_event_draft_publication_plan. It qualifies the recipe, effective currency, time zone and UTC session instants."
          }
        },
        "required": [
          "idempotencyKey",
          "expectedRevision",
          "planHash"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

### תגובות

#### HTTP 200

```json
{
  "description": "Ordinary-event developer response.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "data",
          "replayed"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "replayed": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/EventLifecyclePublication"
          }
        }
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "INVALID_EVENT_PUBLICATION_INPUT",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "draftId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string"
          },
          "sessionId": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "reason": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "INSUFFICIENT_SCOPE",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "draftId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string"
          },
          "sessionId": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "reason": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "EVENT_DRAFT_NOT_FOUND / EVENT_REFERENCE_NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "draftId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string"
          },
          "sessionId": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "reason": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "REVISION_CONFLICT / EVENT_PUBLICATION_PLAN_CHANGED / EVENT_PUBLICATION_UNCERTAIN / EVENT_PROJECT_ALREADY_EXISTS / EVENT_DRAFT_STATE_CONFLICT / EVENT_WRITE_UNCERTAIN",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "draftId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string"
          },
          "sessionId": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "reason": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 422

```json
{
  "description": "EVENT_DRAFT_NOT_READY",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "draftId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string"
          },
          "sessionId": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "reason": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "EVENT_DRAFT_UNAVAILABLE",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "draftId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string"
          },
          "sessionId": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "reason": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "events:write",
  "x-unisoft-mcp": {
    "category": "action",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": true
  },
  "x-unisoft-mcp-output-schema": true
}
```

## POST /annual-events/{id}/duplicate-draft

Copy a managed annual event into a new private recipe draft

`duplicate_event_to_draft`

Required scopes: `events:write` and `events:read`. Copies only the canonical configuration and session schedule of an existing ordinary managed annual project at expectedRevision into a new API-owned private draft. idempotencyKey is stable within organisation/duplication operation; changed source, revision or title with that key returns 409. Optional title replaces the copied title. The destination is deliberately reset to new/unconfirmed: read and review the new recipe before choosing where to publish it. Prices are copied in major currency units without conversion only when the stored source currency equals the proven current organisation currency. The source time zone is copied as a publication request; later publication must inspect its effective plan again. Current source session ids/dates are re-admitted against the canonical recipe; a stale, manual, protected or ambiguous source is refused. A copied content block requires content_blocks:read. Only recipe fields are copied: no source resource ids, registrations, tickets, payment history, sent campaigns or native publication state. The source is never modified, no public resource is created, and no message is sent. The resulting API draft is not an admin browser-local draft. A completed identical retry returns its recorded acknowledgement, which can predate subsequent target edits. An uncertain acknowledgement can be confirmed only from the deterministic target and immutable creation fingerprint; otherwise keep the commandId and reconcile, without choosing another key automatically. This is an optimistic source observation, not a transaction against internal edits. Every adapter write requests w:1 and j:true. Journal claims require acknowledged=true and the exact inserted/upserted id; CAS requires positively acknowledged counters. A missing or mismatched acknowledgement stops before the following effect and returns EVENT_WRITE_UNCERTAIN or the operation-specific uncertainty. Keep the identity and key, reconcile, and never force a new key or revision to repeat effects.

### אימות

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### הרשאות נדרשות

```json
{
  "accepted": "events:write",
  "additional": [
    "events:read"
  ]
}
```

### פרמטרים

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "pattern": "^[A-Za-z0-9_-]{3,128}$"
  }
}
```

### גוף הבקשה

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "idempotencyKey": {
            "type": "string",
            "minLength": 1,
            "maxLength": 200
          },
          "expectedRevision": {
            "type": "integer",
            "minimum": 1
          },
          "title": {
            "type": "string",
            "minLength": 3,
            "maxLength": 500
          }
        },
        "required": [
          "idempotencyKey",
          "expectedRevision"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

### תגובות

#### HTTP 200

```json
{
  "description": "Ordinary-event developer response.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/EventLifecycleResult"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "INVALID_EVENT_DUPLICATE_INPUT",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "draftId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string"
          },
          "sessionId": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "reason": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "INSUFFICIENT_SCOPE / CAMPAIGN_RESTRICTED_KEY",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "draftId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string"
          },
          "sessionId": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "reason": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "EVENT_NOT_FOUND / EVENT_REFERENCE_NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "draftId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string"
          },
          "sessionId": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "reason": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "REVISION_CONFLICT / IDEMPOTENCY_KEY_CONFLICT / INVALID_EVENT_GRAPH / EVENT_DUPLICATION_UNCERTAIN / EVENT_CURRENCY_CHANGED / EVENT_WRITE_UNCERTAIN",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "draftId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string"
          },
          "sessionId": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "reason": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "events:write",
  "x-unisoft-additional-scopes": [
    "events:read"
  ],
  "x-unisoft-mcp": {
    "category": "create",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  },
  "x-unisoft-mcp-output-schema": true
}
```

## GET /annual-events/{id}/unpublication-plan

Preview hiding an event page while retaining its records

`preview_event_unpublication`

Required scope: `events:read`, plus forms:read and caisses:read when linked managed resources exist. Read-only preflight of an ordinary published managed annual project. Returns its native expectedRevision, planHash and exact session/form/fundraiser ids affected by unpublish_event. No query parameter or body is accepted. Hiding all managed sessions removes their event page from the public event catalogue; linked managed forms become inactive and linked managed fundraisers become inactive. This preserves records, registrations, tickets, products and payments, but does not show a public cancellation notice. It does not revoke an existing payment capability, stop a subscription, refund money or send messages. Review the returned requiredScopes and all affected ids; this is an optimistic observation and not a global lock. Native publicationStatus is retained as owner history; visibility is a separate external observation. Protected, foreign, ambiguous or incomplete graphs and campaign-restricted credentials are refused.

### אימות

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### הרשאות נדרשות

```json
{
  "accepted": "events:read",
  "additional": []
}
```

### פרמטרים

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "pattern": "^[A-Za-z0-9_-]{3,128}$"
  }
}
```

### תגובות

#### HTTP 200

```json
{
  "description": "Ordinary-event developer response.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "data"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/EventLifecycleUnpublishPlan"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "INSUFFICIENT_SCOPE / CAMPAIGN_RESTRICTED_KEY",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "draftId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string"
          },
          "sessionId": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "reason": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "EVENT_NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "draftId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string"
          },
          "sessionId": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "reason": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "INVALID_EVENT_GRAPH / EVENT_VISIBILITY_STATE_CONFLICT / EVENT_UNPUBLICATION_UNCERTAIN",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "draftId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string"
          },
          "sessionId": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "reason": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "events:read",
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## POST /annual-events/{id}/unpublish

Hide a managed event page while retaining registrations and history

`unpublish_event`

Required scope: `events:write`, plus forms:write and caisses:write when linked managed resources exist. First inspect preview_event_unpublication and all affected ids. Supply its native expectedRevision, unchanged planHash and a stable idempotencyKey. After re-admission and a native revision claim, sets only the admitted managed sessions/forms/fundraisers inactive, records external visibility UNPUBLISHED and invalidates public caches. Retains native publicationStatus as owner history; it does not invent a native cancellation state or public Annulé notice. Project, sessions, forms, products, registrations, tickets and payments are retained with their ids. No refund, subscription stop, payment-capability revocation, message cancellation or notification is implied. Completed identical retries return their recorded acknowledgement. RUNNING/UNCERTAIN or partial storage/cache results stay EVENT_UNPUBLICATION_UNCERTAIN; keep commandId/projectId and reconcile, never force a new key or revision. Current public visibility can already have changed during uncertainty. Additional read scopes are needed for the preview, and corresponding write scopes for this command. Internal writers are not transactionally locked. Campaign-restricted credentials are refused. Every adapter write requests w:1 and j:true. Journal claims require acknowledged=true and the exact inserted/upserted id; CAS requires positively acknowledged counters. A missing or mismatched acknowledgement stops before the following effect and returns EVENT_WRITE_UNCERTAIN or the operation-specific uncertainty. Keep the identity and key, reconcile, and never force a new key or revision to repeat effects.

### אימות

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### הרשאות נדרשות

```json
{
  "accepted": "events:write",
  "additional": []
}
```

### פרמטרים

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "pattern": "^[A-Za-z0-9_-]{3,128}$"
  }
}
```

### גוף הבקשה

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "idempotencyKey": {
            "type": "string",
            "minLength": 1,
            "maxLength": 200
          },
          "expectedRevision": {
            "type": "integer",
            "minimum": 1
          },
          "planHash": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$",
            "description": "Unchanged planHash from preview_event_unpublication, qualifying the exact managed resources and visibility observation."
          }
        },
        "required": [
          "idempotencyKey",
          "expectedRevision",
          "planHash"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

### תגובות

#### HTTP 200

```json
{
  "description": "Ordinary-event developer response.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "data",
          "replayed"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "replayed": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/EventLifecycleUnpublishResult"
          }
        }
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "INVALID_EVENT_UNPUBLICATION_INPUT",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "draftId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string"
          },
          "sessionId": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "reason": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "INSUFFICIENT_SCOPE / CAMPAIGN_RESTRICTED_KEY",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "draftId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string"
          },
          "sessionId": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "reason": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "EVENT_NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "draftId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string"
          },
          "sessionId": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "reason": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "REVISION_CONFLICT / IDEMPOTENCY_KEY_CONFLICT / EVENT_UNPUBLICATION_PLAN_CHANGED / EVENT_UNPUBLICATION_UNCERTAIN / INVALID_EVENT_GRAPH / EVENT_VISIBILITY_STATE_CONFLICT / EVENT_WRITE_UNCERTAIN",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "draftId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string"
          },
          "sessionId": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "reason": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "events:write",
  "x-unisoft-mcp": {
    "category": "action",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": true
  },
  "x-unisoft-mcp-output-schema": true
}
```

## POST /annual-events/{id}/sessions/{sessionId}/reschedule-plan

Preview an identity-preserving session reschedule

`preview_event_session_reschedule`

Required scope: `events:read`. Read-only preflight: writes no project, cache, message or form. Returns the native project revision, planHash, exact UTC instants and ids preserved by reschedule_event_session; this is an optimistic observation, not a lock or reservation. Only ordinary published managed annual projects are supported, with exact organisation/scalar references. localDate and wall times use the project’s existing IANA zone, never a new guessed zone. Session, form, product, fundraiser and livret ids and existing registrations/tickets are preserved; no registration, payment, ticket or message is created, deleted or resent. Additional read scopes are required for linked forms and fundraisers. Multi-session date changes retain every other date and explicitly convert the recipe to custom dates; changing only one session’s hours in a series is refused because the canonical recipe has common hours. Products with attendee modules (family/children/group) and ambiguous/manual form graphs are refused until their future publication can preserve all answer bindings. Dates are changed in place, not through patch_annual_event which can recreate sessions. Campaigns and previously sent communications remain unchanged: no participant notification is implied. Internal writers are not transactionally locked. Campaign-restricted credentials are refused.

### אימות

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### הרשאות נדרשות

```json
{
  "accepted": "events:read",
  "additional": []
}
```

### פרמטרים

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "pattern": "^[A-Za-z0-9_-]{3,128}$"
  }
}
```

```json
{
  "name": "sessionId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "pattern": "^[A-Za-z0-9_-]{3,128}$"
  }
}
```

### גוף הבקשה

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "localDate": {
            "type": "string",
            "format": "date"
          },
          "startTime": {
            "type": "string",
            "pattern": "^(?:[01][0-9]|2[0-3]):[0-5][0-9]$"
          },
          "endTime": {
            "type": "string",
            "pattern": "^(?:[01][0-9]|2[0-3]):[0-5][0-9]$"
          }
        },
        "required": [
          "localDate",
          "startTime",
          "endTime"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

### תגובות

#### HTTP 200

```json
{
  "description": "Ordinary-event developer response.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "data"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "replayed": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/EventLifecycleReschedulePlan"
          }
        }
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "INVALID_EVENT_RESCHEDULE_INPUT",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "draftId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string"
          },
          "sessionId": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "reason": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "INSUFFICIENT_SCOPE / CAMPAIGN_RESTRICTED_KEY",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "draftId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string"
          },
          "sessionId": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "reason": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "EVENT_NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "draftId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string"
          },
          "sessionId": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "reason": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "REVISION_CONFLICT / EVENT_RESCHEDULE_PLAN_CHANGED / EVENT_RESCHEDULE_UNCERTAIN / EVENT_RESCHEDULE_UNSUPPORTED / INVALID_EVENT_GRAPH / IDEMPOTENCY_KEY_CONFLICT",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "draftId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string"
          },
          "sessionId": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "reason": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "events:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  },
  "x-unisoft-mcp-output-schema": true
}
```

## POST /annual-events/{id}/sessions/{sessionId}/reschedule

Reschedule one managed event session while keeping its identities

`reschedule_event_session`

Required scope: `events:write`. First call preview_event_session_reschedule and inspect its exact UTC instants, preserved ids and requiredScopes. Supply its unchanged planHash, expectedRevision and a stable idempotencyKey together with the same localDate/startTime/endTime. The plan and references are re-admitted before an atomic native-project revision claim. A completed identical retry returns its recorded acknowledgement; RUNNING or UNCERTAIN commands must never be retried with a new key or forced revision. Partial storage/cache failures remain EVENT_RESCHEDULE_UNCERTAIN and require reconciliation by project/session/command ids. Only ordinary published managed annual projects are supported, with exact organisation/scalar references. localDate and wall times use the project’s existing IANA zone, never a new guessed zone. Session, form, product, fundraiser and livret ids and existing registrations/tickets are preserved; no registration, payment, ticket or message is created, deleted or resent. Additional write scopes are required for linked forms and fundraisers. Multi-session date changes retain every other date and explicitly convert the recipe to custom dates; changing only one session’s hours in a series is refused because the canonical recipe has common hours. Products with attendee modules (family/children/group) and ambiguous/manual form graphs are refused until their future publication can preserve all answer bindings. Dates are changed in place, not through patch_annual_event which can recreate sessions. Campaigns and previously sent communications remain unchanged: no participant notification is implied. Internal writers are not transactionally locked. Campaign-restricted credentials are refused. Every adapter write requests w:1 and j:true. Journal claims require acknowledged=true and the exact inserted/upserted id; CAS requires positively acknowledged counters. A missing or mismatched acknowledgement stops before the following effect and returns EVENT_WRITE_UNCERTAIN or the operation-specific uncertainty. Keep the identity and key, reconcile, and never force a new key or revision to repeat effects.

### אימות

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### הרשאות נדרשות

```json
{
  "accepted": "events:write",
  "additional": []
}
```

### פרמטרים

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "pattern": "^[A-Za-z0-9_-]{3,128}$"
  }
}
```

```json
{
  "name": "sessionId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "pattern": "^[A-Za-z0-9_-]{3,128}$"
  }
}
```

### גוף הבקשה

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "localDate": {
            "type": "string",
            "format": "date"
          },
          "startTime": {
            "type": "string",
            "pattern": "^(?:[01][0-9]|2[0-3]):[0-5][0-9]$"
          },
          "endTime": {
            "type": "string",
            "pattern": "^(?:[01][0-9]|2[0-3]):[0-5][0-9]$"
          },
          "idempotencyKey": {
            "type": "string",
            "minLength": 1,
            "maxLength": 200
          },
          "expectedRevision": {
            "type": "integer",
            "minimum": 1
          },
          "planHash": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          }
        },
        "required": [
          "localDate",
          "startTime",
          "endTime",
          "idempotencyKey",
          "expectedRevision",
          "planHash"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

### תגובות

#### HTTP 200

```json
{
  "description": "Ordinary-event developer response.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "data"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "replayed": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/EventLifecycleRescheduleResult"
          }
        }
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "INVALID_EVENT_RESCHEDULE_INPUT",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "draftId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string"
          },
          "sessionId": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "reason": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "INSUFFICIENT_SCOPE / CAMPAIGN_RESTRICTED_KEY",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "draftId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string"
          },
          "sessionId": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "reason": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "EVENT_NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "draftId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string"
          },
          "sessionId": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "reason": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "REVISION_CONFLICT / EVENT_RESCHEDULE_PLAN_CHANGED / EVENT_RESCHEDULE_UNCERTAIN / EVENT_RESCHEDULE_UNSUPPORTED / INVALID_EVENT_GRAPH / IDEMPOTENCY_KEY_CONFLICT / EVENT_WRITE_UNCERTAIN",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "draftId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string"
          },
          "sessionId": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "reason": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "events:write",
  "x-unisoft-mcp": {
    "category": "action",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": true
  },
  "x-unisoft-mcp-output-schema": true
}
```

## סכמות

```json
{
  "components": {
    "schemas": {
      "AnnualEventProject": {
        "allOf": [
          {
            "$ref": "#/components/schemas/AnnualEventPublishResult"
          },
          {
            "type": "object",
            "properties": {
              "draft": {
                "$ref": "#/components/schemas/AnnualEventDraft"
              },
              "snapshotHash": {
                "type": "string"
              },
              "datetime": {
                "type": "string",
                "format": "date-time"
              },
              "updatedAt": {
                "type": "string",
                "format": "date-time"
              }
            }
          }
        ]
      },
      "AnnualEventPublishResult": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "eventId": {
            "type": "string"
          },
          "projectId": {
            "type": "string"
          },
          "revision": {
            "type": "integer"
          },
          "publicationStatus": {
            "type": "string",
            "enum": [
              "CREATED",
              "PUBLISHED",
              "PUBLISHING",
              "PUBLISH_FAILED"
            ]
          },
          "publishedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "publicUrl": {
            "type": "string",
            "nullable": true
          },
          "resources": {
            "$ref": "#/components/schemas/AnnualEventResources"
          },
          "operationalState": {
            "$ref": "#/components/schemas/AnnualEventOperationalState"
          }
        }
      },
      "AnnualEventResources": {
        "type": "object",
        "properties": {
          "groupId": {
            "type": "string",
            "nullable": true
          },
          "sessionIds": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "formIds": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "fundraiserIds": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "campaignIds": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      },
      "AnnualEventOperationalState": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "registration": {
            "$ref": "#/components/schemas/AnnualEventRegistrationState"
          }
        },
        "required": [
          "registration"
        ]
      },
      "AnnualEventRegistrationState": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "configured": {
            "type": "boolean",
            "description": "Whether at least one managed registration form exists."
          },
          "open": {
            "type": "boolean",
            "description": "Whether a managed form and one of its event sessions are currently active."
          },
          "submissionCount": {
            "type": "integer",
            "minimum": 0,
            "description": "Received, non-archived registrations in SUBMIT or VALIDE state."
          }
        },
        "required": [
          "configured",
          "open",
          "submissionCount"
        ]
      },
      "AnnualEventDraft": {
        "type": "object",
        "additionalProperties": false,
        "description": "Complete event recipe. The server normalises this object and materialises all requested resources. Amounts are in major currency units. An `upload` poster is a real image; pass either a hosted filename from `/uploads/image` or an http(s) URL that the server can re-host.",
        "properties": {
          "id": {
            "type": "string",
            "nullable": true,
            "description": "Optional project UUID. Omit on create; keep it for updates."
          },
          "version": {
            "type": "integer",
            "minimum": 1,
            "default": 1
          },
          "templateId": {
            "type": "string",
            "description": "Suggested format id, or `custom`."
          },
          "destination": {
            "$ref": "#/components/schemas/AnnualEventDestination"
          },
          "capabilities": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "title": {
            "type": "string",
            "minLength": 3,
            "maxLength": 500
          },
          "sourceLanguage": {
            "type": "string",
            "description": "Language of the supplied content; defaults to the organisation language. Multilingual organisations receive automatic content translations at creation."
          },
          "currency": {
            "type": "string",
            "readOnly": true,
            "description": "Primary currency resolved by the server from the organisation."
          },
          "tagline": {
            "type": "string",
            "maxLength": 2000
          },
          "description": {
            "type": "string",
            "maxLength": 20000
          },
          "mode": {
            "type": "string",
            "enum": [
              "registration",
              "fundraising",
              "both",
              "information"
            ]
          },
          "attendeeMode": {
            "type": "string",
            "enum": [
              "individual",
              "group",
              "family",
              "children"
            ]
          },
          "date": {
            "type": "string",
            "format": "date",
            "description": "Required except for a date-optional standalone fundraiser."
          },
          "dateOptional": {
            "type": "boolean"
          },
          "startTime": {
            "type": "string",
            "pattern": "^[0-2][0-9]:[0-5][0-9]$"
          },
          "endTime": {
            "type": "string",
            "pattern": "^[0-2][0-9]:[0-5][0-9]$"
          },
          "locationMode": {
            "type": "string",
            "enum": [
              "onsite",
              "online"
            ]
          },
          "locationName": {
            "type": "string",
            "maxLength": 500
          },
          "address": {
            "type": "string",
            "maxLength": 1000
          },
          "onlineUrl": {
            "type": "string",
            "format": "uri"
          },
          "cadence": {
            "type": "string",
            "enum": [
              "once",
              "weekly",
              "monthly",
              "custom"
            ]
          },
          "recurrenceCount": {
            "type": "integer",
            "minimum": 1,
            "maximum": 200
          },
          "customDates": {
            "type": "array",
            "maxItems": 200,
            "uniqueItems": true,
            "items": {
              "type": "string",
              "format": "date"
            },
            "description": "All session dates when cadence=custom. The first date and count are derived from this list."
          },
          "excludedDates": {
            "type": "array",
            "maxItems": 200,
            "items": {
              "type": "string",
              "format": "date"
            }
          },
          "slotDuration": {
            "type": "integer",
            "minimum": 0
          },
          "slotCapacity": {
            "type": "integer",
            "minimum": 0
          },
          "capacityEnabled": {
            "type": "boolean"
          },
          "capacity": {
            "type": "integer",
            "minimum": 0
          },
          "priceMode": {
            "type": "string",
            "enum": [
              "free",
              "fixed",
              "multiple",
              "freeAmount"
            ]
          },
          "price": {
            "type": "number",
            "minimum": 0
          },
          "prices": {
            "type": "object",
            "additionalProperties": {
              "type": "number",
              "minimum": 0
            },
            "description": "Optional prices keyed by enabled secondary currency (lowercase ISO code). Missing values keep the primary numeric price without conversion."
          },
          "tariffs": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "$ref": "#/components/schemas/AnnualEventTariff"
            }
          },
          "target": {
            "type": "number",
            "minimum": 0
          },
          "partialPayments": {
            "type": "boolean"
          },
          "depositAmount": {
            "type": "number",
            "minimum": 0
          },
          "contributionAmounts": {
            "type": "array",
            "maxItems": 20,
            "items": {
              "type": "number",
              "minimum": 0
            }
          },
          "fields": {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "firstName",
                "lastName",
                "email",
                "phone",
                "address",
                "birthDate"
              ]
            }
          },
          "children": {
            "type": "boolean"
          },
          "questions": {
            "type": "array",
            "maxItems": 100,
            "items": {
              "$ref": "#/components/schemas/AnnualEventQuestion"
            }
          },
          "requirementsEnabled": {
            "type": "boolean"
          },
          "requirements": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "$ref": "#/components/schemas/AnnualEventRequirement"
            }
          },
          "manualValidation": {
            "type": "boolean"
          },
          "confirmationText": {
            "type": "string",
            "maxLength": 5000
          },
          "reminders": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "confirmation": {
                "type": "boolean"
              },
              "weekBefore": {
                "type": "boolean"
              },
              "dayBefore": {
                "type": "boolean"
              }
            }
          },
          "page": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "layout": {
                "type": "string",
                "enum": [
                  "essential",
                  "story",
                  "campaign"
                ]
              },
              "ctaLabel": {
                "type": "string",
                "maxLength": 300
              },
              "showDescription": {
                "type": "boolean"
              },
              "showPracticalInfo": {
                "type": "boolean"
              },
              "showOrganizer": {
                "type": "boolean"
              },
              "showProgress": {
                "type": "boolean"
              },
              "customContent": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "kind": {
                    "type": "string",
                    "enum": [
                      "faq",
                      "pricing",
                      "programme",
                      "speakers",
                      "free"
                    ]
                  },
                  "aiContentBlockId": {
                    "type": "string",
                    "nullable": true,
                    "description": "Existing AI content-block id. Manage its HTML through `/content-blocks`."
                  }
                }
              }
            }
          },
          "poster": {
            "type": "object",
            "additionalProperties": false,
            "description": "A poster exists only when `source=upload` and `image` references a real image.",
            "properties": {
              "source": {
                "type": "string",
                "enum": [
                  "none",
                  "upload"
                ]
              },
              "image": {
                "type": "string",
                "nullable": true,
                "description": "Hosted filename or http(s) image URL."
              },
              "tone": {
                "type": "string",
                "enum": [
                  "auto",
                  "blue",
                  "cyan",
                  "violet",
                  "green",
                  "amber",
                  "rose",
                  "red"
                ],
                "description": "auto follows the public site's theme; explicit colors stay fixed."
              },
              "badge": {
                "type": "string",
                "maxLength": 300
              }
            }
          },
          "campaignEnabled": {
            "type": "boolean",
            "description": "When true, create or update a campaign DRAFT; it is never sent automatically."
          },
          "campaign": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "channels": {
                "type": "array",
                "minItems": 1,
                "maxItems": 3,
                "items": {
                  "type": "string",
                  "enum": [
                    "email",
                    "whatsapp",
                    "sms"
                  ]
                }
              },
              "audience": {
                "type": "string",
                "enum": [
                  "all",
                  "families",
                  "participants",
                  "custom"
                ],
                "description": "`families`, `participants` and `custom` keep the draft without automatic targeting until the organiser chooses the exact audience."
              },
              "includePoster": {
                "type": "boolean",
                "description": "The image is attached only when a real uploaded poster exists."
              },
              "message": {
                "type": "string",
                "maxLength": 10000
              },
              "schedule": {
                "type": "string",
                "enum": [
                  "now",
                  "later"
                ]
              },
              "scheduledAt": {
                "type": "string",
                "nullable": true,
                "description": "ISO date-time used when the campaign is eventually sent."
              }
            }
          },
          "posterAnalysis": {
            "type": "object",
            "nullable": true,
            "additionalProperties": false,
            "description": "Audit metadata retained when the draft was prepared from a poster.",
            "properties": {
              "confidence": {
                "type": "string",
                "enum": [
                  "high",
                  "medium",
                  "low"
                ]
              },
              "detectedLanguage": {
                "type": "string"
              },
              "sourceSummary": {
                "type": "string"
              },
              "extractedText": {
                "type": "string"
              },
              "warnings": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "analyzedAt": {
                "type": "string"
              }
            }
          },
          "draftStatus": {
            "type": "string",
            "enum": [
              "EDITING",
              "READY"
            ]
          },
          "validatedAt": {
            "type": "string",
            "nullable": true
          },
          "cursorStepId": {
            "type": "string"
          }
        },
        "required": [
          "title",
          "destination",
          "mode"
        ]
      },
      "AnnualEventDestination": {
        "type": "object",
        "additionalProperties": false,
        "description": "Where the event belongs. Use `existing` only after listing and explicitly selecting a compatible ordinary group; protected and multi-session groups are rejected.",
        "properties": {
          "kind": {
            "type": "string",
            "enum": [
              "new",
              "existing"
            ],
            "default": "new"
          },
          "groupId": {
            "type": "string",
            "nullable": true,
            "description": "Existing ordinary standalone group id."
          },
          "groupLabel": {
            "type": "string",
            "maxLength": 500
          },
          "confirmed": {
            "type": "boolean",
            "description": "Must be true: the caller confirms the destination decision."
          }
        },
        "required": [
          "kind",
          "confirmed"
        ]
      },
      "AnnualEventTariff": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "id": {
            "type": "string",
            "maxLength": 100
          },
          "label": {
            "type": "string",
            "maxLength": 300
          },
          "price": {
            "type": "number",
            "minimum": 0
          },
          "prices": {
            "type": "object",
            "additionalProperties": {
              "type": "number",
              "minimum": 0
            },
            "description": "Optional prices keyed by enabled secondary currency (lowercase ISO code). Missing values keep the primary numeric price without conversion."
          },
          "stock": {
            "type": "integer",
            "minimum": 0,
            "nullable": true
          }
        },
        "required": [
          "label",
          "price"
        ]
      },
      "AnnualEventQuestion": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "id": {
            "type": "string",
            "maxLength": 100
          },
          "label": {
            "type": "string",
            "maxLength": 500
          },
          "type": {
            "type": "string",
            "enum": [
              "shortText",
              "longText",
              "yesNo",
              "choice",
              "document"
            ]
          },
          "required": {
            "type": "boolean"
          },
          "options": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "type": "string",
              "maxLength": 300
            }
          },
          "condition": {
            "type": "object",
            "nullable": true,
            "additionalProperties": false,
            "properties": {
              "questionId": {
                "type": "string"
              },
              "value": {
                "type": "string"
              }
            },
            "required": [
              "questionId",
              "value"
            ]
          }
        },
        "required": [
          "label",
          "type"
        ]
      },
      "AnnualEventRequirement": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "id": {
            "type": "string"
          },
          "label": {
            "type": "string",
            "maxLength": 500
          },
          "required": {
            "type": "boolean"
          }
        },
        "required": [
          "label"
        ]
      },
      "Pagination": {
        "type": "object",
        "properties": {
          "nextCursor": {
            "type": "string",
            "nullable": true
          },
          "hasMore": {
            "type": "boolean"
          },
          "count": {
            "type": "integer"
          }
        }
      },
      "UnisoftRequest_133a453e99d95d23090e": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "nullable": true,
            "description": "Optional project UUID. Omit on create; keep it for updates."
          },
          "version": {
            "type": "integer",
            "minimum": 1,
            "default": 1
          },
          "templateId": {
            "type": "string",
            "description": "Suggested format id, or `custom`."
          },
          "destination": {
            "type": "object",
            "properties": {
              "kind": {
                "type": "string",
                "enum": [
                  "new",
                  "existing"
                ],
                "default": "new"
              },
              "groupId": {
                "type": "string",
                "nullable": true,
                "description": "Existing ordinary standalone group id."
              },
              "groupLabel": {
                "type": "string",
                "maxLength": 500
              },
              "confirmed": {
                "type": "boolean",
                "description": "Must be true: the caller confirms the destination decision."
              }
            },
            "required": [
              "kind",
              "confirmed"
            ],
            "additionalProperties": false,
            "description": "Where the event belongs. Use `existing` only after listing and explicitly selecting a compatible ordinary group; protected and multi-session groups are rejected."
          },
          "capabilities": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "title": {
            "type": "string",
            "minLength": 3,
            "maxLength": 500
          },
          "sourceLanguage": {
            "type": "string",
            "description": "Language of the supplied content; defaults to the organisation language. Multilingual organisations receive automatic content translations at creation."
          },
          "currency": {
            "not": {}
          },
          "tagline": {
            "type": "string",
            "maxLength": 2000
          },
          "description": {
            "type": "string",
            "maxLength": 20000
          },
          "mode": {
            "type": "string",
            "enum": [
              "registration",
              "fundraising",
              "both",
              "information"
            ]
          },
          "attendeeMode": {
            "type": "string",
            "enum": [
              "individual",
              "group",
              "family",
              "children"
            ]
          },
          "date": {
            "type": "string",
            "format": "date",
            "description": "Required except for a date-optional standalone fundraiser."
          },
          "dateOptional": {
            "type": "boolean"
          },
          "startTime": {
            "type": "string",
            "pattern": "^[0-2][0-9]:[0-5][0-9]$"
          },
          "endTime": {
            "type": "string",
            "pattern": "^[0-2][0-9]:[0-5][0-9]$"
          },
          "locationMode": {
            "type": "string",
            "enum": [
              "onsite",
              "online"
            ]
          },
          "locationName": {
            "type": "string",
            "maxLength": 500
          },
          "address": {
            "type": "string",
            "maxLength": 1000
          },
          "onlineUrl": {
            "type": "string",
            "format": "uri"
          },
          "cadence": {
            "type": "string",
            "enum": [
              "once",
              "weekly",
              "monthly",
              "custom"
            ]
          },
          "recurrenceCount": {
            "type": "integer",
            "minimum": 1,
            "maximum": 200
          },
          "customDates": {
            "type": "array",
            "maxItems": 200,
            "uniqueItems": true,
            "items": {
              "type": "string",
              "format": "date"
            },
            "description": "All session dates when cadence=custom. The first date and count are derived from this list."
          },
          "excludedDates": {
            "type": "array",
            "maxItems": 200,
            "items": {
              "type": "string",
              "format": "date"
            }
          },
          "slotDuration": {
            "type": "integer",
            "minimum": 0
          },
          "slotCapacity": {
            "type": "integer",
            "minimum": 0
          },
          "capacityEnabled": {
            "type": "boolean"
          },
          "capacity": {
            "type": "integer",
            "minimum": 0
          },
          "priceMode": {
            "type": "string",
            "enum": [
              "free",
              "fixed",
              "multiple",
              "freeAmount"
            ]
          },
          "price": {
            "type": "number",
            "minimum": 0
          },
          "prices": {
            "type": "object",
            "additionalProperties": {
              "type": "number",
              "minimum": 0
            },
            "description": "Optional prices keyed by enabled secondary currency (lowercase ISO code). Missing values keep the primary numeric price without conversion."
          },
          "tariffs": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string",
                  "maxLength": 100
                },
                "label": {
                  "type": "string",
                  "maxLength": 300
                },
                "price": {
                  "type": "number",
                  "minimum": 0
                },
                "prices": {
                  "type": "object",
                  "additionalProperties": {
                    "type": "number",
                    "minimum": 0
                  },
                  "description": "Optional prices keyed by enabled secondary currency (lowercase ISO code). Missing values keep the primary numeric price without conversion."
                },
                "stock": {
                  "type": "integer",
                  "minimum": 0,
                  "nullable": true
                }
              },
              "required": [
                "label",
                "price"
              ],
              "additionalProperties": false
            }
          },
          "target": {
            "type": "number",
            "minimum": 0
          },
          "partialPayments": {
            "type": "boolean"
          },
          "depositAmount": {
            "type": "number",
            "minimum": 0
          },
          "contributionAmounts": {
            "type": "array",
            "maxItems": 20,
            "items": {
              "type": "number",
              "minimum": 0
            }
          },
          "fields": {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "firstName",
                "lastName",
                "email",
                "phone",
                "address",
                "birthDate"
              ]
            }
          },
          "children": {
            "type": "boolean"
          },
          "questions": {
            "type": "array",
            "maxItems": 100,
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string",
                  "maxLength": 100
                },
                "label": {
                  "type": "string",
                  "maxLength": 500
                },
                "type": {
                  "type": "string",
                  "enum": [
                    "shortText",
                    "longText",
                    "yesNo",
                    "choice",
                    "document"
                  ]
                },
                "required": {
                  "type": "boolean"
                },
                "options": {
                  "type": "array",
                  "maxItems": 50,
                  "items": {
                    "type": "string",
                    "maxLength": 300
                  }
                },
                "condition": {
                  "type": "object",
                  "properties": {
                    "questionId": {
                      "type": "string"
                    },
                    "value": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "questionId",
                    "value"
                  ],
                  "additionalProperties": false,
                  "nullable": true
                }
              },
              "required": [
                "label",
                "type"
              ],
              "additionalProperties": false
            }
          },
          "requirementsEnabled": {
            "type": "boolean"
          },
          "requirements": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "label": {
                  "type": "string",
                  "maxLength": 500
                },
                "required": {
                  "type": "boolean"
                }
              },
              "required": [
                "label"
              ],
              "additionalProperties": false
            }
          },
          "manualValidation": {
            "type": "boolean"
          },
          "confirmationText": {
            "type": "string",
            "maxLength": 5000
          },
          "reminders": {
            "type": "object",
            "properties": {
              "confirmation": {
                "type": "boolean"
              },
              "weekBefore": {
                "type": "boolean"
              },
              "dayBefore": {
                "type": "boolean"
              }
            },
            "additionalProperties": false
          },
          "page": {
            "type": "object",
            "properties": {
              "layout": {
                "type": "string",
                "enum": [
                  "essential",
                  "story",
                  "campaign"
                ]
              },
              "ctaLabel": {
                "type": "string",
                "maxLength": 300
              },
              "showDescription": {
                "type": "boolean"
              },
              "showPracticalInfo": {
                "type": "boolean"
              },
              "showOrganizer": {
                "type": "boolean"
              },
              "showProgress": {
                "type": "boolean"
              },
              "customContent": {
                "type": "object",
                "properties": {
                  "kind": {
                    "type": "string",
                    "enum": [
                      "faq",
                      "pricing",
                      "programme",
                      "speakers",
                      "free"
                    ]
                  },
                  "aiContentBlockId": {
                    "type": "string",
                    "nullable": true,
                    "description": "Existing AI content-block id. Manage its HTML through `/content-blocks`."
                  }
                },
                "additionalProperties": false
              }
            },
            "additionalProperties": false
          },
          "poster": {
            "type": "object",
            "properties": {
              "source": {
                "type": "string",
                "enum": [
                  "none",
                  "upload"
                ]
              },
              "image": {
                "type": "string",
                "nullable": true,
                "description": "Hosted filename or http(s) image URL."
              },
              "tone": {
                "type": "string",
                "enum": [
                  "auto",
                  "blue",
                  "cyan",
                  "violet",
                  "green",
                  "amber",
                  "rose",
                  "red"
                ],
                "description": "auto follows the public site's theme; explicit colors stay fixed."
              },
              "badge": {
                "type": "string",
                "maxLength": 300
              }
            },
            "additionalProperties": false,
            "description": "A poster exists only when `source=upload` and `image` references a real image."
          },
          "campaignEnabled": {
            "type": "boolean",
            "description": "When true, create or update a campaign DRAFT; it is never sent automatically."
          },
          "campaign": {
            "type": "object",
            "properties": {
              "channels": {
                "type": "array",
                "minItems": 1,
                "maxItems": 3,
                "items": {
                  "type": "string",
                  "enum": [
                    "email",
                    "whatsapp",
                    "sms"
                  ]
                }
              },
              "audience": {
                "type": "string",
                "enum": [
                  "all",
                  "families",
                  "participants",
                  "custom"
                ],
                "description": "`families`, `participants` and `custom` keep the draft without automatic targeting until the organiser chooses the exact audience."
              },
              "includePoster": {
                "type": "boolean",
                "description": "The image is attached only when a real uploaded poster exists."
              },
              "message": {
                "type": "string",
                "maxLength": 10000
              },
              "schedule": {
                "type": "string",
                "enum": [
                  "now",
                  "later"
                ]
              },
              "scheduledAt": {
                "type": "string",
                "nullable": true,
                "description": "ISO date-time used when the campaign is eventually sent."
              }
            },
            "additionalProperties": false
          },
          "posterAnalysis": {
            "type": "object",
            "properties": {
              "confidence": {
                "type": "string",
                "enum": [
                  "high",
                  "medium",
                  "low"
                ]
              },
              "detectedLanguage": {
                "type": "string"
              },
              "sourceSummary": {
                "type": "string"
              },
              "extractedText": {
                "type": "string"
              },
              "warnings": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "analyzedAt": {
                "type": "string"
              }
            },
            "additionalProperties": false,
            "nullable": true,
            "description": "Audit metadata retained when the draft was prepared from a poster."
          },
          "draftStatus": {
            "type": "string",
            "enum": [
              "EDITING",
              "READY"
            ]
          },
          "validatedAt": {
            "type": "string",
            "nullable": true
          },
          "cursorStepId": {
            "type": "string"
          },
          "idempotencyKey": {
            "type": "string",
            "maxLength": 200
          },
          "expectedRevision": {
            "type": "integer",
            "minimum": 1
          },
          "timeZone": {
            "type": "string"
          }
        },
        "required": [
          "title",
          "destination",
          "mode",
          "idempotencyKey"
        ],
        "additionalProperties": false,
        "description": "Complete event recipe. The server normalises this object and materialises all requested resources. Amounts are in major currency units. An `upload` poster is a real image; pass either a hosted filename from `/uploads/image` or an http(s) URL that the server can re-host."
      },
      "AnnualEventCompatibleGroup": {
        "type": "object",
        "additionalProperties": false,
        "description": "An ordinary, single-session group that may receive a newly created event.",
        "properties": {
          "id": {
            "type": "string"
          },
          "label": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "image": {
            "type": "string",
            "nullable": true
          },
          "mode": {
            "type": "string",
            "enum": [
              "STANDALONE"
            ]
          }
        },
        "required": [
          "id",
          "label",
          "mode"
        ]
      },
      "AnnualEventPosterAnalysis": {
        "type": "object",
        "description": "A suggested event draft extracted from the poster. Every field remains reviewable before publishing.",
        "properties": {
          "analysis": {
            "type": "object",
            "properties": {
              "detectedLanguage": {
                "type": "string"
              },
              "confidence": {
                "type": "string",
                "enum": [
                  "high",
                  "medium",
                  "low"
                ]
              },
              "sourceSummary": {
                "type": "string"
              },
              "extractedText": {
                "type": "string"
              },
              "warnings": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            }
          },
          "event": {
            "type": "object",
            "description": "Raw evidence-based suggestion returned by the poster model. Prefer `draft`, which is already mapped to the canonical creation contract.",
            "additionalProperties": true
          },
          "poster": {
            "type": "object",
            "properties": {
              "source": {
                "type": "string"
              },
              "image": {
                "type": "string"
              }
            }
          },
          "draft": {
            "$ref": "#/components/schemas/AnnualEventDraft"
          }
        }
      },
      "UnisoftRequest_95690b6a2d37403c8838": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "nullable": true,
            "description": "Optional project UUID. Omit on create; keep it for updates."
          },
          "version": {
            "type": "integer",
            "minimum": 1,
            "default": 1
          },
          "templateId": {
            "type": "string",
            "description": "Suggested format id, or `custom`."
          },
          "destination": {
            "type": "object",
            "properties": {
              "kind": {
                "type": "string",
                "enum": [
                  "new",
                  "existing"
                ],
                "default": "new"
              },
              "groupId": {
                "type": "string",
                "nullable": true,
                "description": "Existing ordinary standalone group id."
              },
              "groupLabel": {
                "type": "string",
                "maxLength": 500
              },
              "confirmed": {
                "type": "boolean",
                "description": "Must be true: the caller confirms the destination decision."
              }
            },
            "required": [
              "kind",
              "confirmed"
            ],
            "additionalProperties": false,
            "description": "Where the event belongs. Use `existing` only after listing and explicitly selecting a compatible ordinary group; protected and multi-session groups are rejected."
          },
          "capabilities": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "title": {
            "type": "string",
            "minLength": 3,
            "maxLength": 500
          },
          "sourceLanguage": {
            "type": "string",
            "description": "Language of the supplied content; defaults to the organisation language. Multilingual organisations receive automatic content translations at creation."
          },
          "currency": {
            "not": {}
          },
          "tagline": {
            "type": "string",
            "maxLength": 2000
          },
          "description": {
            "type": "string",
            "maxLength": 20000
          },
          "mode": {
            "type": "string",
            "enum": [
              "registration",
              "fundraising",
              "both",
              "information"
            ]
          },
          "attendeeMode": {
            "type": "string",
            "enum": [
              "individual",
              "group",
              "family",
              "children"
            ]
          },
          "date": {
            "type": "string",
            "format": "date",
            "description": "Required except for a date-optional standalone fundraiser."
          },
          "dateOptional": {
            "type": "boolean"
          },
          "startTime": {
            "type": "string",
            "pattern": "^[0-2][0-9]:[0-5][0-9]$"
          },
          "endTime": {
            "type": "string",
            "pattern": "^[0-2][0-9]:[0-5][0-9]$"
          },
          "locationMode": {
            "type": "string",
            "enum": [
              "onsite",
              "online"
            ]
          },
          "locationName": {
            "type": "string",
            "maxLength": 500
          },
          "address": {
            "type": "string",
            "maxLength": 1000
          },
          "onlineUrl": {
            "type": "string",
            "format": "uri"
          },
          "cadence": {
            "type": "string",
            "enum": [
              "once",
              "weekly",
              "monthly",
              "custom"
            ]
          },
          "recurrenceCount": {
            "type": "integer",
            "minimum": 1,
            "maximum": 200
          },
          "customDates": {
            "type": "array",
            "maxItems": 200,
            "uniqueItems": true,
            "items": {
              "type": "string",
              "format": "date"
            },
            "description": "All session dates when cadence=custom. The first date and count are derived from this list."
          },
          "excludedDates": {
            "type": "array",
            "maxItems": 200,
            "items": {
              "type": "string",
              "format": "date"
            }
          },
          "slotDuration": {
            "type": "integer",
            "minimum": 0
          },
          "slotCapacity": {
            "type": "integer",
            "minimum": 0
          },
          "capacityEnabled": {
            "type": "boolean"
          },
          "capacity": {
            "type": "integer",
            "minimum": 0
          },
          "priceMode": {
            "type": "string",
            "enum": [
              "free",
              "fixed",
              "multiple",
              "freeAmount"
            ]
          },
          "price": {
            "type": "number",
            "minimum": 0
          },
          "prices": {
            "type": "object",
            "additionalProperties": {
              "type": "number",
              "minimum": 0
            },
            "description": "Optional prices keyed by enabled secondary currency (lowercase ISO code). Missing values keep the primary numeric price without conversion."
          },
          "tariffs": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string",
                  "maxLength": 100
                },
                "label": {
                  "type": "string",
                  "maxLength": 300
                },
                "price": {
                  "type": "number",
                  "minimum": 0
                },
                "prices": {
                  "type": "object",
                  "additionalProperties": {
                    "type": "number",
                    "minimum": 0
                  },
                  "description": "Optional prices keyed by enabled secondary currency (lowercase ISO code). Missing values keep the primary numeric price without conversion."
                },
                "stock": {
                  "type": "integer",
                  "minimum": 0,
                  "nullable": true
                }
              },
              "required": [
                "label",
                "price"
              ],
              "additionalProperties": false
            }
          },
          "target": {
            "type": "number",
            "minimum": 0
          },
          "partialPayments": {
            "type": "boolean"
          },
          "depositAmount": {
            "type": "number",
            "minimum": 0
          },
          "contributionAmounts": {
            "type": "array",
            "maxItems": 20,
            "items": {
              "type": "number",
              "minimum": 0
            }
          },
          "fields": {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "firstName",
                "lastName",
                "email",
                "phone",
                "address",
                "birthDate"
              ]
            }
          },
          "children": {
            "type": "boolean"
          },
          "questions": {
            "type": "array",
            "maxItems": 100,
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string",
                  "maxLength": 100
                },
                "label": {
                  "type": "string",
                  "maxLength": 500
                },
                "type": {
                  "type": "string",
                  "enum": [
                    "shortText",
                    "longText",
                    "yesNo",
                    "choice",
                    "document"
                  ]
                },
                "required": {
                  "type": "boolean"
                },
                "options": {
                  "type": "array",
                  "maxItems": 50,
                  "items": {
                    "type": "string",
                    "maxLength": 300
                  }
                },
                "condition": {
                  "type": "object",
                  "properties": {
                    "questionId": {
                      "type": "string"
                    },
                    "value": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "questionId",
                    "value"
                  ],
                  "additionalProperties": false,
                  "nullable": true
                }
              },
              "required": [
                "label",
                "type"
              ],
              "additionalProperties": false
            }
          },
          "requirementsEnabled": {
            "type": "boolean"
          },
          "requirements": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "label": {
                  "type": "string",
                  "maxLength": 500
                },
                "required": {
                  "type": "boolean"
                }
              },
              "required": [
                "label"
              ],
              "additionalProperties": false
            }
          },
          "manualValidation": {
            "type": "boolean"
          },
          "confirmationText": {
            "type": "string",
            "maxLength": 5000
          },
          "reminders": {
            "type": "object",
            "properties": {
              "confirmation": {
                "type": "boolean"
              },
              "weekBefore": {
                "type": "boolean"
              },
              "dayBefore": {
                "type": "boolean"
              }
            },
            "additionalProperties": false
          },
          "page": {
            "type": "object",
            "properties": {
              "layout": {
                "type": "string",
                "enum": [
                  "essential",
                  "story",
                  "campaign"
                ]
              },
              "ctaLabel": {
                "type": "string",
                "maxLength": 300
              },
              "showDescription": {
                "type": "boolean"
              },
              "showPracticalInfo": {
                "type": "boolean"
              },
              "showOrganizer": {
                "type": "boolean"
              },
              "showProgress": {
                "type": "boolean"
              },
              "customContent": {
                "type": "object",
                "properties": {
                  "kind": {
                    "type": "string",
                    "enum": [
                      "faq",
                      "pricing",
                      "programme",
                      "speakers",
                      "free"
                    ]
                  },
                  "aiContentBlockId": {
                    "type": "string",
                    "nullable": true,
                    "description": "Existing AI content-block id. Manage its HTML through `/content-blocks`."
                  }
                },
                "additionalProperties": false
              }
            },
            "additionalProperties": false
          },
          "poster": {
            "type": "object",
            "properties": {
              "source": {
                "type": "string",
                "enum": [
                  "none",
                  "upload"
                ]
              },
              "image": {
                "type": "string",
                "nullable": true,
                "description": "Hosted filename or http(s) image URL."
              },
              "tone": {
                "type": "string",
                "enum": [
                  "auto",
                  "blue",
                  "cyan",
                  "violet",
                  "green",
                  "amber",
                  "rose",
                  "red"
                ],
                "description": "auto follows the public site's theme; explicit colors stay fixed."
              },
              "badge": {
                "type": "string",
                "maxLength": 300
              }
            },
            "additionalProperties": false,
            "description": "A poster exists only when `source=upload` and `image` references a real image."
          },
          "campaignEnabled": {
            "type": "boolean",
            "description": "When true, create or update a campaign DRAFT; it is never sent automatically."
          },
          "campaign": {
            "type": "object",
            "properties": {
              "channels": {
                "type": "array",
                "minItems": 1,
                "maxItems": 3,
                "items": {
                  "type": "string",
                  "enum": [
                    "email",
                    "whatsapp",
                    "sms"
                  ]
                }
              },
              "audience": {
                "type": "string",
                "enum": [
                  "all",
                  "families",
                  "participants",
                  "custom"
                ],
                "description": "`families`, `participants` and `custom` keep the draft without automatic targeting until the organiser chooses the exact audience."
              },
              "includePoster": {
                "type": "boolean",
                "description": "The image is attached only when a real uploaded poster exists."
              },
              "message": {
                "type": "string",
                "maxLength": 10000
              },
              "schedule": {
                "type": "string",
                "enum": [
                  "now",
                  "later"
                ]
              },
              "scheduledAt": {
                "type": "string",
                "nullable": true,
                "description": "ISO date-time used when the campaign is eventually sent."
              }
            },
            "additionalProperties": false
          },
          "posterAnalysis": {
            "type": "object",
            "properties": {
              "confidence": {
                "type": "string",
                "enum": [
                  "high",
                  "medium",
                  "low"
                ]
              },
              "detectedLanguage": {
                "type": "string"
              },
              "sourceSummary": {
                "type": "string"
              },
              "extractedText": {
                "type": "string"
              },
              "warnings": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "analyzedAt": {
                "type": "string"
              }
            },
            "additionalProperties": false,
            "nullable": true,
            "description": "Audit metadata retained when the draft was prepared from a poster."
          },
          "draftStatus": {
            "type": "string",
            "enum": [
              "EDITING",
              "READY"
            ]
          },
          "validatedAt": {
            "type": "string",
            "nullable": true
          },
          "cursorStepId": {
            "type": "string"
          }
        },
        "additionalProperties": false,
        "description": "Complete event recipe. The server normalises this object and materialises all requested resources. Amounts are in major currency units. An `upload` poster is a real image; pass either a hosted filename from `/uploads/image` or an http(s) URL that the server can re-host."
      },
      "UnisoftRequest_0667b8aac019eb4d0f07": {
        "oneOf": [
          {
            "type": "object",
            "properties": {
              "action": {
                "type": "string",
                "enum": [
                  "ADD_DATES"
                ]
              },
              "dates": {
                "type": "array",
                "minItems": 1,
                "maxItems": 200,
                "uniqueItems": true,
                "items": {
                  "type": "string",
                  "format": "date"
                }
              }
            },
            "required": [
              "action",
              "dates"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "action": {
                "type": "string",
                "enum": [
                  "REMOVE_SESSIONS"
                ]
              },
              "selection": {
                "oneOf": [
                  {
                    "type": "object",
                    "properties": {
                      "kind": {
                        "type": "string",
                        "enum": [
                          "EXPLICIT"
                        ]
                      },
                      "sessionIds": {
                        "type": "array",
                        "minItems": 1,
                        "maxItems": 200,
                        "uniqueItems": true,
                        "items": {
                          "type": "string",
                          "pattern": "^[A-Za-z0-9_-]{3,128}$"
                        }
                      }
                    },
                    "required": [
                      "kind",
                      "sessionIds"
                    ],
                    "additionalProperties": false
                  },
                  {
                    "type": "object",
                    "properties": {
                      "kind": {
                        "type": "string",
                        "enum": [
                          "FROM_SESSION"
                        ]
                      },
                      "sessionId": {
                        "type": "string",
                        "pattern": "^[A-Za-z0-9_-]{3,128}$"
                      }
                    },
                    "required": [
                      "kind",
                      "sessionId"
                    ],
                    "additionalProperties": false
                  }
                ]
              }
            },
            "required": [
              "action",
              "selection"
            ],
            "additionalProperties": false
          },
          {
            "$ref": "#/components/schemas/UnisoftRequest_9724e4bec01b841b6283"
          }
        ]
      },
      "UnisoftRequest_9724e4bec01b841b6283": {
        "type": "object",
        "properties": {
          "action": {
            "type": "string",
            "enum": [
              "SET_RECURRENCE"
            ]
          },
          "selection": {
            "oneOf": [
              {
                "type": "object",
                "properties": {
                  "kind": {
                    "type": "string",
                    "enum": [
                      "ALL"
                    ]
                  }
                },
                "required": [
                  "kind"
                ],
                "additionalProperties": false
              },
              {
                "type": "object",
                "properties": {
                  "kind": {
                    "type": "string",
                    "enum": [
                      "FROM_SESSION"
                    ]
                  },
                  "sessionId": {
                    "type": "string",
                    "pattern": "^[A-Za-z0-9_-]{3,128}$"
                  }
                },
                "required": [
                  "kind",
                  "sessionId"
                ],
                "additionalProperties": false
              }
            ]
          },
          "schedule": {
            "oneOf": [
              {
                "type": "object",
                "properties": {
                  "cadence": {
                    "type": "string",
                    "enum": [
                      "once"
                    ]
                  },
                  "date": {
                    "type": "string",
                    "format": "date"
                  }
                },
                "required": [
                  "cadence",
                  "date"
                ],
                "additionalProperties": false
              },
              {
                "type": "object",
                "properties": {
                  "cadence": {
                    "type": "string",
                    "enum": [
                      "weekly",
                      "monthly"
                    ]
                  },
                  "date": {
                    "type": "string",
                    "format": "date"
                  },
                  "recurrenceCount": {
                    "type": "integer",
                    "minimum": 2,
                    "maximum": 200
                  },
                  "excludedDates": {
                    "type": "array",
                    "minItems": 0,
                    "maxItems": 200,
                    "uniqueItems": true,
                    "items": {
                      "type": "string",
                      "format": "date"
                    }
                  }
                },
                "required": [
                  "cadence",
                  "date",
                  "recurrenceCount"
                ],
                "additionalProperties": false
              },
              {
                "type": "object",
                "properties": {
                  "cadence": {
                    "type": "string",
                    "enum": [
                      "custom"
                    ]
                  },
                  "customDates": {
                    "type": "array",
                    "minItems": 2,
                    "maxItems": 200,
                    "uniqueItems": true,
                    "items": {
                      "type": "string",
                      "format": "date"
                    }
                  }
                },
                "required": [
                  "cadence",
                  "customDates"
                ],
                "additionalProperties": false
              }
            ]
          }
        },
        "required": [
          "action",
          "selection",
          "schedule"
        ],
        "additionalProperties": false
      },
      "EventSeriesPlan": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "projectId",
          "expectedRevision",
          "planHash",
          "effectiveTimeZone",
          "currency",
          "publicBaseUrl",
          "requiredReadScopes",
          "requiredWriteScopes",
          "currentSessions",
          "nextSessions",
          "retiredSessionIds",
          "addedLogicalKeys",
          "selectedSessionIds",
          "finalCadence",
          "publicTargetMayChange",
          "expectedPublicTargetId",
          "refreshScope",
          "manualOverridePreservation",
          "historyImpact",
          "campaignDelivery"
        ],
        "properties": {
          "projectId": {
            "type": "string",
            "pattern": "^[A-Za-z0-9_-]{3,128}$"
          },
          "expectedRevision": {
            "type": "integer",
            "minimum": 1
          },
          "planHash": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "effectiveTimeZone": {
            "type": "string"
          },
          "currency": {
            "type": "string",
            "pattern": "^[a-z]{3}$"
          },
          "publicBaseUrl": {
            "type": "string",
            "format": "uri"
          },
          "requiredReadScopes": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "requiredWriteScopes": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "currentSessions": {
            "type": "array",
            "maxItems": 200,
            "items": {
              "type": "object",
              "additionalProperties": false,
              "required": [
                "sessionId",
                "logicalKey",
                "startAt",
                "endAt",
                "active"
              ],
              "properties": {
                "sessionId": {
                  "type": "string",
                  "pattern": "^[A-Za-z0-9_-]{3,128}$",
                  "nullable": true
                },
                "logicalKey": {
                  "type": "string"
                },
                "startAt": {
                  "type": "string",
                  "format": "date-time"
                },
                "endAt": {
                  "type": "string",
                  "format": "date-time"
                },
                "active": {
                  "type": "boolean"
                }
              }
            }
          },
          "nextSessions": {
            "type": "array",
            "minItems": 1,
            "maxItems": 200,
            "items": {
              "type": "object",
              "additionalProperties": false,
              "required": [
                "sessionId",
                "logicalKey",
                "startAt",
                "endAt",
                "active"
              ],
              "properties": {
                "sessionId": {
                  "type": "string",
                  "pattern": "^[A-Za-z0-9_-]{3,128}$",
                  "nullable": true
                },
                "logicalKey": {
                  "type": "string"
                },
                "startAt": {
                  "type": "string",
                  "format": "date-time"
                },
                "endAt": {
                  "type": "string",
                  "format": "date-time"
                },
                "active": {
                  "type": "boolean"
                }
              }
            }
          },
          "retiredSessionIds": {
            "type": "array",
            "maxItems": 200,
            "items": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{3,128}$"
            },
            "uniqueItems": true
          },
          "addedLogicalKeys": {
            "type": "array",
            "maxItems": 200,
            "items": {
              "type": "string"
            }
          },
          "selectedSessionIds": {
            "type": "array",
            "maxItems": 200,
            "items": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{3,128}$"
            },
            "uniqueItems": true
          },
          "finalCadence": {
            "type": "string",
            "enum": [
              "once",
              "weekly",
              "monthly",
              "custom"
            ]
          },
          "publicTargetMayChange": {
            "type": "boolean"
          },
          "expectedPublicTargetId": {
            "type": "string",
            "pattern": "^[A-Za-z0-9_-]{3,128}$",
            "nullable": true
          },
          "refreshScope": {
            "type": "string",
            "enum": [
              "ALL_REMAINING_MANAGED_RESOURCES"
            ]
          },
          "manualOverridePreservation": {
            "type": "string",
            "enum": [
              "NOT_GUARANTEED"
            ]
          },
          "historyImpact": {
            "type": "string",
            "enum": [
              "RETIRED_PE_FORMS_FUNDS_INACTIVE_OTHER_ROWS_RETAINED"
            ]
          },
          "campaignDelivery": {
            "type": "string",
            "enum": [
              "NOT_SENT"
            ]
          }
        }
      },
      "EventSeriesCommandResult": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "data"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "eventId",
              "projectId",
              "publicationStatus",
              "revision",
              "publishedAt",
              "publicUrl",
              "resources",
              "operationalState"
            ],
            "properties": {
              "eventId": {
                "type": "string",
                "pattern": "^[A-Za-z0-9_-]{3,128}$"
              },
              "projectId": {
                "type": "string",
                "pattern": "^[A-Za-z0-9_-]{3,128}$"
              },
              "publicationStatus": {
                "type": "string",
                "enum": [
                  "PUBLISHED",
                  "CREATED"
                ]
              },
              "revision": {
                "type": "integer",
                "minimum": 1
              },
              "publishedAt": {
                "type": "string",
                "format": "date-time",
                "nullable": true
              },
              "publicUrl": {
                "type": "string",
                "format": "uri",
                "nullable": true
              },
              "resources": {
                "type": "object",
                "additionalProperties": false,
                "required": [
                  "groupId",
                  "sessionIds",
                  "formIds",
                  "fundraiserIds",
                  "campaignIds"
                ],
                "properties": {
                  "groupId": {
                    "type": "string",
                    "pattern": "^[A-Za-z0-9_-]{3,128}$",
                    "nullable": true
                  },
                  "sessionIds": {
                    "type": "array",
                    "maxItems": 200,
                    "items": {
                      "type": "string",
                      "pattern": "^[A-Za-z0-9_-]{3,128}$"
                    }
                  },
                  "formIds": {
                    "type": "array",
                    "maxItems": 200,
                    "items": {
                      "type": "string",
                      "pattern": "^[A-Za-z0-9_-]{3,128}$"
                    }
                  },
                  "fundraiserIds": {
                    "type": "array",
                    "maxItems": 200,
                    "items": {
                      "type": "string",
                      "pattern": "^[A-Za-z0-9_-]{3,128}$"
                    }
                  },
                  "campaignIds": {
                    "type": "array",
                    "maxItems": 200,
                    "items": {
                      "type": "string",
                      "pattern": "^[A-Za-z0-9_-]{3,128}$"
                    }
                  }
                }
              },
              "operationalState": {
                "type": "object",
                "additionalProperties": false,
                "required": [
                  "registration"
                ],
                "properties": {
                  "registration": {
                    "type": "object",
                    "additionalProperties": false,
                    "required": [
                      "configured",
                      "open",
                      "submissionCount"
                    ],
                    "properties": {
                      "configured": {
                        "type": "boolean"
                      },
                      "open": {
                        "type": "boolean"
                      },
                      "submissionCount": {
                        "type": "integer",
                        "minimum": 0
                      }
                    }
                  }
                }
              }
            }
          }
        }
      },
      "EventPublicLinksResult": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "data"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "projectId",
              "projectRevision",
              "publicationStatus",
              "observedAt",
              "site",
              "page",
              "links",
              "publicRenderingVerified",
              "stockChecked",
              "paymentReadiness"
            ],
            "properties": {
              "projectId": {
                "type": "string",
                "pattern": "^[A-Za-z0-9_-]{3,128}$"
              },
              "projectRevision": {
                "type": "integer",
                "minimum": 1
              },
              "publicationStatus": {
                "type": "string",
                "enum": [
                  "PUBLISHED",
                  "CREATED"
                ]
              },
              "observedAt": {
                "type": "string",
                "format": "date-time"
              },
              "site": {
                "type": "object",
                "additionalProperties": false,
                "required": [
                  "virtualId",
                  "language",
                  "publicBaseUrl"
                ],
                "properties": {
                  "virtualId": {
                    "type": "string",
                    "format": "uuid",
                    "nullable": true
                  },
                  "language": {
                    "type": "string",
                    "enum": [
                      "fr",
                      "en",
                      "he",
                      "it",
                      "ru",
                      "pt",
                      "de",
                      "es",
                      "gr",
                      "ro"
                    ]
                  },
                  "publicBaseUrl": {
                    "type": "string",
                    "format": "uri",
                    "maxLength": 2500
                  }
                }
              },
              "page": {
                "type": "object",
                "additionalProperties": false,
                "required": [
                  "targetId",
                  "publicWindow",
                  "url",
                  "embed"
                ],
                "properties": {
                  "targetId": {
                    "type": "string",
                    "pattern": "^[A-Za-z0-9_-]{3,128}$",
                    "nullable": true
                  },
                  "publicWindow": {
                    "type": "string",
                    "enum": [
                      "OBSERVED_OPEN",
                      "WITHHELD"
                    ]
                  },
                  "url": {
                    "type": "string",
                    "format": "uri",
                    "maxLength": 2500,
                    "nullable": true
                  },
                  "embed": {
                    "type": "object",
                    "additionalProperties": false,
                    "required": [
                      "url",
                      "integration",
                      "html",
                      "autoResize",
                      "hostBridgeIncluded"
                    ],
                    "properties": {
                      "url": {
                        "type": "string",
                        "format": "uri",
                        "maxLength": 2500
                      },
                      "integration": {
                        "type": "string",
                        "enum": [
                          "NATIVE_IFRAME"
                        ]
                      },
                      "html": {
                        "type": "string",
                        "maxLength": 4096
                      },
                      "autoResize": {
                        "type": "boolean",
                        "enum": [
                          false
                        ]
                      },
                      "hostBridgeIncluded": {
                        "type": "boolean",
                        "enum": [
                          false
                        ]
                      }
                    },
                    "nullable": true
                  }
                }
              },
              "links": {
                "type": "array",
                "maxItems": 400,
                "items": {
                  "$ref": "#/components/schemas/EventPublicLink"
                }
              },
              "publicRenderingVerified": {
                "type": "boolean",
                "enum": [
                  false
                ]
              },
              "stockChecked": {
                "type": "boolean",
                "enum": [
                  false
                ]
              },
              "paymentReadiness": {
                "type": "string",
                "enum": [
                  "NOT_EVALUATED"
                ]
              }
            }
          }
        }
      },
      "EventPublicLink": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "kind",
          "targetId",
          "sessionId",
          "publicWindow",
          "url",
          "embed"
        ],
        "properties": {
          "kind": {
            "type": "string",
            "enum": [
              "REGISTRATION",
              "FUNDRAISER"
            ]
          },
          "targetId": {
            "type": "string",
            "pattern": "^[A-Za-z0-9_-]{3,128}$"
          },
          "sessionId": {
            "type": "string",
            "pattern": "^[A-Za-z0-9_-]{3,128}$",
            "nullable": true
          },
          "publicWindow": {
            "type": "string",
            "enum": [
              "OBSERVED_OPEN",
              "WITHHELD"
            ]
          },
          "url": {
            "type": "string",
            "format": "uri",
            "maxLength": 2500,
            "nullable": true
          },
          "embed": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "url",
              "integration",
              "html",
              "autoResize",
              "hostBridgeIncluded"
            ],
            "properties": {
              "url": {
                "type": "string",
                "format": "uri",
                "maxLength": 2500
              },
              "integration": {
                "type": "string",
                "enum": [
                  "NATIVE_IFRAME"
                ]
              },
              "html": {
                "type": "string",
                "maxLength": 4096
              },
              "autoResize": {
                "type": "boolean",
                "enum": [
                  false
                ]
              },
              "hostBridgeIncluded": {
                "type": "boolean",
                "enum": [
                  false
                ]
              }
            },
            "nullable": true
          }
        }
      },
      "EventLifecycleHistoryResult": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "data",
          "nextCursor",
          "coverage"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "type": "array",
            "maxItems": 100,
            "items": {
              "$ref": "#/components/schemas/EventLifecycleHistoryEntry"
            }
          },
          "nextCursor": {
            "type": "string",
            "nullable": true
          },
          "coverage": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "source",
              "nativeTransitions",
              "privateDraftCreation",
              "currentResource",
              "complete"
            ],
            "properties": {
              "source": {
                "type": "string",
                "enum": [
                  "EXTERNAL_EVENT_COMMAND_JOURNAL"
                ]
              },
              "nativeTransitions": {
                "type": "string",
                "enum": [
                  "NOT_CAPTURED"
                ]
              },
              "privateDraftCreation": {
                "type": "string",
                "enum": [
                  "NOT_A_COMMAND_IN_THIS_JOURNAL"
                ]
              },
              "currentResource": {
                "type": "string",
                "enum": [
                  "NOT_EVALUATED"
                ]
              },
              "complete": {
                "type": "boolean",
                "enum": [
                  false
                ]
              }
            }
          }
        }
      },
      "EventLifecycleHistoryEntry": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "commandId",
          "operation",
          "state",
          "createdAt",
          "finishedAt",
          "projectId",
          "draftId",
          "sourceProjectId",
          "sessionId",
          "sourceRevision",
          "recipeRevision",
          "nativeRevision",
          "recordedOutcome"
        ],
        "properties": {
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "operation": {
            "type": "string",
            "enum": [
              "PUBLISH",
              "REPLACE_RECIPE",
              "DUPLICATE_DRAFT",
              "RESCHEDULE",
              "UNPUBLISH",
              "LEGACY_POST",
              "LEGACY_PATCH",
              "SERIES_UPDATE"
            ]
          },
          "state": {
            "type": "string",
            "enum": [
              "RUNNING",
              "SUCCEEDED",
              "REFUSED",
              "UNCERTAIN"
            ]
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          },
          "finishedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "projectId": {
            "type": "string",
            "nullable": true
          },
          "draftId": {
            "type": "string",
            "nullable": true
          },
          "sourceProjectId": {
            "type": "string",
            "nullable": true
          },
          "sessionId": {
            "type": "string",
            "nullable": true
          },
          "sourceRevision": {
            "type": "integer",
            "minimum": 1,
            "nullable": true
          },
          "recipeRevision": {
            "type": "integer",
            "minimum": 1,
            "nullable": true
          },
          "nativeRevision": {
            "type": "integer",
            "minimum": 1,
            "nullable": true
          },
          "recordedOutcome": {
            "type": "string",
            "enum": [
              "PUBLISHED",
              "CREATED",
              "UNPUBLISHED",
              null
            ],
            "nullable": true
          }
        }
      },
      "UnisoftRequest_b6493128eea60f41ebb4": {
        "type": "object",
        "properties": {
          "templateId": {
            "type": "string",
            "maxLength": 100,
            "description": "Suggested format id, or `custom`."
          },
          "destination": {
            "type": "object",
            "properties": {
              "kind": {
                "type": "string",
                "enum": [
                  "new",
                  "existing"
                ],
                "default": "new"
              },
              "groupId": {
                "type": "string",
                "nullable": true,
                "description": "Existing ordinary standalone group id."
              },
              "groupLabel": {
                "type": "string",
                "maxLength": 500
              },
              "confirmed": {
                "type": "boolean",
                "description": "Must be true: the caller confirms the destination decision."
              }
            },
            "required": [
              "kind",
              "confirmed"
            ],
            "additionalProperties": false,
            "description": "Where the event belongs. Use `existing` only after listing and explicitly selecting a compatible ordinary group; protected and multi-session groups are rejected."
          },
          "title": {
            "type": "string",
            "minLength": 3,
            "maxLength": 500
          },
          "sourceLanguage": {
            "type": "string",
            "maxLength": 10,
            "description": "Language of the supplied content; defaults to the organisation language. Multilingual organisations receive automatic content translations at creation."
          },
          "tagline": {
            "type": "string",
            "maxLength": 2000
          },
          "description": {
            "type": "string",
            "maxLength": 20000
          },
          "mode": {
            "type": "string",
            "enum": [
              "registration",
              "fundraising",
              "both",
              "information"
            ]
          },
          "attendeeMode": {
            "type": "string",
            "enum": [
              "individual",
              "group",
              "family",
              "children"
            ]
          },
          "date": {
            "type": "string",
            "format": "date",
            "description": "Required except for a date-optional standalone fundraiser."
          },
          "dateOptional": {
            "type": "boolean"
          },
          "startTime": {
            "type": "string",
            "pattern": "^(?:[01][0-9]|2[0-3]):[0-5][0-9]$"
          },
          "endTime": {
            "type": "string",
            "pattern": "^(?:[01][0-9]|2[0-3]):[0-5][0-9]$"
          },
          "locationMode": {
            "type": "string",
            "enum": [
              "onsite",
              "online"
            ]
          },
          "locationName": {
            "type": "string",
            "maxLength": 500
          },
          "address": {
            "type": "string",
            "maxLength": 1000
          },
          "onlineUrl": {
            "type": "string",
            "maxLength": 2000,
            "format": "uri"
          },
          "cadence": {
            "type": "string",
            "enum": [
              "once",
              "weekly",
              "monthly",
              "custom"
            ]
          },
          "recurrenceCount": {
            "type": "integer",
            "minimum": 1,
            "maximum": 200
          },
          "customDates": {
            "type": "array",
            "maxItems": 200,
            "uniqueItems": true,
            "items": {
              "type": "string",
              "format": "date"
            },
            "description": "All session dates when cadence=custom. The first date and count are derived from this list."
          },
          "excludedDates": {
            "type": "array",
            "maxItems": 200,
            "items": {
              "type": "string",
              "format": "date"
            }
          },
          "slotDuration": {
            "type": "integer",
            "minimum": 0
          },
          "slotCapacity": {
            "type": "integer",
            "minimum": 0
          },
          "capacityEnabled": {
            "type": "boolean"
          },
          "capacity": {
            "type": "integer",
            "minimum": 0
          },
          "priceMode": {
            "type": "string",
            "enum": [
              "free",
              "fixed",
              "multiple",
              "freeAmount"
            ]
          },
          "price": {
            "type": "number",
            "minimum": 0,
            "maximum": 90071992547409,
            "multipleOf": 0.01
          },
          "prices": {
            "type": "object",
            "maxProperties": 30,
            "additionalProperties": {
              "type": "number",
              "minimum": 0,
              "maximum": 90071992547409,
              "multipleOf": 0.01
            },
            "description": "Prices in major currency units, keyed only by lower-case three-letter currency code, with at most 30 entries. No arbitrary metadata field is accepted."
          },
          "tariffs": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string",
                  "maxLength": 100
                },
                "label": {
                  "type": "string",
                  "maxLength": 300
                },
                "price": {
                  "type": "number",
                  "minimum": 0,
                  "maximum": 90071992547409,
                  "multipleOf": 0.01
                },
                "prices": {
                  "type": "object",
                  "maxProperties": 30,
                  "additionalProperties": {
                    "type": "number",
                    "minimum": 0,
                    "maximum": 90071992547409,
                    "multipleOf": 0.01
                  },
                  "description": "Prices in major currency units, keyed only by lower-case three-letter currency code, with at most 30 entries. No arbitrary metadata field is accepted."
                },
                "stock": {
                  "type": "integer",
                  "minimum": 0,
                  "nullable": true
                }
              },
              "required": [
                "label",
                "price"
              ],
              "additionalProperties": false
            }
          },
          "target": {
            "type": "number",
            "minimum": 0,
            "maximum": 90071992547409,
            "multipleOf": 0.01
          },
          "partialPayments": {
            "type": "boolean"
          },
          "depositAmount": {
            "type": "number",
            "minimum": 0,
            "maximum": 90071992547409,
            "multipleOf": 0.01
          },
          "contributionAmounts": {
            "type": "array",
            "maxItems": 20,
            "items": {
              "type": "number",
              "minimum": 0.01,
              "maximum": 90071992547409,
              "multipleOf": 0.01
            }
          },
          "fields": {
            "type": "array",
            "maxItems": 100,
            "items": {
              "type": "string",
              "enum": [
                "firstName",
                "lastName",
                "email",
                "phone",
                "address",
                "birthDate"
              ]
            }
          },
          "children": {
            "type": "boolean"
          },
          "questions": {
            "type": "array",
            "maxItems": 100,
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string",
                  "maxLength": 100
                },
                "label": {
                  "type": "string",
                  "maxLength": 500
                },
                "type": {
                  "type": "string",
                  "enum": [
                    "shortText",
                    "longText",
                    "yesNo",
                    "choice",
                    "document"
                  ]
                },
                "required": {
                  "type": "boolean"
                },
                "options": {
                  "type": "array",
                  "maxItems": 50,
                  "items": {
                    "type": "string",
                    "maxLength": 300
                  }
                },
                "condition": {
                  "type": "object",
                  "properties": {
                    "questionId": {
                      "type": "string",
                      "maxLength": 100
                    },
                    "value": {
                      "type": "string",
                      "maxLength": 300
                    }
                  },
                  "required": [
                    "questionId",
                    "value"
                  ],
                  "additionalProperties": false,
                  "nullable": true
                }
              },
              "required": [
                "label",
                "type"
              ],
              "additionalProperties": false
            }
          },
          "requirementsEnabled": {
            "type": "boolean"
          },
          "requirements": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string",
                  "maxLength": 100
                },
                "label": {
                  "type": "string",
                  "maxLength": 500
                },
                "required": {
                  "type": "boolean"
                }
              },
              "required": [
                "label"
              ],
              "additionalProperties": false
            }
          },
          "manualValidation": {
            "type": "boolean"
          },
          "confirmationText": {
            "type": "string",
            "maxLength": 5000
          },
          "reminders": {
            "type": "object",
            "properties": {
              "confirmation": {
                "type": "boolean"
              },
              "weekBefore": {
                "type": "boolean"
              },
              "dayBefore": {
                "type": "boolean"
              }
            },
            "additionalProperties": false
          },
          "page": {
            "type": "object",
            "properties": {
              "layout": {
                "type": "string",
                "enum": [
                  "essential",
                  "story",
                  "campaign"
                ]
              },
              "ctaLabel": {
                "type": "string",
                "maxLength": 300
              },
              "showDescription": {
                "type": "boolean"
              },
              "showPracticalInfo": {
                "type": "boolean"
              },
              "showOrganizer": {
                "type": "boolean"
              },
              "showProgress": {
                "type": "boolean"
              },
              "customContent": {
                "type": "object",
                "properties": {
                  "kind": {
                    "type": "string",
                    "enum": [
                      "faq",
                      "pricing",
                      "programme",
                      "speakers",
                      "free"
                    ]
                  },
                  "aiContentBlockId": {
                    "type": "string",
                    "nullable": true,
                    "description": "Existing AI content-block id. Manage its HTML through `/content-blocks`."
                  }
                },
                "additionalProperties": false
              }
            },
            "additionalProperties": false
          },
          "poster": {
            "type": "object",
            "properties": {
              "source": {
                "type": "string",
                "enum": [
                  "none",
                  "upload"
                ]
              },
              "image": {
                "type": "string",
                "maxLength": 200,
                "nullable": true,
                "description": "Existing hosted JPEG, PNG or WebP filename owned by the organisation. Remote URLs, paths and SVG are refused; saving a draft never downloads a poster."
              },
              "tone": {
                "type": "string",
                "enum": [
                  "auto",
                  "blue",
                  "cyan",
                  "violet",
                  "green",
                  "amber",
                  "rose",
                  "red"
                ],
                "description": "auto follows the public site's theme; explicit colors stay fixed."
              },
              "badge": {
                "type": "string",
                "maxLength": 300
              }
            },
            "additionalProperties": false,
            "description": "A poster exists only when `source=upload` and `image` references a real image."
          },
          "campaignEnabled": {
            "type": "boolean",
            "description": "When true, create or update a campaign DRAFT; it is never sent automatically."
          },
          "campaign": {
            "type": "object",
            "properties": {
              "channels": {
                "type": "array",
                "minItems": 1,
                "maxItems": 3,
                "items": {
                  "type": "string",
                  "enum": [
                    "email",
                    "whatsapp",
                    "sms"
                  ]
                }
              },
              "audience": {
                "type": "string",
                "enum": [
                  "all",
                  "families",
                  "participants",
                  "custom"
                ],
                "description": "`families`, `participants` and `custom` keep the draft without automatic targeting until the organiser chooses the exact audience."
              },
              "includePoster": {
                "type": "boolean",
                "description": "The image is attached only when a real uploaded poster exists."
              },
              "message": {
                "type": "string",
                "maxLength": 10000
              },
              "schedule": {
                "type": "string",
                "enum": [
                  "now",
                  "later"
                ]
              },
              "scheduledAt": {
                "type": "string",
                "maxLength": 100,
                "nullable": true,
                "description": "ISO date-time used when the campaign is eventually sent."
              }
            },
            "additionalProperties": false
          }
        },
        "required": [
          "title",
          "destination",
          "mode"
        ],
        "additionalProperties": false,
        "description": "Canonical ordinary-event recipe stored privately by this API. Missing optional values remain absent. This is not a public event and not an admin browser-local draft. Prices, targets, deposits and contribution amounts are in major currency units, not minor units; this operation performs no collection or currency conversion."
      },
      "EventLifecycleResult": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "data"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "replayed": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/EventLifecycleDraft"
          }
        }
      },
      "EventLifecycleDraft": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "id",
          "kind",
          "state",
          "revision",
          "recipe",
          "requestedTimeZone",
          "validation",
          "createdAt",
          "updatedAt",
          "publication",
          "publicationCommandId"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "kind": {
            "type": "string",
            "enum": [
              "ORDINARY_EVENT_DRAFT"
            ]
          },
          "state": {
            "type": "string",
            "enum": [
              "DRAFT",
              "PUBLISHING",
              "PUBLISHED",
              "MATERIALIZED",
              "PUBLICATION_UNCERTAIN"
            ]
          },
          "revision": {
            "type": "integer",
            "minimum": 1
          },
          "recipe": {
            "$ref": "#/components/schemas/EventLifecycleRecipe"
          },
          "requestedTimeZone": {
            "type": "string",
            "nullable": true
          },
          "validation": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "scope",
              "status",
              "issues"
            ],
            "properties": {
              "scope": {
                "type": "string",
                "enum": [
                  "RECIPE_ONLY"
                ]
              },
              "status": {
                "type": "string",
                "enum": [
                  "VALID",
                  "INCOMPLETE"
                ]
              },
              "issues": {
                "type": "array",
                "maxItems": 1,
                "items": {
                  "type": "string"
                }
              }
            }
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time"
          },
          "publication": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "draftId",
              "projectId",
              "commandId",
              "draftRevision",
              "projectRevision",
              "publicationStatus",
              "effectiveTimeZone",
              "currency",
              "publicUrl",
              "publishedAt"
            ],
            "properties": {
              "draftId": {
                "type": "string",
                "format": "uuid"
              },
              "projectId": {
                "type": "string",
                "format": "uuid"
              },
              "commandId": {
                "type": "string",
                "format": "uuid"
              },
              "draftRevision": {
                "type": "integer",
                "minimum": 2
              },
              "projectRevision": {
                "type": "integer",
                "minimum": 1
              },
              "publicationStatus": {
                "type": "string",
                "enum": [
                  "PUBLISHED",
                  "CREATED"
                ]
              },
              "effectiveTimeZone": {
                "type": "string"
              },
              "currency": {
                "type": "string",
                "pattern": "^[a-z]{3}$"
              },
              "publicUrl": {
                "type": "string",
                "nullable": true
              },
              "publishedAt": {
                "type": "string",
                "format": "date-time",
                "nullable": true
              }
            },
            "nullable": true
          },
          "publicationCommandId": {
            "type": "string",
            "format": "uuid",
            "nullable": true,
            "description": "Opaque external publication-command correlation id. It is not a provider credential or an access token."
          }
        }
      },
      "EventLifecycleRecipe": {
        "type": "object",
        "additionalProperties": false,
        "description": "Canonical ordinary-event recipe stored privately by this API. Missing optional values remain absent. This is not a public event and not an admin browser-local draft. Prices, targets, deposits and contribution amounts are in major currency units, not minor units; this operation performs no collection or currency conversion.",
        "properties": {
          "templateId": {
            "type": "string",
            "description": "Suggested format id, or `custom`.",
            "maxLength": 100
          },
          "destination": {
            "$ref": "#/components/schemas/EventLifecycleDestination"
          },
          "title": {
            "type": "string",
            "minLength": 3,
            "maxLength": 500
          },
          "sourceLanguage": {
            "type": "string",
            "description": "Language of the supplied content; defaults to the organisation language. Multilingual organisations receive automatic content translations at creation.",
            "maxLength": 10
          },
          "tagline": {
            "type": "string",
            "maxLength": 2000
          },
          "description": {
            "type": "string",
            "maxLength": 20000
          },
          "mode": {
            "type": "string",
            "enum": [
              "registration",
              "fundraising",
              "both",
              "information"
            ]
          },
          "attendeeMode": {
            "type": "string",
            "enum": [
              "individual",
              "group",
              "family",
              "children"
            ]
          },
          "date": {
            "type": "string",
            "format": "date",
            "description": "Required except for a date-optional standalone fundraiser."
          },
          "dateOptional": {
            "type": "boolean"
          },
          "startTime": {
            "type": "string",
            "pattern": "^(?:[01][0-9]|2[0-3]):[0-5][0-9]$"
          },
          "endTime": {
            "type": "string",
            "pattern": "^(?:[01][0-9]|2[0-3]):[0-5][0-9]$"
          },
          "locationMode": {
            "type": "string",
            "enum": [
              "onsite",
              "online"
            ]
          },
          "locationName": {
            "type": "string",
            "maxLength": 500
          },
          "address": {
            "type": "string",
            "maxLength": 1000
          },
          "onlineUrl": {
            "type": "string",
            "format": "uri",
            "maxLength": 2000
          },
          "cadence": {
            "type": "string",
            "enum": [
              "once",
              "weekly",
              "monthly",
              "custom"
            ]
          },
          "recurrenceCount": {
            "type": "integer",
            "minimum": 1,
            "maximum": 200
          },
          "customDates": {
            "type": "array",
            "maxItems": 200,
            "uniqueItems": true,
            "items": {
              "type": "string",
              "format": "date"
            },
            "description": "All session dates when cadence=custom. The first date and count are derived from this list."
          },
          "excludedDates": {
            "type": "array",
            "maxItems": 200,
            "items": {
              "type": "string",
              "format": "date"
            }
          },
          "slotDuration": {
            "type": "integer",
            "minimum": 0
          },
          "slotCapacity": {
            "type": "integer",
            "minimum": 0
          },
          "capacityEnabled": {
            "type": "boolean"
          },
          "capacity": {
            "type": "integer",
            "minimum": 0
          },
          "priceMode": {
            "type": "string",
            "enum": [
              "free",
              "fixed",
              "multiple",
              "freeAmount"
            ]
          },
          "price": {
            "type": "number",
            "minimum": 0,
            "maximum": 90071992547409,
            "multipleOf": 0.01
          },
          "prices": {
            "type": "object",
            "additionalProperties": {
              "type": "number",
              "minimum": 0,
              "maximum": 90071992547409,
              "multipleOf": 0.01
            },
            "description": "Prices in major currency units, keyed only by lower-case three-letter currency code, with at most 30 entries. No arbitrary metadata field is accepted.",
            "maxProperties": 30,
            "x-unisoft-map-key-pattern": "^[a-z]{3}$"
          },
          "tariffs": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "$ref": "#/components/schemas/EventLifecycleTariff"
            }
          },
          "target": {
            "type": "number",
            "minimum": 0,
            "maximum": 90071992547409,
            "multipleOf": 0.01
          },
          "partialPayments": {
            "type": "boolean"
          },
          "depositAmount": {
            "type": "number",
            "minimum": 0,
            "maximum": 90071992547409,
            "multipleOf": 0.01
          },
          "contributionAmounts": {
            "type": "array",
            "maxItems": 20,
            "items": {
              "type": "number",
              "minimum": 0.01,
              "maximum": 90071992547409,
              "multipleOf": 0.01
            }
          },
          "fields": {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "firstName",
                "lastName",
                "email",
                "phone",
                "address",
                "birthDate"
              ]
            },
            "maxItems": 100
          },
          "children": {
            "type": "boolean"
          },
          "questions": {
            "type": "array",
            "maxItems": 100,
            "items": {
              "$ref": "#/components/schemas/EventLifecycleQuestion"
            }
          },
          "requirementsEnabled": {
            "type": "boolean"
          },
          "requirements": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "$ref": "#/components/schemas/EventLifecycleRequirement"
            }
          },
          "manualValidation": {
            "type": "boolean"
          },
          "confirmationText": {
            "type": "string",
            "maxLength": 5000
          },
          "reminders": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "confirmation": {
                "type": "boolean"
              },
              "weekBefore": {
                "type": "boolean"
              },
              "dayBefore": {
                "type": "boolean"
              }
            }
          },
          "page": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "layout": {
                "type": "string",
                "enum": [
                  "essential",
                  "story",
                  "campaign"
                ]
              },
              "ctaLabel": {
                "type": "string",
                "maxLength": 300
              },
              "showDescription": {
                "type": "boolean"
              },
              "showPracticalInfo": {
                "type": "boolean"
              },
              "showOrganizer": {
                "type": "boolean"
              },
              "showProgress": {
                "type": "boolean"
              },
              "customContent": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "kind": {
                    "type": "string",
                    "enum": [
                      "faq",
                      "pricing",
                      "programme",
                      "speakers",
                      "free"
                    ]
                  },
                  "aiContentBlockId": {
                    "type": "string",
                    "nullable": true,
                    "description": "Existing AI content-block id. Manage its HTML through `/content-blocks`."
                  }
                }
              }
            }
          },
          "poster": {
            "type": "object",
            "additionalProperties": false,
            "description": "A poster exists only when `source=upload` and `image` references a real image.",
            "properties": {
              "source": {
                "type": "string",
                "enum": [
                  "none",
                  "upload"
                ]
              },
              "image": {
                "type": "string",
                "nullable": true,
                "maxLength": 200,
                "description": "Existing hosted JPEG, PNG or WebP filename owned by the organisation. Remote URLs, paths and SVG are refused; saving a draft never downloads a poster."
              },
              "tone": {
                "type": "string",
                "enum": [
                  "auto",
                  "blue",
                  "cyan",
                  "violet",
                  "green",
                  "amber",
                  "rose",
                  "red"
                ],
                "description": "auto follows the public site's theme; explicit colors stay fixed."
              },
              "badge": {
                "type": "string",
                "maxLength": 300
              }
            }
          },
          "campaignEnabled": {
            "type": "boolean",
            "description": "When true, create or update a campaign DRAFT; it is never sent automatically."
          },
          "campaign": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "channels": {
                "type": "array",
                "minItems": 1,
                "maxItems": 3,
                "items": {
                  "type": "string",
                  "enum": [
                    "email",
                    "whatsapp",
                    "sms"
                  ]
                }
              },
              "audience": {
                "type": "string",
                "enum": [
                  "all",
                  "families",
                  "participants",
                  "custom"
                ],
                "description": "`families`, `participants` and `custom` keep the draft without automatic targeting until the organiser chooses the exact audience."
              },
              "includePoster": {
                "type": "boolean",
                "description": "The image is attached only when a real uploaded poster exists."
              },
              "message": {
                "type": "string",
                "maxLength": 10000
              },
              "schedule": {
                "type": "string",
                "enum": [
                  "now",
                  "later"
                ]
              },
              "scheduledAt": {
                "type": "string",
                "nullable": true,
                "description": "ISO date-time used when the campaign is eventually sent.",
                "maxLength": 100
              }
            }
          }
        },
        "required": [
          "title",
          "destination",
          "mode"
        ]
      },
      "EventLifecycleDestination": {
        "type": "object",
        "additionalProperties": false,
        "description": "Where the event belongs. Use `existing` only after listing and explicitly selecting a compatible ordinary group; protected and multi-session groups are rejected.",
        "properties": {
          "kind": {
            "type": "string",
            "enum": [
              "new",
              "existing"
            ],
            "default": "new"
          },
          "groupId": {
            "type": "string",
            "nullable": true,
            "description": "Existing ordinary standalone group id."
          },
          "groupLabel": {
            "type": "string",
            "maxLength": 500
          },
          "confirmed": {
            "type": "boolean",
            "description": "Must be true: the caller confirms the destination decision."
          }
        },
        "required": [
          "kind",
          "confirmed"
        ]
      },
      "EventLifecycleTariff": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "id": {
            "type": "string",
            "maxLength": 100
          },
          "label": {
            "type": "string",
            "maxLength": 300
          },
          "price": {
            "type": "number",
            "minimum": 0,
            "maximum": 90071992547409,
            "multipleOf": 0.01
          },
          "prices": {
            "type": "object",
            "additionalProperties": {
              "type": "number",
              "minimum": 0,
              "maximum": 90071992547409,
              "multipleOf": 0.01
            },
            "description": "Prices in major currency units, keyed only by lower-case three-letter currency code, with at most 30 entries. No arbitrary metadata field is accepted.",
            "maxProperties": 30,
            "x-unisoft-map-key-pattern": "^[a-z]{3}$"
          },
          "stock": {
            "type": "integer",
            "minimum": 0,
            "nullable": true
          }
        },
        "required": [
          "label",
          "price"
        ]
      },
      "EventLifecycleQuestion": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "id": {
            "type": "string",
            "maxLength": 100
          },
          "label": {
            "type": "string",
            "maxLength": 500
          },
          "type": {
            "type": "string",
            "enum": [
              "shortText",
              "longText",
              "yesNo",
              "choice",
              "document"
            ]
          },
          "required": {
            "type": "boolean"
          },
          "options": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "type": "string",
              "maxLength": 300
            }
          },
          "condition": {
            "type": "object",
            "nullable": true,
            "additionalProperties": false,
            "properties": {
              "questionId": {
                "type": "string",
                "maxLength": 100
              },
              "value": {
                "type": "string",
                "maxLength": 300
              }
            },
            "required": [
              "questionId",
              "value"
            ]
          }
        },
        "required": [
          "label",
          "type"
        ]
      },
      "EventLifecycleRequirement": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "id": {
            "type": "string",
            "maxLength": 100
          },
          "label": {
            "type": "string",
            "maxLength": 500
          },
          "required": {
            "type": "boolean"
          }
        },
        "required": [
          "label"
        ]
      },
      "EventLifecyclePublicationPlan": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "draftId",
          "expectedRevision",
          "planHash",
          "currency",
          "effectiveTimeZone",
          "publicBaseUrl",
          "requiredScopes",
          "sessions"
        ],
        "properties": {
          "draftId": {
            "type": "string",
            "format": "uuid"
          },
          "expectedRevision": {
            "type": "integer",
            "minimum": 1
          },
          "planHash": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "currency": {
            "type": "string",
            "pattern": "^[a-z]{3}$"
          },
          "effectiveTimeZone": {
            "type": "string"
          },
          "publicBaseUrl": {
            "type": "string",
            "format": "uri"
          },
          "requiredScopes": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "sessions": {
            "type": "array",
            "maxItems": 200,
            "items": {
              "type": "object",
              "additionalProperties": false,
              "required": [
                "logicalKey",
                "startAt",
                "endAt"
              ],
              "properties": {
                "logicalKey": {
                  "type": "string"
                },
                "startAt": {
                  "type": "string",
                  "format": "date-time"
                },
                "endAt": {
                  "type": "string",
                  "format": "date-time"
                }
              }
            }
          }
        }
      },
      "EventLifecyclePublication": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "draftId",
          "projectId",
          "commandId",
          "draftRevision",
          "projectRevision",
          "publicationStatus",
          "effectiveTimeZone",
          "currency",
          "publicUrl",
          "publishedAt"
        ],
        "properties": {
          "draftId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string",
            "format": "uuid"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "draftRevision": {
            "type": "integer",
            "minimum": 2
          },
          "projectRevision": {
            "type": "integer",
            "minimum": 1
          },
          "publicationStatus": {
            "type": "string",
            "enum": [
              "PUBLISHED",
              "CREATED"
            ]
          },
          "effectiveTimeZone": {
            "type": "string"
          },
          "currency": {
            "type": "string",
            "pattern": "^[a-z]{3}$"
          },
          "publicUrl": {
            "type": "string",
            "nullable": true
          },
          "publishedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          }
        }
      },
      "EventLifecycleUnpublishPlan": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "projectId",
          "expectedRevision",
          "planHash",
          "publicResourceId",
          "requiredScopes",
          "sessionIds",
          "formIds",
          "fundraiserIds",
          "historyPreserved"
        ],
        "properties": {
          "projectId": {
            "type": "string"
          },
          "expectedRevision": {
            "type": "integer",
            "minimum": 1
          },
          "planHash": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "publicResourceId": {
            "type": "string"
          },
          "requiredScopes": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "historyPreserved": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "sessionIds": {
            "type": "array",
            "maxItems": 200,
            "items": {
              "type": "string"
            }
          },
          "formIds": {
            "type": "array",
            "maxItems": 200,
            "items": {
              "type": "string"
            }
          },
          "fundraiserIds": {
            "type": "array",
            "maxItems": 200,
            "items": {
              "type": "string"
            }
          }
        }
      },
      "EventLifecycleUnpublishResult": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "projectId",
          "commandId",
          "revision",
          "visibility",
          "sessionIds",
          "formIds",
          "fundraiserIds",
          "historyPreserved"
        ],
        "properties": {
          "projectId": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "revision": {
            "type": "integer",
            "minimum": 2
          },
          "visibility": {
            "type": "string",
            "enum": [
              "UNPUBLISHED"
            ]
          },
          "historyPreserved": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "sessionIds": {
            "type": "array",
            "maxItems": 200,
            "items": {
              "type": "string"
            }
          },
          "formIds": {
            "type": "array",
            "maxItems": 200,
            "items": {
              "type": "string"
            }
          },
          "fundraiserIds": {
            "type": "array",
            "maxItems": 200,
            "items": {
              "type": "string"
            }
          }
        }
      },
      "EventLifecycleReschedulePlan": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "projectId",
          "sessionId",
          "expectedRevision",
          "planHash",
          "effectiveTimeZone",
          "previous",
          "next",
          "requiredScopes",
          "preserved",
          "seriesBecomesCustom",
          "campaignsUnchanged"
        ],
        "properties": {
          "projectId": {
            "type": "string"
          },
          "sessionId": {
            "type": "string"
          },
          "expectedRevision": {
            "type": "integer",
            "minimum": 1
          },
          "planHash": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "effectiveTimeZone": {
            "type": "string"
          },
          "previous": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "logicalKey",
              "startAt",
              "endAt"
            ],
            "properties": {
              "logicalKey": {
                "type": "string"
              },
              "startAt": {
                "type": "string",
                "format": "date-time"
              },
              "endAt": {
                "type": "string",
                "format": "date-time"
              }
            }
          },
          "next": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "logicalKey",
              "startAt",
              "endAt"
            ],
            "properties": {
              "logicalKey": {
                "type": "string"
              },
              "startAt": {
                "type": "string",
                "format": "date-time"
              },
              "endAt": {
                "type": "string",
                "format": "date-time"
              }
            }
          },
          "requiredScopes": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "preserved": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "sessionId",
              "formIds",
              "productIds",
              "fundraiserIds",
              "livretIds"
            ],
            "properties": {
              "sessionId": {
                "type": "string"
              },
              "formIds": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "productIds": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "fundraiserIds": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "livretIds": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            }
          },
          "seriesBecomesCustom": {
            "type": "boolean"
          },
          "campaignsUnchanged": {
            "type": "boolean",
            "enum": [
              true
            ]
          }
        }
      },
      "EventLifecycleRescheduleResult": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "projectId",
          "sessionId",
          "commandId",
          "revision",
          "startAt",
          "endAt",
          "preserved"
        ],
        "properties": {
          "projectId": {
            "type": "string"
          },
          "sessionId": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "revision": {
            "type": "integer",
            "minimum": 2
          },
          "startAt": {
            "type": "string",
            "format": "date-time"
          },
          "endAt": {
            "type": "string",
            "format": "date-time"
          },
          "preserved": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "sessionId",
              "formIds",
              "productIds",
              "fundraiserIds",
              "livretIds"
            ],
            "properties": {
              "sessionId": {
                "type": "string"
              },
              "formIds": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "productIds": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "fundraiserIds": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "livretIds": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    },
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "API Key",
        "description": "Format: `ke_live_xxx`"
      },
      "apiKeyHeader": {
        "type": "apiKey",
        "in": "header",
        "name": "X-API-Key"
      }
    }
  }
}
```
