From 2da1c5e80f467ba4905b90b6b513e55c49afdd58 Mon Sep 17 00:00:00 2001 From: alisaza Date: Fri, 11 Sep 2026 15:52:29 +0330 Subject: [PATCH] fix(events): align admin capacity API with direct live edits Support optional capacity on the reserved-capacity patch and stop showing proposed capacity on pending revision cards. --- .../AdminEventPendingRevisionCard.tsx | 11 +- openapi.json | 3604 ++++------------- services/events.ts | 7 +- 3 files changed, 714 insertions(+), 2908 deletions(-) diff --git a/features/events/detail/admin-event-detail/AdminEventPendingRevisionCard.tsx b/features/events/detail/admin-event-detail/AdminEventPendingRevisionCard.tsx index 1f2f0db..8466659 100644 --- a/features/events/detail/admin-event-detail/AdminEventPendingRevisionCard.tsx +++ b/features/events/detail/admin-event-detail/AdminEventPendingRevisionCard.tsx @@ -3,7 +3,6 @@ import type { EventRevision } from '@/services/events' import Button from '@/components/formElements/Button' import { Card, CardBody } from '@/components/heroui/Card' -import { formatNumber } from '@/helpers' import { texts } from '@/texts' interface AdminEventPendingRevisionCardProps { @@ -14,7 +13,7 @@ interface AdminEventPendingRevisionCardProps { } const AdminEventPendingRevisionCard = ({ pendingId, revision, onApprove, onReject }: AdminEventPendingRevisionCardProps) => { - const { title, slug, capacity } = revision.payload + const { title, slug } = revision.payload return ( @@ -24,7 +23,7 @@ const AdminEventPendingRevisionCard = ({ pendingId, revision, onApprove, onRejec

ارسال‌شده: {new Date(revision.submittedAt).toLocaleString('fa-IR')}

-
+
{title != null && title !== '' ? (
عنوان پیشنهادی
@@ -42,12 +41,6 @@ const AdminEventPendingRevisionCard = ({ pendingId, revision, onApprove, onRejec
) : null} - {capacity != null && Number.isFinite(Number(capacity)) ? ( -
-
ظرفیت پیشنهادی
-
{formatNumber(Number(capacity))}
-
- ) : null}
diff --git a/openapi.json b/openapi.json index 22a24d9..3ef2447 100644 --- a/openapi.json +++ b/openapi.json @@ -50,9 +50,7 @@ } }, "summary": "Request SMS OTP", - "tags": [ - "Auth" - ] + "tags": ["Auth"] } }, "/api/v1/auth/verify-otp": { @@ -114,9 +112,7 @@ } }, "summary": "Verify OTP", - "tags": [ - "Auth" - ] + "tags": ["Auth"] } }, "/api/v1/auth/refresh": { @@ -157,9 +153,7 @@ } }, "summary": "Refresh JWT tokens", - "tags": [ - "Auth" - ] + "tags": ["Auth"] } }, "/api/v1/auth/logout": { @@ -225,9 +219,7 @@ } ], "summary": "Logout current session", - "tags": [ - "Auth" - ] + "tags": ["Auth"] } }, "/api/v1/auth/logout-all": { @@ -293,9 +285,7 @@ } ], "summary": "Logout all sessions", - "tags": [ - "Auth" - ] + "tags": ["Auth"] } }, "/api/v1/auth/sessions": { @@ -364,9 +354,7 @@ } ], "summary": "List active sessions", - "tags": [ - "Auth" - ] + "tags": ["Auth"] } }, "/api/v1/auth/sessions/{id}": { @@ -454,9 +442,7 @@ } ], "summary": "Revoke a session", - "tags": [ - "Auth" - ] + "tags": ["Auth"] } }, "/api/v1/internal/sentry-webhook": { @@ -492,9 +478,7 @@ } }, "summary": "Sentry → Telegram alert relay", - "tags": [ - "Ops" - ] + "tags": ["Ops"] } }, "/api/v1/internal/jibit-transaction-webhook": { @@ -539,9 +523,7 @@ } }, "summary": "Jibit account-transaction → Telegram relay", - "tags": [ - "Ops" - ] + "tags": ["Ops"] } }, "/api/v1/users/public/{id}": { @@ -575,9 +557,7 @@ } ], "summary": "Get a public user profile; host stats are included only for verified hosts", - "tags": [ - "Users" - ] + "tags": ["Users"] } }, "/api/v1/users/public/{id}/events": { @@ -645,10 +625,7 @@ "description": "0 = JSON list (default). 1 = Excel export (returns response.fileData).", "schema": { "type": "number", - "enum": [ - 0, - 1 - ] + "enum": [0, 1] } }, { @@ -658,10 +635,7 @@ "schema": { "default": "upcoming", "type": "string", - "enum": [ - "upcoming", - "held" - ] + "enum": ["upcoming", "held"] } } ], @@ -685,10 +659,7 @@ "description": "Pagination metadata for the current query." } }, - "required": [ - "items", - "response" - ] + "required": ["items", "response"] } } } @@ -700,9 +671,7 @@ } ], "summary": "List discoverable events for a verified public host", - "tags": [ - "Users" - ] + "tags": ["Users"] } }, "/api/v1/users/public/{id}/viewer-state": { @@ -736,9 +705,7 @@ } ], "summary": "Get private organizer state for the current viewer", - "tags": [ - "Users" - ] + "tags": ["Users"] } }, "/api/v1/users/me": { @@ -804,9 +771,7 @@ } ], "summary": "Get current user profile", - "tags": [ - "Users" - ] + "tags": ["Users"] }, "patch": { "description": "Updates editable profile fields for the authenticated user only.", @@ -881,9 +846,7 @@ } ], "summary": "Update current user profile", - "tags": [ - "Users" - ] + "tags": ["Users"] } }, "/api/v1/users/me/profile-summary": { @@ -959,9 +922,7 @@ } ], "summary": "Get current user profile hub summary", - "tags": [ - "Users" - ] + "tags": ["Users"] } }, "/api/v1/users/{id}/attendee-contact-links": { @@ -999,9 +960,7 @@ } ], "summary": "Get attendee-only contact links for an organizer", - "tags": [ - "Users" - ] + "tags": ["Users"] } }, "/api/v1/users/me/complete-profile": { @@ -1088,9 +1047,7 @@ } ], "summary": "Complete user profile after OTP verification", - "tags": [ - "Users" - ] + "tags": ["Users"] } }, "/api/v1/admin/users": { @@ -1159,10 +1116,7 @@ "description": "0 = JSON list (default). 1 = Excel export (returns response.fileData).", "schema": { "type": "number", - "enum": [ - 0, - 1 - ] + "enum": [0, 1] } }, { @@ -1286,10 +1240,7 @@ "description": "Pagination metadata for the current query." } }, - "required": [ - "items", - "response" - ] + "required": ["items", "response"] } } } @@ -1361,9 +1312,7 @@ } ], "summary": "Paginated admin users list", - "tags": [ - "Admin - Users" - ] + "tags": ["Admin - Users"] } }, "/api/v1/admin/users/{id}/mobile": { @@ -1469,9 +1418,7 @@ } ], "summary": "Change a user's login mobile (admin)", - "tags": [ - "Admin - Users" - ] + "tags": ["Admin - Users"] } }, "/api/v1/admin/users/{id}": { @@ -1578,9 +1525,7 @@ } ], "summary": "Edit a user (admin)", - "tags": [ - "Admin - Users" - ] + "tags": ["Admin - Users"] }, "get": { "description": "Staff-only: full profile, identity status, wallet balance, and a summary count for every category (hosted events, bookings, payments, reviews, follows, reports, blocks). See the dedicated sub-endpoints (hosted-events, bookings, payments, reviews, follows, reports, blocks) for the paginated lists themselves.", @@ -1673,9 +1618,7 @@ } ], "summary": "Full user detail for admin", - "tags": [ - "Admin - User Detail" - ] + "tags": ["Admin - User Detail"] } }, "/api/v1/users/me/contact-links": { @@ -1703,9 +1646,7 @@ } ], "summary": "Current user's contact links (unpaginated)", - "tags": [ - "users" - ] + "tags": ["users"] }, "post": { "operationId": "UserContactLinksController_create", @@ -1738,9 +1679,7 @@ } ], "summary": "Add a contact link for the current user", - "tags": [ - "users" - ] + "tags": ["users"] } }, "/api/v1/users/me/contact-links/{id}": { @@ -1784,9 +1723,7 @@ } ], "summary": "Update a contact link owned by the current user", - "tags": [ - "users" - ] + "tags": ["users"] }, "delete": { "operationId": "UserContactLinksController_remove", @@ -1818,9 +1755,7 @@ } ], "summary": "Remove a contact link owned by the current user", - "tags": [ - "users" - ] + "tags": ["users"] } }, "/api/v1/identity/rejection-reasons": { @@ -1864,9 +1799,7 @@ } }, "summary": "List active identity rejection reasons", - "tags": [ - "Identity" - ] + "tags": ["Identity"] } }, "/api/v1/identity/verifications/request-otp": { @@ -1962,9 +1895,7 @@ } ], "summary": "Request OTP to confirm host cooperation contract", - "tags": [ - "Identity" - ] + "tags": ["Identity"] } }, "/api/v1/identity/verifications/confirm-otp": { @@ -2050,9 +1981,7 @@ } ], "summary": "Confirm host-contract OTP and submit identity verification", - "tags": [ - "Identity" - ] + "tags": ["Identity"] } }, "/api/v1/identity/verifications/me": { @@ -2121,9 +2050,7 @@ } ], "summary": "List my identity verification submissions", - "tags": [ - "Identity" - ] + "tags": ["Identity"] } }, "/api/v1/admin/identity/verifications": { @@ -2185,10 +2112,7 @@ "description": "0 = JSON list (default). 1 = Excel export (returns response.fileData).", "schema": { "type": "number", - "enum": [ - 0, - 1 - ] + "enum": [0, 1] } }, { @@ -2232,10 +2156,7 @@ "description": "Pagination metadata for the current query." } }, - "required": [ - "items", - "response" - ] + "required": ["items", "response"] } } } @@ -2307,9 +2228,7 @@ } ], "summary": "List identity verification review queue", - "tags": [ - "Admin - Identity" - ] + "tags": ["Admin - Identity"] } }, "/api/v1/admin/identity/verifications/{id}/jibit-inquiry": { @@ -2407,9 +2326,7 @@ } ], "summary": "Run Jibit national-code/mobile matching inquiry", - "tags": [ - "Admin - Identity" - ] + "tags": ["Admin - Identity"] } }, "/api/v1/admin/identity/verifications/{id}/approve": { @@ -2507,9 +2424,7 @@ } ], "summary": "Approve identity verification", - "tags": [ - "Admin - Identity" - ] + "tags": ["Admin - Identity"] } }, "/api/v1/admin/identity/verifications/{id}/reject": { @@ -2618,9 +2533,7 @@ } ], "summary": "Reject identity verification", - "tags": [ - "Admin - Identity" - ] + "tags": ["Admin - Identity"] } }, "/api/v1/notifications/me": { @@ -2682,10 +2595,7 @@ "description": "0 = JSON list (default). 1 = Excel export (returns response.fileData).", "schema": { "type": "number", - "enum": [ - 0, - 1 - ] + "enum": [0, 1] } }, { @@ -2729,10 +2639,7 @@ "description": "Pagination metadata for the current query." } }, - "required": [ - "items", - "response" - ] + "required": ["items", "response"] } } } @@ -2784,9 +2691,7 @@ } ], "summary": "List my in-app notifications", - "tags": [ - "Notifications" - ] + "tags": ["Notifications"] } }, "/api/v1/notifications/me/unread-count": { @@ -2852,9 +2757,7 @@ } ], "summary": "Get unread in-app notification count", - "tags": [ - "Notifications" - ] + "tags": ["Notifications"] } }, "/api/v1/notifications/me/read-all": { @@ -2920,9 +2823,7 @@ } ], "summary": "Mark all my in-app notifications as read", - "tags": [ - "Notifications" - ] + "tags": ["Notifications"] } }, "/api/v1/notifications/{id}/read": { @@ -3009,9 +2910,7 @@ } ], "summary": "Mark an in-app notification as read", - "tags": [ - "Notifications" - ] + "tags": ["Notifications"] } }, "/api/v1/notifications/push/vapid-public-key": { @@ -3077,9 +2976,7 @@ } ], "summary": "Get VAPID public key for Web Push subscription", - "tags": [ - "Notifications" - ] + "tags": ["Notifications"] } }, "/api/v1/notifications/push/deliveries/receipt": { @@ -3165,9 +3062,7 @@ } ], "summary": "Record a browser Web Push receipt event", - "tags": [ - "Notifications" - ] + "tags": ["Notifications"] } }, "/api/v1/notifications/push/subscribe": { @@ -3256,9 +3151,7 @@ } ], "summary": "Register a browser Web Push subscription", - "tags": [ - "Notifications" - ] + "tags": ["Notifications"] }, "delete": { "description": "Called on logout to stop push delivery to all user devices.", @@ -3325,9 +3218,7 @@ } ], "summary": "Remove all Web Push subscriptions for current user", - "tags": [ - "Notifications" - ] + "tags": ["Notifications"] } }, "/api/v1/notifications/push/subscribe/{id}": { @@ -3415,9 +3306,7 @@ } ], "summary": "Remove a browser Web Push subscription", - "tags": [ - "Notifications" - ] + "tags": ["Notifications"] } }, "/api/v1/admin/sms-messages": { @@ -3479,10 +3368,7 @@ "description": "0 = JSON list (default). 1 = Excel export (returns response.fileData).", "schema": { "type": "number", - "enum": [ - 0, - 1 - ] + "enum": [0, 1] } }, { @@ -3536,10 +3422,7 @@ "description": "Pagination metadata for the current query." } }, - "required": [ - "items", - "response" - ] + "required": ["items", "response"] } } } @@ -3611,9 +3494,7 @@ } ], "summary": "List SMS delivery records", - "tags": [ - "Admin - Notifications" - ] + "tags": ["Admin - Notifications"] } }, "/api/v1/admin/notification-rules": { @@ -3641,9 +3522,7 @@ } ], "summary": "List admin-managed notification rules", - "tags": [ - "Admin - Notification Rules" - ] + "tags": ["Admin - Notification Rules"] } }, "/api/v1/admin/notification-rules/{eventKey}": { @@ -3687,9 +3566,7 @@ } ], "summary": "Update delivery and templates for a notification event", - "tags": [ - "Admin - Notification Rules" - ] + "tags": ["Admin - Notification Rules"] } }, "/api/v1/admin/manual-notifications/request-otp": { @@ -3775,9 +3652,7 @@ } ], "summary": "Request OTP before sending a group SMS", - "tags": [ - "Admin - Notifications" - ] + "tags": ["Admin - Notifications"] } }, "/api/v1/admin/manual-notifications": { @@ -3873,9 +3748,7 @@ } ], "summary": "Send a manual notification to selected users", - "tags": [ - "Admin - Notifications" - ] + "tags": ["Admin - Notifications"] } }, "/api/v1/admin/in-app-notifications": { @@ -3937,10 +3810,7 @@ "description": "0 = JSON list (default). 1 = Excel export (returns response.fileData).", "schema": { "type": "number", - "enum": [ - 0, - 1 - ] + "enum": [0, 1] } }, { @@ -4004,10 +3874,7 @@ "description": "Pagination metadata for the current query." } }, - "required": [ - "items", - "response" - ] + "required": ["items", "response"] } } } @@ -4079,9 +3946,7 @@ } ], "summary": "List in-app notifications", - "tags": [ - "Admin - Notifications" - ] + "tags": ["Admin - Notifications"] } }, "/api/v1/admin/push-deliveries": { @@ -4143,10 +4008,7 @@ "description": "0 = JSON list (default). 1 = Excel export (returns response.fileData).", "schema": { "type": "number", - "enum": [ - 0, - 1 - ] + "enum": [0, 1] } }, { @@ -4210,10 +4072,7 @@ "description": "Pagination metadata for the current query." } }, - "required": [ - "items", - "response" - ] + "required": ["items", "response"] } } } @@ -4285,9 +4144,7 @@ } ], "summary": "List Web Push delivery records", - "tags": [ - "Admin - Notifications" - ] + "tags": ["Admin - Notifications"] } }, "/api/v1/event-categories": { @@ -4310,9 +4167,7 @@ } }, "summary": "Active event categories (flat list, unpaginated)", - "tags": [ - "Event Categories" - ] + "tags": ["Event Categories"] } }, "/api/v1/event-categories/{slug}": { @@ -4341,9 +4196,7 @@ } }, "summary": "Single active category by slug", - "tags": [ - "Event Categories" - ] + "tags": ["Event Categories"] } }, "/api/v1/admin/event-categories/flat": { @@ -4371,9 +4224,7 @@ } ], "summary": "Flat list of all categories for admin filters", - "tags": [ - "Admin - Event Categories" - ] + "tags": ["Admin - Event Categories"] } }, "/api/v1/admin/event-categories": { @@ -4432,10 +4283,7 @@ "description": "0 = JSON list (default). 1 = Excel export (returns response.fileData).", "schema": { "type": "number", - "enum": [ - 0, - 1 - ] + "enum": [0, 1] } } ], @@ -4459,10 +4307,7 @@ "description": "Pagination metadata for the current query." } }, - "required": [ - "items", - "response" - ] + "required": ["items", "response"] } } } @@ -4474,9 +4319,7 @@ } ], "summary": "Paginated category management list", - "tags": [ - "Admin - Event Categories" - ] + "tags": ["Admin - Event Categories"] }, "post": { "operationId": "AdminEventCategoriesController_create", @@ -4509,9 +4352,7 @@ } ], "summary": "Create event category", - "tags": [ - "Admin - Event Categories" - ] + "tags": ["Admin - Event Categories"] } }, "/api/v1/admin/event-categories/{id}": { @@ -4555,9 +4396,7 @@ } ], "summary": "Update event category", - "tags": [ - "Admin - Event Categories" - ] + "tags": ["Admin - Event Categories"] }, "delete": { "operationId": "AdminEventCategoriesController_remove", @@ -4589,9 +4428,7 @@ } ], "summary": "Soft-delete event category", - "tags": [ - "Admin - Event Categories" - ] + "tags": ["Admin - Event Categories"] } }, "/api/v1/geography/provinces": { @@ -4614,13 +4451,12 @@ } }, "summary": "List all provinces (unpaginated)", - "tags": [ - "Geography" - ] + "tags": ["Geography"] } }, "/api/v1/geography/cities": { "get": { + "description": "Same enabled-city payload as GET /discovery/cities (CityResponseDto includes slug). Consumer apps should prefer the cached discovery endpoint; this route remains for geography/SEO tooling.", "operationId": "GeographyController_listAllCities", "parameters": [], "responses": { @@ -4639,9 +4475,7 @@ } }, "summary": "List all cities (unpaginated, flat)", - "tags": [ - "Geography" - ] + "tags": ["Geography"] } }, "/api/v1/geography/provinces/{provinceId}/cities": { @@ -4673,13 +4507,12 @@ } }, "summary": "List cities in a province (unpaginated)", - "tags": [ - "Geography" - ] + "tags": ["Geography"] } }, "/api/v1/geography/cities/{slug}": { "get": { + "description": "Web/SEO landing lookup by slug (adds provinceName + provinceSlug). Not required for Android when the client already has the city from GET /discovery/cities and navigates by id.", "operationId": "GeographyController_findCityBySlug", "parameters": [ { @@ -4704,9 +4537,7 @@ } }, "summary": "Single city by slug (SEO city landing pages)", - "tags": [ - "Geography" - ] + "tags": ["Geography"] } }, "/api/v1/my-events": { @@ -4766,10 +4597,7 @@ "description": "0 = JSON list (default). 1 = Excel export (returns response.fileData).", "schema": { "type": "number", - "enum": [ - 0, - 1 - ] + "enum": [0, 1] } }, { @@ -4779,10 +4607,7 @@ "schema": { "default": "guest", "type": "string", - "enum": [ - "guest", - "host" - ] + "enum": ["guest", "host"] } }, { @@ -4792,14 +4617,7 @@ "schema": { "default": "upcoming", "type": "string", - "enum": [ - "upcoming", - "held", - "cancelled", - "pending_review", - "published", - "rejected" - ] + "enum": ["upcoming", "held", "cancelled", "pending_review", "published", "rejected"] } } ], @@ -4810,32 +4628,15 @@ "application/json": { "schema": { "type": "object", - "required": [ - "role", - "status", - "canHost", - "availableRoles", - "items", - "response" - ], + "required": ["role", "status", "canHost", "availableRoles", "items", "response"], "properties": { "role": { "type": "string", - "enum": [ - "guest", - "host" - ] + "enum": ["guest", "host"] }, "status": { "type": "string", - "enum": [ - "upcoming", - "held", - "cancelled", - "pending_review", - "published", - "rejected" - ] + "enum": ["upcoming", "held", "cancelled", "pending_review", "published", "rejected"] }, "canHost": { "type": "boolean" @@ -4844,10 +4645,7 @@ "type": "array", "items": { "type": "string", - "enum": [ - "guest", - "host" - ] + "enum": ["guest", "host"] } }, "items": { @@ -4878,9 +4676,7 @@ } ], "summary": "List the current user’s guest or hosted events by lifecycle", - "tags": [ - "My Events" - ] + "tags": ["My Events"] } }, "/api/v1/events/{eventId}/revisions": { @@ -4924,9 +4720,7 @@ } ], "summary": "Submit a pending revision for a published/full event (admin must re-approve before changes go live)", - "tags": [ - "My Events" - ] + "tags": ["My Events"] } }, "/api/v1/events/{eventId}/revisions/pending": { @@ -4960,9 +4754,7 @@ } ], "summary": "Get the current pending revision for own live event", - "tags": [ - "My Events" - ] + "tags": ["My Events"] }, "delete": { "operationId": "EventRevisionsController_withdraw", @@ -4996,9 +4788,7 @@ } ], "summary": "Withdraw the pending revision for own live event", - "tags": [ - "My Events" - ] + "tags": ["My Events"] } }, "/api/v1/events": { @@ -5033,9 +4823,7 @@ } ], "summary": "Create a draft event (verified host)", - "tags": [ - "My Events" - ] + "tags": ["My Events"] }, "get": { "operationId": "EventsController_discovery", @@ -5096,10 +4884,7 @@ "description": "0 = JSON list (default). 1 = Excel export (returns response.fileData).", "schema": { "type": "number", - "enum": [ - 0, - 1 - ] + "enum": [0, 1] } } ], @@ -5123,19 +4908,14 @@ "description": "Pagination metadata for the current query." } }, - "required": [ - "items", - "response" - ] + "required": ["items", "response"] } } } } }, "summary": "Public event discovery list", - "tags": [ - "Events" - ] + "tags": ["Events"] } }, "/api/v1/events/mine": { @@ -5198,10 +4978,7 @@ "description": "0 = JSON list (default). 1 = Excel export (returns response.fileData).", "schema": { "type": "number", - "enum": [ - 0, - 1 - ] + "enum": [0, 1] } } ], @@ -5225,10 +5002,7 @@ "description": "Pagination metadata for the current query." } }, - "required": [ - "items", - "response" - ] + "required": ["items", "response"] } } } @@ -5240,9 +5014,7 @@ } ], "summary": "Organizer's own events", - "tags": [ - "My Events" - ] + "tags": ["My Events"] } }, "/api/v1/events/{id}/for-edit": { @@ -5277,9 +5049,7 @@ } ], "summary": "Full event payload for edit/clone forms", - "tags": [ - "My Events" - ] + "tags": ["My Events"] } }, "/api/v1/events/{id}/owner-insights": { @@ -5313,9 +5083,7 @@ } ], "summary": "Get engagement insights for own event", - "tags": [ - "My Events" - ] + "tags": ["My Events"] } }, "/api/v1/events/{id}/management-bootstrap": { @@ -5349,9 +5117,7 @@ } ], "summary": "Get all initial data for managing an owned event", - "tags": [ - "My Events" - ] + "tags": ["My Events"] } }, "/api/v1/events/{id}/attendees": { @@ -5418,10 +5184,7 @@ "description": "0 = JSON list (default). 1 = Excel export (returns response.fileData).", "schema": { "type": "number", - "enum": [ - 0, - 1 - ] + "enum": [0, 1] } }, { @@ -5463,10 +5226,7 @@ "description": "Pagination metadata for the current query." } }, - "required": [ - "items", - "response" - ] + "required": ["items", "response"] } } } @@ -5478,14 +5238,12 @@ } ], "summary": "Search and list registrations for own event attendance desk", - "tags": [ - "My Events" - ] + "tags": ["My Events"] } }, "/api/v1/events/{id}/reserved-capacity": { "patch": { - "description": "Absolute reservedCapacity. Occupancy is bookedCount + reservedCapacity and cannot exceed capacity. Pending payments already occupy seats.", + "description": "Absolute reservedCapacity; optional capacity. Allowed on live events without admin revision. Occupancy is bookedCount + reservedCapacity and cannot exceed capacity. Status flips published ↔ full via DB trigger.", "operationId": "MyEventsController_updateReservedCapacity", "parameters": [ { @@ -5524,10 +5282,8 @@ "bearer": [] } ], - "summary": "Set off-platform reserved seat count for own event", - "tags": [ - "My Events" - ] + "summary": "Set capacity and/or off-platform reserved seats for own event", + "tags": ["My Events"] } }, "/api/v1/events/{id}": { @@ -5571,9 +5327,7 @@ } ], "summary": "Update own event", - "tags": [ - "My Events" - ] + "tags": ["My Events"] }, "delete": { "operationId": "MyEventsController_softDelete", @@ -5605,9 +5359,7 @@ } ], "summary": "Soft-delete own event when it has no active bookings (booked_count = 0)", - "tags": [ - "My Events" - ] + "tags": ["My Events"] }, "get": { "operationId": "EventsController_findOne", @@ -5634,9 +5386,7 @@ } }, "summary": "Single event detail", - "tags": [ - "Events" - ] + "tags": ["Events"] } }, "/api/v1/events/{id}/publish": { @@ -5670,9 +5420,7 @@ } ], "summary": "Publish draft event", - "tags": [ - "My Events" - ] + "tags": ["My Events"] } }, "/api/v1/events/{id}/cancel": { @@ -5706,9 +5454,7 @@ } ], "summary": "Cancel published/full event", - "tags": [ - "My Events" - ] + "tags": ["My Events"] } }, "/api/v1/events/{id}/complete": { @@ -5742,9 +5488,7 @@ } ], "summary": "Mark event completed (creates group chat)", - "tags": [ - "My Events" - ] + "tags": ["My Events"] } }, "/api/v1/events/{id}/clone": { @@ -5778,9 +5522,7 @@ } ], "summary": "Clone event to new draft", - "tags": [ - "My Events" - ] + "tags": ["My Events"] } }, "/api/v1/events/bookmarks": { @@ -5839,10 +5581,7 @@ "description": "0 = JSON list (default). 1 = Excel export (returns response.fileData).", "schema": { "type": "number", - "enum": [ - 0, - 1 - ] + "enum": [0, 1] } } ], @@ -5866,10 +5605,7 @@ "description": "Pagination metadata for the current query." } }, - "required": [ - "items", - "response" - ] + "required": ["items", "response"] } } } @@ -5881,9 +5617,7 @@ } ], "summary": "List events bookmarked by current user", - "tags": [ - "Event Bookmarks" - ] + "tags": ["Event Bookmarks"] } }, "/api/v1/events/bookmarks/status": { @@ -5918,9 +5652,7 @@ } ], "summary": "Get bookmark status for a batch of events", - "tags": [ - "Event Bookmarks" - ] + "tags": ["Event Bookmarks"] } }, "/api/v1/events/{id}/bookmark": { @@ -5954,9 +5686,7 @@ } ], "summary": "Get bookmark status for current user", - "tags": [ - "Event Bookmarks" - ] + "tags": ["Event Bookmarks"] }, "post": { "operationId": "EventBookmarksController_bookmark", @@ -5988,9 +5718,7 @@ } ], "summary": "Bookmark an event", - "tags": [ - "Event Bookmarks" - ] + "tags": ["Event Bookmarks"] }, "delete": { "operationId": "EventBookmarksController_remove", @@ -6022,9 +5750,7 @@ } ], "summary": "Remove an event bookmark", - "tags": [ - "Event Bookmarks" - ] + "tags": ["Event Bookmarks"] } }, "/api/v1/events/by-slug/{slug}/bootstrap": { @@ -6053,9 +5779,7 @@ } }, "summary": "Public event landing bootstrap payload", - "tags": [ - "Events" - ] + "tags": ["Events"] } }, "/api/v1/events/by-slug/{slug}": { @@ -6084,9 +5808,7 @@ } }, "summary": "Single discoverable event by slug (SEO event landing page)", - "tags": [ - "Events" - ] + "tags": ["Events"] } }, "/api/v1/events/{id}/viewer-state": { @@ -6115,9 +5837,7 @@ } }, "summary": "Authenticated viewer state for an event landing", - "tags": [ - "Events" - ] + "tags": ["Events"] } }, "/api/v1/admin/events/{eventId}/revisions/pending": { @@ -6151,9 +5871,7 @@ } ], "summary": "Get pending revision for any live event", - "tags": [ - "Admin - Events" - ] + "tags": ["Admin - Events"] } }, "/api/v1/admin/events/{eventId}/revisions/{revisionId}/approve": { @@ -6195,9 +5913,7 @@ } ], "summary": "Approve a pending revision and apply it to the live event immediately (no host confirm)", - "tags": [ - "Admin - Events" - ] + "tags": ["Admin - Events"] } }, "/api/v1/admin/events/{eventId}/revisions/{revisionId}/reject": { @@ -6249,9 +5965,7 @@ } ], "summary": "Reject a pending revision; live event content stays unchanged", - "tags": [ - "Admin - Events" - ] + "tags": ["Admin - Events"] } }, "/api/v1/admin/events": { @@ -6314,10 +6028,7 @@ "description": "0 = JSON list (default). 1 = Excel export (returns response.fileData).", "schema": { "type": "number", - "enum": [ - 0, - 1 - ] + "enum": [0, 1] } } ], @@ -6341,10 +6052,7 @@ "description": "Pagination metadata for the current query." } }, - "required": [ - "items", - "response" - ] + "required": ["items", "response"] } } } @@ -6356,9 +6064,7 @@ } ], "summary": "Paginated admin events list", - "tags": [ - "Admin - Events" - ] + "tags": ["Admin - Events"] }, "post": { "description": "Requires a verified host `organizerId`. Creates a draft with `admin_approved_at` set so the host can publish immediately; does not publish. Notifies the host (SMS + in-app) via `event_created_by_admin`.", @@ -6392,9 +6098,7 @@ } ], "summary": "Create a pre-approved draft event for a verified host", - "tags": [ - "Admin - Events" - ] + "tags": ["Admin - Events"] } }, "/api/v1/admin/events/{id}": { @@ -6428,9 +6132,7 @@ } ], "summary": "Admin event detail including bookmark count", - "tags": [ - "Admin - Events" - ] + "tags": ["Admin - Events"] }, "patch": { "operationId": "AdminEventsController_update", @@ -6472,9 +6174,7 @@ } ], "summary": "Update any event as admin (same field locks as host edit)", - "tags": [ - "Admin - Events" - ] + "tags": ["Admin - Events"] }, "delete": { "operationId": "AdminEventsController_softDelete", @@ -6506,9 +6206,7 @@ } ], "summary": "Soft-delete any event as admin when it has no active bookings (booked_count = 0)", - "tags": [ - "Admin - Events" - ] + "tags": ["Admin - Events"] } }, "/api/v1/admin/events/{id}/reserved-capacity": { @@ -6551,10 +6249,8 @@ "bearer": [] } ], - "summary": "Set off-platform reserved seat count as admin", - "tags": [ - "Admin - Events" - ] + "summary": "Set capacity and/or off-platform reserved seat count as admin", + "tags": ["Admin - Events"] } }, "/api/v1/admin/events/{id}/commission": { @@ -6599,9 +6295,7 @@ } ], "summary": "Set or clear this event’s platform commission override", - "tags": [ - "Admin - Events" - ] + "tags": ["Admin - Events"] } }, "/api/v1/admin/events/{id}/insights": { @@ -6635,9 +6329,7 @@ } ], "summary": "Get engagement insights for any event as admin", - "tags": [ - "Admin - Events" - ] + "tags": ["Admin - Events"] } }, "/api/v1/admin/events/{id}/approve": { @@ -6671,9 +6363,7 @@ } ], "summary": "Approve a draft or pending-review event; publishes once the host has also requested publication", - "tags": [ - "Admin - Events" - ] + "tags": ["Admin - Events"] } }, "/api/v1/admin/events/{id}/publish": { @@ -6707,9 +6397,7 @@ } ], "summary": "Force-publish any organizer’s draft or pending-review event as admin, bypassing the request/approve flow entirely", - "tags": [ - "Admin - Events" - ] + "tags": ["Admin - Events"] } }, "/api/v1/admin/events/{id}/reject": { @@ -6753,9 +6441,7 @@ } ], "summary": "Reject a pending-review event with a reason", - "tags": [ - "Admin - Events" - ] + "tags": ["Admin - Events"] } }, "/api/v1/admin/events/{id}/cancel": { @@ -6789,9 +6475,7 @@ } ], "summary": "Cancel any organizer’s published/full event as admin", - "tags": [ - "Admin - Events" - ] + "tags": ["Admin - Events"] } }, "/api/v1/admin/events/{id}/complete": { @@ -6825,13 +6509,12 @@ } ], "summary": "Mark any organizer’s event completed as admin", - "tags": [ - "Admin - Events" - ] + "tags": ["Admin - Events"] } }, "/api/v1/discovery/cities": { "get": { + "description": "Preferred consumer city list (includes `id`, `name`, `slug`, `provinceId`). Same CityResponseDto payload as GET /geography/cities. Android / mobile clients should use this endpoint for pickers and city pages keyed by id; prefer id over slug navigation.", "operationId": "DiscoveryBootstrapController_listCities", "parameters": [], "responses": { @@ -6850,9 +6533,7 @@ } }, "summary": "Cached city list for discovery/home", - "tags": [ - "Events" - ] + "tags": ["Events"] } }, "/api/v1/discovery/categories": { @@ -6875,9 +6556,7 @@ } }, "summary": "Cached active category tree summary for discovery/home", - "tags": [ - "Events" - ] + "tags": ["Events"] } }, "/api/v1/discovery/home-feed": { @@ -6907,9 +6586,7 @@ } }, "summary": "Home page event sections (popular, category previews, city previews)", - "tags": [ - "Events" - ] + "tags": ["Events"] } }, "/api/v1/discovery/bootstrap": { @@ -6930,9 +6607,7 @@ } }, "summary": "Legacy combined reference data for event discovery", - "tags": [ - "Events" - ] + "tags": ["Events"] } }, "/api/v1/organizers/me/following": { @@ -6993,10 +6668,7 @@ "description": "0 = JSON list (default). 1 = Excel export (returns response.fileData).", "schema": { "type": "number", - "enum": [ - 0, - 1 - ] + "enum": [0, 1] } }, { @@ -7029,10 +6701,7 @@ "description": "Pagination metadata for the current query." } }, - "required": [ - "items", - "response" - ] + "required": ["items", "response"] } } } @@ -7044,9 +6713,7 @@ } ], "summary": "Get organizers followed by current user", - "tags": [ - "Organizer Follows" - ] + "tags": ["Organizer Follows"] } }, "/api/v1/organizers/me/following/events": { @@ -7107,10 +6774,7 @@ "description": "0 = JSON list (default). 1 = Excel export (returns response.fileData).", "schema": { "type": "number", - "enum": [ - 0, - 1 - ] + "enum": [0, 1] } } ], @@ -7134,10 +6798,7 @@ "description": "Pagination metadata for the current query." } }, - "required": [ - "items", - "response" - ] + "required": ["items", "response"] } } } @@ -7149,9 +6810,7 @@ } ], "summary": "Get upcoming events from followed organizers", - "tags": [ - "Organizer Follows" - ] + "tags": ["Organizer Follows"] } }, "/api/v1/organizers/me/followers": { @@ -7212,10 +6871,7 @@ "description": "0 = JSON list (default). 1 = Excel export (returns response.fileData).", "schema": { "type": "number", - "enum": [ - 0, - 1 - ] + "enum": [0, 1] } } ], @@ -7239,10 +6895,7 @@ "description": "Pagination metadata for the current query." } }, - "required": [ - "items", - "response" - ] + "required": ["items", "response"] } } } @@ -7254,9 +6907,7 @@ } ], "summary": "Get followers of the current user (as organizer)", - "tags": [ - "Organizer Follows" - ] + "tags": ["Organizer Follows"] } }, "/api/v1/organizers/{organizerId}/follow": { @@ -7352,9 +7003,7 @@ } ], "summary": "Follow an organizer", - "tags": [ - "Organizer Follows" - ] + "tags": ["Organizer Follows"] }, "delete": { "operationId": "OrganizerFollowsController_unfollow", @@ -7438,9 +7087,7 @@ } ], "summary": "Unfollow an organizer", - "tags": [ - "Organizer Follows" - ] + "tags": ["Organizer Follows"] } }, "/api/v1/organizers/{organizerId}/followers": { @@ -7511,10 +7158,7 @@ "description": "0 = JSON list (default). 1 = Excel export (returns response.fileData).", "schema": { "type": "number", - "enum": [ - 0, - 1 - ] + "enum": [0, 1] } } ], @@ -7538,19 +7182,14 @@ "description": "Pagination metadata for the current query." } }, - "required": [ - "items", - "response" - ] + "required": ["items", "response"] } } } } }, "summary": "Get followers of an organizer", - "tags": [ - "Organizer Follows" - ] + "tags": ["Organizer Follows"] } }, "/api/v1/organizers/{organizerId}/is-following": { @@ -7592,9 +7231,7 @@ } ], "summary": "Check if current user is following an organizer", - "tags": [ - "Organizer Follows" - ] + "tags": ["Organizer Follows"] } }, "/api/v1/organizers/{organizerId}/follow-settings": { @@ -7640,9 +7277,7 @@ } ], "summary": "Update follow notification settings", - "tags": [ - "Organizer Follows" - ] + "tags": ["Organizer Follows"] } }, "/api/v1/events/{eventId}/media": { @@ -7674,9 +7309,7 @@ } }, "summary": "List media for an event (unpaginated)", - "tags": [ - "Event Extras" - ] + "tags": ["Event Extras"] }, "post": { "operationId": "EventMediaController_create", @@ -7718,9 +7351,7 @@ } ], "summary": "Add media to own event (or any event as admin)", - "tags": [ - "Event Extras" - ] + "tags": ["Event Extras"] } }, "/api/v1/events/{eventId}/media/{id}": { @@ -7772,9 +7403,7 @@ } ], "summary": "Update event media (owner or admin)", - "tags": [ - "Event Extras" - ] + "tags": ["Event Extras"] }, "delete": { "operationId": "EventMediaController_remove", @@ -7814,9 +7443,7 @@ } ], "summary": "Remove event media (owner or admin)", - "tags": [ - "Event Extras" - ] + "tags": ["Event Extras"] } }, "/api/v1/events/{eventId}/faqs": { @@ -7848,9 +7475,7 @@ } }, "summary": "List FAQs for an event (unpaginated)", - "tags": [ - "Event Extras" - ] + "tags": ["Event Extras"] }, "post": { "operationId": "EventFaqsController_create", @@ -7892,9 +7517,7 @@ } ], "summary": "Add FAQ to own event (or any event as admin)", - "tags": [ - "Event Extras" - ] + "tags": ["Event Extras"] } }, "/api/v1/events/{eventId}/faqs/page": { @@ -7961,10 +7584,7 @@ "description": "0 = JSON list (default). 1 = Excel export (returns response.fileData).", "schema": { "type": "number", - "enum": [ - 0, - 1 - ] + "enum": [0, 1] } } ], @@ -7988,19 +7608,14 @@ "description": "Pagination metadata for the current query." } }, - "required": [ - "items", - "response" - ] + "required": ["items", "response"] } } } } }, "summary": "Paginated FAQs for an event", - "tags": [ - "Event Extras" - ] + "tags": ["Event Extras"] } }, "/api/v1/events/{eventId}/faqs/{id}": { @@ -8052,9 +7667,7 @@ } ], "summary": "Update event FAQ (owner or admin)", - "tags": [ - "Event Extras" - ] + "tags": ["Event Extras"] }, "delete": { "operationId": "EventFaqsController_remove", @@ -8094,9 +7707,7 @@ } ], "summary": "Remove event FAQ (owner or admin)", - "tags": [ - "Event Extras" - ] + "tags": ["Event Extras"] } }, "/api/v1/organizer-guest-lists/previous-attendees": { @@ -8124,9 +7735,7 @@ } ], "summary": "Organizer's deduplicated checked-in attendees", - "tags": [ - "Event Extras" - ] + "tags": ["Event Extras"] } }, "/api/v1/organizer-guest-lists": { @@ -8185,10 +7794,7 @@ "description": "0 = JSON list (default). 1 = Excel export (returns response.fileData).", "schema": { "type": "number", - "enum": [ - 0, - 1 - ] + "enum": [0, 1] } } ], @@ -8212,10 +7818,7 @@ "description": "Pagination metadata for the current query." } }, - "required": [ - "items", - "response" - ] + "required": ["items", "response"] } } } @@ -8227,9 +7830,7 @@ } ], "summary": "Organizer's own guest lists (paginated)", - "tags": [ - "Event Extras" - ] + "tags": ["Event Extras"] }, "post": { "operationId": "OrganizerGuestListsController_create", @@ -8262,9 +7863,7 @@ } ], "summary": "Create a guest list", - "tags": [ - "Event Extras" - ] + "tags": ["Event Extras"] } }, "/api/v1/organizer-guest-lists/{id}": { @@ -8299,9 +7898,7 @@ } ], "summary": "Soft-delete a whole guest list", - "tags": [ - "Event Extras" - ] + "tags": ["Event Extras"] } }, "/api/v1/organizer-guest-lists/{id}/items": { @@ -8370,10 +7967,7 @@ "description": "0 = JSON list (default). 1 = Excel export (returns response.fileData).", "schema": { "type": "number", - "enum": [ - 0, - 1 - ] + "enum": [0, 1] } } ], @@ -8397,10 +7991,7 @@ "description": "Pagination metadata for the current query." } }, - "required": [ - "items", - "response" - ] + "required": ["items", "response"] } } } @@ -8412,9 +8003,7 @@ } ], "summary": "A guest list's contacts (paginated)", - "tags": [ - "Event Extras" - ] + "tags": ["Event Extras"] }, "post": { "operationId": "OrganizerGuestListsController_addItem", @@ -8457,9 +8046,7 @@ } ], "summary": "Add a contact to a guest list", - "tags": [ - "Event Extras" - ] + "tags": ["Event Extras"] } }, "/api/v1/organizer-guest-lists/{id}/items/{itemId}": { @@ -8503,9 +8090,7 @@ } ], "summary": "Remove a contact from a guest list", - "tags": [ - "Event Extras" - ] + "tags": ["Event Extras"] } }, "/api/v1/events/{eventId}/guest-list-links/invited-guests": { @@ -8550,9 +8135,7 @@ } ], "summary": "Set previous attendees invited to this event", - "tags": [ - "Event Extras" - ] + "tags": ["Event Extras"] } }, "/api/v1/events/{eventId}/guest-list-links/invited-guests/page": { @@ -8619,10 +8202,7 @@ "description": "0 = JSON list (default). 1 = Excel export (returns response.fileData).", "schema": { "type": "number", - "enum": [ - 0, - 1 - ] + "enum": [0, 1] } } ], @@ -8646,10 +8226,7 @@ "description": "Pagination metadata for the current query." } }, - "required": [ - "items", - "response" - ] + "required": ["items", "response"] } } } @@ -8661,9 +8238,7 @@ } ], "summary": "Paginated guests selected to invite to this event", - "tags": [ - "Event Extras" - ] + "tags": ["Event Extras"] } }, "/api/v1/events/{eventId}/guest-list-links/invited-guests/notify": { @@ -8698,9 +8273,7 @@ } ], "summary": "Send invitation notifications for the event invite set", - "tags": [ - "Event Extras" - ] + "tags": ["Event Extras"] } }, "/api/v1/events/{eventId}/guest-list-links/page": { @@ -8767,10 +8340,7 @@ "description": "0 = JSON list (default). 1 = Excel export (returns response.fileData).", "schema": { "type": "number", - "enum": [ - 0, - 1 - ] + "enum": [0, 1] } } ], @@ -8794,10 +8364,7 @@ "description": "Pagination metadata for the current query." } }, - "required": [ - "items", - "response" - ] + "required": ["items", "response"] } } } @@ -8809,9 +8376,7 @@ } ], "summary": "Paginated guest lists linked to this event", - "tags": [ - "Event Extras" - ] + "tags": ["Event Extras"] } }, "/api/v1/events/{eventId}/guest-list-links": { @@ -8856,9 +8421,7 @@ } ], "summary": "Attach a guest list to an event (stores link only — call notify to send invitations)", - "tags": [ - "Event Extras" - ] + "tags": ["Event Extras"] } }, "/api/v1/events/{eventId}/guest-list-links/{listId}/notify": { @@ -8902,9 +8465,7 @@ } ], "summary": "Send invitation notifications for a guest list linked to this event", - "tags": [ - "Event Extras" - ] + "tags": ["Event Extras"] } }, "/api/v1/events/{eventId}/guest-list-links/{listId}": { @@ -8948,9 +8509,7 @@ } ], "summary": "Unlink a guest list from an event", - "tags": [ - "Event Extras" - ] + "tags": ["Event Extras"] } }, "/api/v1/admin/guest-lists": { @@ -9010,10 +8569,7 @@ "description": "0 = JSON list (default). 1 = Excel export (returns response.fileData).", "schema": { "type": "number", - "enum": [ - 0, - 1 - ] + "enum": [0, 1] } } ], @@ -9037,10 +8593,7 @@ "description": "Pagination metadata for the current query." } }, - "required": [ - "items", - "response" - ] + "required": ["items", "response"] } } } @@ -9052,9 +8605,7 @@ } ], "summary": "Every organizer's guest lists (paginated)", - "tags": [ - "Admin - Event Extras" - ] + "tags": ["Admin - Event Extras"] } }, "/api/v1/admin/guest-lists/{id}/items": { @@ -9122,10 +8673,7 @@ "description": "0 = JSON list (default). 1 = Excel export (returns response.fileData).", "schema": { "type": "number", - "enum": [ - 0, - 1 - ] + "enum": [0, 1] } } ], @@ -9149,10 +8697,7 @@ "description": "Pagination metadata for the current query." } }, - "required": [ - "items", - "response" - ] + "required": ["items", "response"] } } } @@ -9164,9 +8709,7 @@ } ], "summary": "Any guest list's contacts, admin view (paginated)", - "tags": [ - "Admin - Event Extras" - ] + "tags": ["Admin - Event Extras"] } }, "/api/v1/admin/events/{eventId}/guest-list-links": { @@ -9205,9 +8748,7 @@ } ], "summary": "Guest lists linked to any event, admin view (unpaginated)", - "tags": [ - "Admin - Event Extras" - ] + "tags": ["Admin - Event Extras"] } }, "/api/v1/admin/events/{eventId}/invited-guests": { @@ -9246,9 +8787,7 @@ } ], "summary": "Guests selected to invite to this event (unpaginated)", - "tags": [ - "Admin - Event Extras" - ] + "tags": ["Admin - Event Extras"] }, "put": { "description": "userIds must all be existing platform users. Full replace, not incremental. An empty array clears the invite set. Does not send notifications — use POST .../notify.", @@ -9295,9 +8834,7 @@ } ], "summary": "Replace the invite set for this event", - "tags": [ - "Admin - Event Extras" - ] + "tags": ["Admin - Event Extras"] } }, "/api/v1/admin/events/{eventId}/invited-guests/notify": { @@ -9333,9 +8870,7 @@ } ], "summary": "Send invitation notifications to the event invite set", - "tags": [ - "Admin - Event Extras" - ] + "tags": ["Admin - Event Extras"] } }, "/api/v1/bookings/{bookingId}/payments": { @@ -9379,9 +8914,7 @@ } ], "summary": "Create payment attempt for a booking", - "tags": [ - "Financial" - ] + "tags": ["Financial"] } }, "/api/v1/bookings/{bookingId}/discount-preview": { @@ -9425,9 +8958,7 @@ } ], "summary": "Preview a discount code against a booking", - "tags": [ - "Financial" - ] + "tags": ["Financial"] } }, "/api/v1/payments/me": { @@ -9486,10 +9017,7 @@ "description": "0 = JSON list (default). 1 = Excel export (returns response.fileData).", "schema": { "type": "number", - "enum": [ - 0, - 1 - ] + "enum": [0, 1] } } ], @@ -9513,10 +9041,7 @@ "description": "Pagination metadata for the current query." } }, - "required": [ - "items", - "response" - ] + "required": ["items", "response"] } } } @@ -9528,9 +9053,7 @@ } ], "summary": "Current user's payments", - "tags": [ - "Financial" - ] + "tags": ["Financial"] } }, "/api/v1/payments/{id}/receipt": { @@ -9564,9 +9087,7 @@ } ], "summary": "Payment receipt (owner only)", - "tags": [ - "Financial" - ] + "tags": ["Financial"] } }, "/api/v1/admin/payments": { @@ -9625,10 +9146,7 @@ "description": "0 = JSON list (default). 1 = Excel export (returns response.fileData).", "schema": { "type": "number", - "enum": [ - 0, - 1 - ] + "enum": [0, 1] } } ], @@ -9652,10 +9170,7 @@ "description": "Pagination metadata for the current query." } }, - "required": [ - "items", - "response" - ] + "required": ["items", "response"] } } } @@ -9667,9 +9182,7 @@ } ], "summary": "Paginated admin payment list, all users", - "tags": [ - "Financial" - ] + "tags": ["Financial"] } }, "/api/v1/admin/wallet-deposits": { @@ -9728,10 +9241,7 @@ "description": "0 = JSON list (default). 1 = Excel export (returns response.fileData).", "schema": { "type": "number", - "enum": [ - 0, - 1 - ] + "enum": [0, 1] } } ], @@ -9755,10 +9265,7 @@ "description": "Pagination metadata for the current query." } }, - "required": [ - "items", - "response" - ] + "required": ["items", "response"] } } } @@ -9770,9 +9277,7 @@ } ], "summary": "Paginated admin wallet deposit list (gateway sessions)", - "tags": [ - "Financial" - ] + "tags": ["Financial"] } }, "/api/v1/users/me/wallet": { @@ -9797,9 +9302,7 @@ } ], "summary": "Current user's wallet", - "tags": [ - "Financial" - ] + "tags": ["Financial"] } }, "/api/v1/users/me/wallet/transactions": { @@ -9858,10 +9361,7 @@ "description": "0 = JSON list (default). 1 = Excel export (returns response.fileData).", "schema": { "type": "number", - "enum": [ - 0, - 1 - ] + "enum": [0, 1] } } ], @@ -9885,10 +9385,7 @@ "description": "Pagination metadata for the current query." } }, - "required": [ - "items", - "response" - ] + "required": ["items", "response"] } } } @@ -9900,9 +9397,7 @@ } ], "summary": "Current user's wallet transactions", - "tags": [ - "Financial" - ] + "tags": ["Financial"] } }, "/api/v1/users/me/wallet/deposits": { @@ -9937,9 +9432,7 @@ } ], "summary": "Start a wallet top-up via payment gateway", - "tags": [ - "Financial" - ] + "tags": ["Financial"] } }, "/api/v1/users/me/wallet/deposits/{id}": { @@ -9973,9 +9466,7 @@ } ], "summary": "Get one of the current user wallet deposits", - "tags": [ - "Financial" - ] + "tags": ["Financial"] } }, "/api/v1/wallet/deposits/{id}/gateway-return": { @@ -10006,9 +9497,7 @@ } }, "summary": "Jibit browser return (GET) — verifies payment server-side then redirects to the frontend result page", - "tags": [ - "Financial" - ] + "tags": ["Financial"] }, "post": { "operationId": "WalletController_depositGatewayReturnPost", @@ -10037,9 +9526,7 @@ } }, "summary": "Jibit browser return (form POST from PPG) — verifies payment server-side then redirects to the frontend result page", - "tags": [ - "Financial" - ] + "tags": ["Financial"] } }, "/api/v1/wallet/deposits/{id}/gateway-callback": { @@ -10078,9 +9565,7 @@ } }, "summary": "Console/dev HMAC callback for wallet deposits (disabled when PAYMENT_GATEWAY_PROVIDER=jibit)", - "tags": [ - "Financial" - ] + "tags": ["Financial"] } }, "/api/v1/bank-accounts": { @@ -10115,9 +9600,7 @@ } ], "summary": "Create bank account for withdrawals/settlements", - "tags": [ - "Financial" - ] + "tags": ["Financial"] } }, "/api/v1/bank-accounts/me": { @@ -10145,9 +9628,7 @@ } ], "summary": "Current user's bank accounts", - "tags": [ - "Financial" - ] + "tags": ["Financial"] } }, "/api/v1/admin/bank-accounts": { @@ -10206,10 +9687,7 @@ "description": "0 = JSON list (default). 1 = Excel export (returns response.fileData).", "schema": { "type": "number", - "enum": [ - 0, - 1 - ] + "enum": [0, 1] } } ], @@ -10233,10 +9711,7 @@ "description": "Pagination metadata for the current query." } }, - "required": [ - "items", - "response" - ] + "required": ["items", "response"] } } } @@ -10248,9 +9723,7 @@ } ], "summary": "Paginated admin bank account verification queue", - "tags": [ - "Financial" - ] + "tags": ["Financial"] } }, "/api/v1/admin/bank-accounts/{id}/jibit-inquiry": { @@ -10285,9 +9758,7 @@ } ], "summary": "Run Jibit IBAN/national-code/birth-date matching inquiry", - "tags": [ - "Financial" - ] + "tags": ["Financial"] } }, "/api/v1/admin/bank-accounts/{id}/approve": { @@ -10321,9 +9792,7 @@ } ], "summary": "Approve bank account after a successful Jibit match", - "tags": [ - "Financial" - ] + "tags": ["Financial"] } }, "/api/v1/admin/bank-accounts/{id}/reject": { @@ -10367,9 +9836,7 @@ } ], "summary": "Reject bank account with a reason", - "tags": [ - "Financial" - ] + "tags": ["Financial"] } }, "/api/v1/withdrawal-requests": { @@ -10404,9 +9871,7 @@ } ], "summary": "Create withdrawal request from wallet", - "tags": [ - "Financial" - ] + "tags": ["Financial"] } }, "/api/v1/withdrawal-requests/me": { @@ -10465,10 +9930,7 @@ "description": "0 = JSON list (default). 1 = Excel export (returns response.fileData).", "schema": { "type": "number", - "enum": [ - 0, - 1 - ] + "enum": [0, 1] } } ], @@ -10492,10 +9954,7 @@ "description": "Pagination metadata for the current query." } }, - "required": [ - "items", - "response" - ] + "required": ["items", "response"] } } } @@ -10507,9 +9966,7 @@ } ], "summary": "Current user's withdrawal requests", - "tags": [ - "Financial" - ] + "tags": ["Financial"] } }, "/api/v1/admin/withdrawal-requests": { @@ -10568,10 +10025,7 @@ "description": "0 = JSON list (default). 1 = Excel export (returns response.fileData).", "schema": { "type": "number", - "enum": [ - 0, - 1 - ] + "enum": [0, 1] } } ], @@ -10595,10 +10049,7 @@ "description": "Pagination metadata for the current query." } }, - "required": [ - "items", - "response" - ] + "required": ["items", "response"] } } } @@ -10610,9 +10061,7 @@ } ], "summary": "Paginated admin withdrawal queue", - "tags": [ - "Financial" - ] + "tags": ["Financial"] } }, "/api/v1/admin/withdrawal-requests/{id}/process": { @@ -10646,9 +10095,7 @@ } ], "summary": "Mark withdrawal request as processing", - "tags": [ - "Financial" - ] + "tags": ["Financial"] } }, "/api/v1/admin/withdrawal-requests/{id}/complete": { @@ -10692,9 +10139,7 @@ } ], "summary": "Complete withdrawal with manual payment evidence", - "tags": [ - "Financial" - ] + "tags": ["Financial"] } }, "/api/v1/admin/withdrawal-requests/{id}/reject": { @@ -10738,9 +10183,7 @@ } ], "summary": "Reject withdrawal request and reverse hold", - "tags": [ - "Financial" - ] + "tags": ["Financial"] } }, "/api/v1/organizers/me/earnings": { @@ -10799,10 +10242,7 @@ "description": "0 = JSON list (default). 1 = Excel export (returns response.fileData).", "schema": { "type": "number", - "enum": [ - 0, - 1 - ] + "enum": [0, 1] } } ], @@ -10826,10 +10266,7 @@ "description": "Pagination metadata for the current query." } }, - "required": [ - "items", - "response" - ] + "required": ["items", "response"] } } } @@ -10841,9 +10278,7 @@ } ], "summary": "Current organizer's earnings ledger", - "tags": [ - "Financial" - ] + "tags": ["Financial"] } }, "/api/v1/settlements/me": { @@ -10902,10 +10337,7 @@ "description": "0 = JSON list (default). 1 = Excel export (returns response.fileData).", "schema": { "type": "number", - "enum": [ - 0, - 1 - ] + "enum": [0, 1] } } ], @@ -10929,10 +10361,7 @@ "description": "Pagination metadata for the current query." } }, - "required": [ - "items", - "response" - ] + "required": ["items", "response"] } } } @@ -10944,9 +10373,7 @@ } ], "summary": "Current organizer's settlement batches", - "tags": [ - "Financial" - ] + "tags": ["Financial"] } }, "/api/v1/admin/settlements": { @@ -10981,9 +10408,7 @@ } ], "summary": "Create organizer settlement batch", - "tags": [ - "Financial" - ] + "tags": ["Financial"] }, "get": { "operationId": "AdminSettlementsController_list", @@ -11040,10 +10465,7 @@ "description": "0 = JSON list (default). 1 = Excel export (returns response.fileData).", "schema": { "type": "number", - "enum": [ - 0, - 1 - ] + "enum": [0, 1] } } ], @@ -11067,10 +10489,7 @@ "description": "Pagination metadata for the current query." } }, - "required": [ - "items", - "response" - ] + "required": ["items", "response"] } } } @@ -11082,9 +10501,7 @@ } ], "summary": "Paginated settlement batches", - "tags": [ - "Financial" - ] + "tags": ["Financial"] } }, "/api/v1/admin/settlements/{id}": { @@ -11119,9 +10536,7 @@ } ], "summary": "Settlement batch detail, with items inlined", - "tags": [ - "Financial" - ] + "tags": ["Financial"] } }, "/api/v1/admin/settlements/{id}/process": { @@ -11155,9 +10570,7 @@ } ], "summary": "Mark settlement batch as processing", - "tags": [ - "Financial" - ] + "tags": ["Financial"] } }, "/api/v1/admin/settlements/{id}/complete": { @@ -11201,9 +10614,7 @@ } ], "summary": "Complete settlement with manual payment evidence", - "tags": [ - "Financial" - ] + "tags": ["Financial"] } }, "/api/v1/admin/settlements/{id}/fail": { @@ -11248,9 +10659,7 @@ } ], "summary": "Mark settlement batch as failed and release its earnings", - "tags": [ - "Financial" - ] + "tags": ["Financial"] } }, "/api/v1/events/{eventId}/discount-codes": { @@ -11295,9 +10704,7 @@ } ], "summary": "Bulk-create discount codes for an event (host or admin)", - "tags": [ - "Discount Codes" - ] + "tags": ["Discount Codes"] }, "get": { "operationId": "DiscountCodesController_list", @@ -11363,10 +10770,7 @@ "description": "0 = JSON list (default). 1 = Excel export (returns response.fileData).", "schema": { "type": "number", - "enum": [ - 0, - 1 - ] + "enum": [0, 1] } } ], @@ -11390,10 +10794,7 @@ "description": "Pagination metadata for the current query." } }, - "required": [ - "items", - "response" - ] + "required": ["items", "response"] } } } @@ -11405,9 +10806,7 @@ } ], "summary": "An event's discount codes (paginated)", - "tags": [ - "Discount Codes" - ] + "tags": ["Discount Codes"] } }, "/api/v1/events/{eventId}/discount-codes/management-bootstrap": { @@ -11441,9 +10840,7 @@ } ], "summary": "All initial data for an event's discount management tab", - "tags": [ - "Discount Codes" - ] + "tags": ["Discount Codes"] } }, "/api/v1/events/{eventId}/discount-codes/report": { @@ -11478,9 +10875,7 @@ } ], "summary": "Summary of an event's discount usage", - "tags": [ - "Discount Codes" - ] + "tags": ["Discount Codes"] } }, "/api/v1/events/{eventId}/discount-codes/redemptions": { @@ -11548,10 +10943,7 @@ "description": "0 = JSON list (default). 1 = Excel export (returns response.fileData).", "schema": { "type": "number", - "enum": [ - 0, - 1 - ] + "enum": [0, 1] } } ], @@ -11575,10 +10967,7 @@ "description": "Pagination metadata for the current query." } }, - "required": [ - "items", - "response" - ] + "required": ["items", "response"] } } } @@ -11590,9 +10979,7 @@ } ], "summary": "An event's discount redemptions (paginated)", - "tags": [ - "Discount Codes" - ] + "tags": ["Discount Codes"] } }, "/api/v1/discount-codes/{id}": { @@ -11637,9 +11024,7 @@ } ], "summary": "Enable/disable a discount code (host or admin)", - "tags": [ - "Discount Codes" - ] + "tags": ["Discount Codes"] }, "delete": { "operationId": "DiscountCodesController_remove", @@ -11672,9 +11057,7 @@ } ], "summary": "Delete an unused discount code (host or admin)", - "tags": [ - "Discount Codes" - ] + "tags": ["Discount Codes"] } }, "/api/v1/events/{eventId}/bookings": { @@ -11718,9 +11101,7 @@ } ], "summary": "Create a booking for an event", - "tags": [ - "Bookings" - ] + "tags": ["Bookings"] } }, "/api/v1/bookings/me": { @@ -11779,10 +11160,7 @@ "description": "0 = JSON list (default). 1 = Excel export (returns response.fileData).", "schema": { "type": "number", - "enum": [ - 0, - 1 - ] + "enum": [0, 1] } } ], @@ -11806,10 +11184,7 @@ "description": "Pagination metadata for the current query." } }, - "required": [ - "items", - "response" - ] + "required": ["items", "response"] } } } @@ -11821,9 +11196,7 @@ } ], "summary": "Current user's booking history", - "tags": [ - "Bookings" - ] + "tags": ["Bookings"] } }, "/api/v1/bookings/{id}": { @@ -11857,9 +11230,7 @@ } ], "summary": "Single booking detail (owner only)", - "tags": [ - "Bookings" - ] + "tags": ["Bookings"] } }, "/api/v1/bookings/{id}/cancel": { @@ -11904,9 +11275,7 @@ } ], "summary": "Cancel a booking (guest only)", - "tags": [ - "Bookings" - ] + "tags": ["Bookings"] } }, "/api/v1/bookings/{id}/check-in": { @@ -11940,9 +11309,7 @@ } ], "summary": "Check in a guest (event organizer only)", - "tags": [ - "Bookings" - ] + "tags": ["Bookings"] } }, "/api/v1/events/{eventId}/waitlist": { @@ -11986,9 +11353,7 @@ } ], "summary": "Join the waitlist for a full event", - "tags": [ - "Waitlist" - ] + "tags": ["Waitlist"] }, "get": { "operationId": "WaitlistController_listForEvent", @@ -12053,10 +11418,7 @@ "description": "0 = JSON list (default). 1 = Excel export (returns response.fileData).", "schema": { "type": "number", - "enum": [ - 0, - 1 - ] + "enum": [0, 1] } } ], @@ -12080,10 +11442,7 @@ "description": "Pagination metadata for the current query." } }, - "required": [ - "items", - "response" - ] + "required": ["items", "response"] } } } @@ -12095,9 +11454,7 @@ } ], "summary": "Host view of the waiting queue for their own event (used to hand-pick who gets a seat when settings.waitlistAutoOffer is false)", - "tags": [ - "Waitlist" - ] + "tags": ["Waitlist"] } }, "/api/v1/waitlist/me": { @@ -12156,10 +11513,7 @@ "description": "0 = JSON list (default). 1 = Excel export (returns response.fileData).", "schema": { "type": "number", - "enum": [ - 0, - 1 - ] + "enum": [0, 1] } } ], @@ -12183,10 +11537,7 @@ "description": "Pagination metadata for the current query." } }, - "required": [ - "items", - "response" - ] + "required": ["items", "response"] } } } @@ -12198,9 +11549,7 @@ } ], "summary": "Current user's waitlist entries", - "tags": [ - "Waitlist" - ] + "tags": ["Waitlist"] } }, "/api/v1/events/{eventId}/waitlist/{entryId}/offer": { @@ -12242,9 +11591,7 @@ } ], "summary": "Host manually offers an opened seat to a specific waitlist entry", - "tags": [ - "Waitlist" - ] + "tags": ["Waitlist"] } }, "/api/v1/waitlist/{id}/accept": { @@ -12278,9 +11625,7 @@ } ], "summary": "Accept a notified waitlist offer", - "tags": [ - "Waitlist" - ] + "tags": ["Waitlist"] } }, "/api/v1/admin/bookings": { @@ -12339,10 +11684,7 @@ "description": "0 = JSON list (default). 1 = Excel export (returns response.fileData).", "schema": { "type": "number", - "enum": [ - 0, - 1 - ] + "enum": [0, 1] } } ], @@ -12366,10 +11708,7 @@ "description": "Pagination metadata for the current query." } }, - "required": [ - "items", - "response" - ] + "required": ["items", "response"] } } } @@ -12381,9 +11720,7 @@ } ], "summary": "Paginated admin bookings list", - "tags": [ - "Admin - Bookings" - ] + "tags": ["Admin - Bookings"] } }, "/api/v1/admin/bookings/{id}/check-in": { @@ -12417,9 +11754,7 @@ } ], "summary": "Check in a guest for any organizer’s event as admin", - "tags": [ - "Admin - Bookings" - ] + "tags": ["Admin - Bookings"] } }, "/api/v1/events/{eventId}/reviews": { @@ -12491,10 +11826,7 @@ "description": "0 = JSON list (default). 1 = Excel export (returns response.fileData).", "schema": { "type": "number", - "enum": [ - 0, - 1 - ] + "enum": [0, 1] } }, { @@ -12528,10 +11860,7 @@ "description": "Pagination metadata for the current query." } }, - "required": [ - "items", - "response" - ] + "required": ["items", "response"] } } } @@ -12578,9 +11907,7 @@ } }, "summary": "List published reviews for an event", - "tags": [ - "Reviews" - ] + "tags": ["Reviews"] }, "post": { "description": "Authenticated guests with a confirmed booking may review once after the event is completed.", @@ -12685,9 +12012,7 @@ } ], "summary": "Create a review for a completed event", - "tags": [ - "Reviews" - ] + "tags": ["Reviews"] } }, "/api/v1/users/{userId}/reviews": { @@ -12759,10 +12084,7 @@ "description": "0 = JSON list (default). 1 = Excel export (returns response.fileData).", "schema": { "type": "number", - "enum": [ - 0, - 1 - ] + "enum": [0, 1] } } ], @@ -12786,10 +12108,7 @@ "description": "Pagination metadata for the current query." } }, - "required": [ - "items", - "response" - ] + "required": ["items", "response"] } } } @@ -12836,9 +12155,7 @@ } }, "summary": "List published reviews for an organizer", - "tags": [ - "Reviews" - ] + "tags": ["Reviews"] } }, "/api/v1/reviews/{id}": { @@ -12945,9 +12262,7 @@ } ], "summary": "Update own review", - "tags": [ - "Reviews" - ] + "tags": ["Reviews"] } }, "/api/v1/reviews/{id}/host-reply": { @@ -13054,9 +12369,7 @@ } ], "summary": "Reply to a review as organizer", - "tags": [ - "Reviews" - ] + "tags": ["Reviews"] } }, "/api/v1/admin/reviews": { @@ -13118,10 +12431,7 @@ "description": "0 = JSON list (default). 1 = Excel export (returns response.fileData).", "schema": { "type": "number", - "enum": [ - 0, - 1 - ] + "enum": [0, 1] } }, { @@ -13172,10 +12482,7 @@ "description": "Pagination metadata for the current query." } }, - "required": [ - "items", - "response" - ] + "required": ["items", "response"] } } } @@ -13187,9 +12494,7 @@ } ], "summary": "Paginated review moderation list", - "tags": [ - "Admin - Reviews" - ] + "tags": ["Admin - Reviews"] } }, "/api/v1/admin/reviews/{id}/hide": { @@ -13285,9 +12590,7 @@ } ], "summary": "Hide a review from public view", - "tags": [ - "Admin - Reviews" - ] + "tags": ["Admin - Reviews"] } }, "/api/v1/admin/reviews/{id}/restore": { @@ -13383,9 +12686,7 @@ } ], "summary": "Restore a hidden review to published", - "tags": [ - "Admin - Reviews" - ] + "tags": ["Admin - Reviews"] } }, "/api/v1/admin/reviews/{id}": { @@ -13421,9 +12722,7 @@ } ], "summary": "Soft-delete a review", - "tags": [ - "Admin - Reviews" - ] + "tags": ["Admin - Reviews"] } }, "/api/v1/conversations/me/unread-count": { @@ -13499,9 +12798,7 @@ } ], "summary": "Get total unread message count", - "tags": [ - "Chat" - ] + "tags": ["Chat"] } }, "/api/v1/conversations/me": { @@ -13563,10 +12860,7 @@ "description": "0 = JSON list (default). 1 = Excel export (returns response.fileData).", "schema": { "type": "number", - "enum": [ - 0, - 1 - ] + "enum": [0, 1] } }, { @@ -13600,10 +12894,7 @@ "description": "Pagination metadata for the current query." } }, - "required": [ - "items", - "response" - ] + "required": ["items", "response"] } } } @@ -13665,9 +12956,7 @@ } ], "summary": "List my conversations", - "tags": [ - "Chat" - ] + "tags": ["Chat"] } }, "/api/v1/conversations/direct/{otherUserId}": { @@ -13764,9 +13053,7 @@ } ], "summary": "Get or create a direct conversation", - "tags": [ - "Chat" - ] + "tags": ["Chat"] } }, "/api/v1/conversations/direct/{otherUserId}/messages": { @@ -13873,9 +13160,7 @@ } ], "summary": "Send a direct message", - "tags": [ - "Chat" - ] + "tags": ["Chat"] } }, "/api/v1/conversations/{id}": { @@ -13972,9 +13257,7 @@ } ], "summary": "Get a conversation", - "tags": [ - "Chat" - ] + "tags": ["Chat"] } }, "/api/v1/conversations/{id}/participants": { @@ -14046,10 +13329,7 @@ "description": "0 = JSON list (default). 1 = Excel export (returns response.fileData).", "schema": { "type": "number", - "enum": [ - 0, - 1 - ] + "enum": [0, 1] } } ], @@ -14073,10 +13353,7 @@ "description": "Pagination metadata for the current query." } }, - "required": [ - "items", - "response" - ] + "required": ["items", "response"] } } } @@ -14148,9 +13425,7 @@ } ], "summary": "List conversation participants", - "tags": [ - "Chat" - ] + "tags": ["Chat"] } }, "/api/v1/conversations/{id}/read": { @@ -14257,9 +13532,7 @@ } ], "summary": "Mark conversation as read", - "tags": [ - "Chat" - ] + "tags": ["Chat"] } }, "/api/v1/conversations/{id}/messages": { @@ -14341,10 +13614,7 @@ "description": "Pagination metadata for the current query." } }, - "required": [ - "items", - "response" - ] + "required": ["items", "response"] } } } @@ -14416,9 +13686,7 @@ } ], "summary": "List messages in a conversation", - "tags": [ - "Chat" - ] + "tags": ["Chat"] }, "post": { "description": "Sends a message in an existing conversation (typically an event group chat).", @@ -14523,9 +13791,7 @@ } ], "summary": "Send a message in a conversation", - "tags": [ - "Chat" - ] + "tags": ["Chat"] } }, "/api/v1/admin/conversations": { @@ -14584,10 +13850,7 @@ "description": "0 = JSON list (default). 1 = Excel export (returns response.fileData).", "schema": { "type": "number", - "enum": [ - 0, - 1 - ] + "enum": [0, 1] } }, { @@ -14629,10 +13892,7 @@ "required": false, "in": "query", "schema": { - "enum": [ - "direct", - "event_group" - ], + "enum": ["direct", "event_group"], "type": "string" } } @@ -14657,10 +13917,7 @@ "description": "Pagination metadata for the current query." } }, - "required": [ - "items", - "response" - ] + "required": ["items", "response"] } } } @@ -14732,9 +13989,7 @@ } ], "summary": "List all conversations for read-only admin oversight", - "tags": [ - "Admin - Chat Oversight" - ] + "tags": ["Admin - Chat Oversight"] } }, "/api/v1/admin/conversations/{id}": { @@ -14829,9 +14084,7 @@ } ], "summary": "Get a conversation without joining or changing read state", - "tags": [ - "Admin - Chat Oversight" - ] + "tags": ["Admin - Chat Oversight"] } }, "/api/v1/admin/conversations/{id}/participants": { @@ -14899,10 +14152,7 @@ "description": "0 = JSON list (default). 1 = Excel export (returns response.fileData).", "schema": { "type": "number", - "enum": [ - 0, - 1 - ] + "enum": [0, 1] } } ], @@ -14926,10 +14176,7 @@ "description": "Pagination metadata for the current query." } }, - "required": [ - "items", - "response" - ] + "required": ["items", "response"] } } } @@ -15001,9 +14248,7 @@ } ], "summary": "List conversation participants for admin oversight", - "tags": [ - "Admin - Chat Oversight" - ] + "tags": ["Admin - Chat Oversight"] } }, "/api/v1/admin/conversations/{id}/messages": { @@ -15082,10 +14327,7 @@ "description": "Pagination metadata for the current query." } }, - "required": [ - "items", - "response" - ] + "required": ["items", "response"] } } } @@ -15157,9 +14399,7 @@ } ], "summary": "Read message history without joining or changing read state", - "tags": [ - "Admin - Chat Oversight" - ] + "tags": ["Admin - Chat Oversight"] } }, "/api/v1/contact-messages": { @@ -15210,9 +14450,7 @@ } }, "summary": "Submit a public contact message", - "tags": [ - "Contact Messages" - ] + "tags": ["Contact Messages"] } }, "/api/v1/admin/contact-messages": { @@ -15274,10 +14512,7 @@ "description": "0 = JSON list (default). 1 = Excel export (returns response.fileData).", "schema": { "type": "number", - "enum": [ - 0, - 1 - ] + "enum": [0, 1] } }, { @@ -15311,10 +14546,7 @@ "description": "Pagination metadata for the current query." } }, - "required": [ - "items", - "response" - ] + "required": ["items", "response"] } } } @@ -15386,9 +14618,7 @@ } ], "summary": "List contact form submissions", - "tags": [ - "Admin - Contact Messages" - ] + "tags": ["Admin - Contact Messages"] } }, "/api/v1/admin/contact-messages/{id}": { @@ -15485,9 +14715,7 @@ } ], "summary": "Get one contact message", - "tags": [ - "Admin - Contact Messages" - ] + "tags": ["Admin - Contact Messages"] } }, "/api/v1/admin/contact-messages/{id}/read": { @@ -15584,9 +14812,7 @@ } ], "summary": "Mark contact message as read", - "tags": [ - "Admin - Contact Messages" - ] + "tags": ["Admin - Contact Messages"] } }, "/api/v1/traffic-visits": { @@ -15640,9 +14866,7 @@ } }, "summary": "Record a unique attributed page visit", - "tags": [ - "Traffic Visits" - ] + "tags": ["Traffic Visits"] } }, "/api/v1/user-blocks": { @@ -15739,9 +14963,7 @@ } ], "summary": "Block another user", - "tags": [ - "User Blocks" - ] + "tags": ["User Blocks"] } }, "/api/v1/user-blocks/{blockedId}": { @@ -15829,9 +15051,7 @@ } ], "summary": "Unblock a user", - "tags": [ - "User Blocks" - ] + "tags": ["User Blocks"] } }, "/api/v1/user-blocks/me": { @@ -15893,10 +15113,7 @@ "description": "0 = JSON list (default). 1 = Excel export (returns response.fileData).", "schema": { "type": "number", - "enum": [ - 0, - 1 - ] + "enum": [0, 1] } }, { @@ -15930,10 +15147,7 @@ "description": "Pagination metadata for the current query." } }, - "required": [ - "items", - "response" - ] + "required": ["items", "response"] } } } @@ -15985,9 +15199,7 @@ } ], "summary": "List users I have blocked", - "tags": [ - "User Blocks" - ] + "tags": ["User Blocks"] } }, "/api/v1/report-reasons": { @@ -16031,9 +15243,7 @@ } }, "summary": "List active report reasons", - "tags": [ - "User Reports" - ] + "tags": ["User Reports"] } }, "/api/v1/user-reports": { @@ -16120,9 +15330,7 @@ } ], "summary": "Report another user", - "tags": [ - "User Reports" - ] + "tags": ["User Reports"] } }, "/api/v1/admin/user-reports": { @@ -16184,10 +15392,7 @@ "description": "0 = JSON list (default). 1 = Excel export (returns response.fileData).", "schema": { "type": "number", - "enum": [ - 0, - 1 - ] + "enum": [0, 1] } }, { @@ -16241,10 +15446,7 @@ "description": "Pagination metadata for the current query." } }, - "required": [ - "items", - "response" - ] + "required": ["items", "response"] } } } @@ -16316,9 +15518,7 @@ } ], "summary": "List user report review queue", - "tags": [ - "Admin - User Reports" - ] + "tags": ["Admin - User Reports"] } }, "/api/v1/admin/user-reports/{id}/review": { @@ -16416,9 +15616,7 @@ } ], "summary": "Mark user report as reviewed", - "tags": [ - "Admin - User Reports" - ] + "tags": ["Admin - User Reports"] } }, "/api/v1/admin/user-reports/{id}/dismiss": { @@ -16516,9 +15714,7 @@ } ], "summary": "Dismiss user report", - "tags": [ - "Admin - User Reports" - ] + "tags": ["Admin - User Reports"] } }, "/api/v1/admin/user-reports/{id}/block": { @@ -16616,9 +15812,7 @@ } ], "summary": "Block reported user on the reporter's behalf", - "tags": [ - "Admin - User Reports" - ] + "tags": ["Admin - User Reports"] } }, "/api/v1/support-tickets": { @@ -16713,9 +15907,7 @@ } ], "summary": "Create a support ticket", - "tags": [ - "Support Tickets" - ] + "tags": ["Support Tickets"] } }, "/api/v1/support-tickets/me": { @@ -16774,10 +15966,7 @@ "description": "0 = JSON list (default). 1 = Excel export (returns response.fileData).", "schema": { "type": "number", - "enum": [ - 0, - 1 - ] + "enum": [0, 1] } } ], @@ -16801,10 +15990,7 @@ "description": "Pagination metadata for the current query." } }, - "required": [ - "items", - "response" - ] + "required": ["items", "response"] } } } @@ -16816,9 +16002,7 @@ } ], "summary": "List my support tickets", - "tags": [ - "Support Tickets" - ] + "tags": ["Support Tickets"] } }, "/api/v1/support-tickets/{id}/messages": { @@ -16877,10 +16061,7 @@ "description": "Pagination metadata for the current query." } }, - "required": [ - "items", - "response" - ] + "required": ["items", "response"] } } } @@ -16892,9 +16073,7 @@ } ], "summary": "List my support ticket messages", - "tags": [ - "Support Tickets" - ] + "tags": ["Support Tickets"] } }, "/api/v1/support-tickets/{id}": { @@ -16928,9 +16107,7 @@ } ], "summary": "Get my support ticket metadata", - "tags": [ - "Support Tickets" - ] + "tags": ["Support Tickets"] } }, "/api/v1/support-tickets/{id}/replies": { @@ -16974,9 +16151,7 @@ } ], "summary": "Reply to my support ticket", - "tags": [ - "Support Tickets" - ] + "tags": ["Support Tickets"] } }, "/api/v1/admin/support-tickets": { @@ -17035,10 +16210,7 @@ "description": "0 = JSON list (default). 1 = Excel export (returns response.fileData).", "schema": { "type": "number", - "enum": [ - 0, - 1 - ] + "enum": [0, 1] } } ], @@ -17062,10 +16234,7 @@ "description": "Pagination metadata for the current query." } }, - "required": [ - "items", - "response" - ] + "required": ["items", "response"] } } } @@ -17137,9 +16306,7 @@ } ], "summary": "List the support queue", - "tags": [ - "Admin - Support Tickets" - ] + "tags": ["Admin - Support Tickets"] } }, "/api/v1/admin/support-tickets/{id}": { @@ -17173,9 +16340,7 @@ } ], "summary": "Get a support ticket thread", - "tags": [ - "Admin - Support Tickets" - ] + "tags": ["Admin - Support Tickets"] } }, "/api/v1/admin/support-tickets/{id}/replies": { @@ -17219,9 +16384,7 @@ } ], "summary": "Reply as support and send the user an SMS", - "tags": [ - "Admin - Support Tickets" - ] + "tags": ["Admin - Support Tickets"] } }, "/api/v1/admin/support-tickets/{id}/status": { @@ -17265,9 +16428,7 @@ } ], "summary": "Change support ticket status", - "tags": [ - "Admin - Support Tickets" - ] + "tags": ["Admin - Support Tickets"] } }, "/api/v1/admin/reports/overview": { @@ -17353,9 +16514,7 @@ } ], "summary": "Platform-wide overview KPIs", - "tags": [ - "Admin - Reports" - ] + "tags": ["Admin - Reports"] } }, "/api/v1/admin/users/{id}/wallet/credit": { @@ -17460,9 +16619,7 @@ } ], "summary": "Manually credit a user wallet", - "tags": [ - "Admin - User Detail" - ] + "tags": ["Admin - User Detail"] } }, "/api/v1/admin/users/{id}/identity/attest": { @@ -17557,9 +16714,7 @@ } ], "summary": "Verify host identity without a user submission", - "tags": [ - "Admin - User Detail" - ] + "tags": ["Admin - User Detail"] } }, "/api/v1/admin/users/{id}/hosted-events": { @@ -17626,10 +16781,7 @@ "description": "0 = JSON list (default). 1 = Excel export (returns response.fileData).", "schema": { "type": "number", - "enum": [ - 0, - 1 - ] + "enum": [0, 1] } } ], @@ -17653,10 +16805,7 @@ "description": "Pagination metadata for the current query." } }, - "required": [ - "events", - "response" - ] + "required": ["events", "response"] } } } @@ -17728,9 +16877,7 @@ } ], "summary": "Events this user has hosted (organizer_id = :id)", - "tags": [ - "Admin - User Detail" - ] + "tags": ["Admin - User Detail"] } }, "/api/v1/admin/users/{id}/bookings": { @@ -17797,10 +16944,7 @@ "description": "0 = JSON list (default). 1 = Excel export (returns response.fileData).", "schema": { "type": "number", - "enum": [ - 0, - 1 - ] + "enum": [0, 1] } } ], @@ -17824,10 +16968,7 @@ "description": "Pagination metadata for the current query." } }, - "required": [ - "bookings", - "response" - ] + "required": ["bookings", "response"] } } } @@ -17899,9 +17040,7 @@ } ], "summary": "Bookings this user made as a guest", - "tags": [ - "Admin - User Detail" - ] + "tags": ["Admin - User Detail"] } }, "/api/v1/admin/users/{id}/payments": { @@ -17968,10 +17107,7 @@ "description": "0 = JSON list (default). 1 = Excel export (returns response.fileData).", "schema": { "type": "number", - "enum": [ - 0, - 1 - ] + "enum": [0, 1] } } ], @@ -17995,10 +17131,7 @@ "description": "Pagination metadata for the current query." } }, - "required": [ - "payments", - "response" - ] + "required": ["payments", "response"] } } } @@ -18070,9 +17203,7 @@ } ], "summary": "Payments this user made", - "tags": [ - "Admin - User Detail" - ] + "tags": ["Admin - User Detail"] } }, "/api/v1/admin/users/{id}/reviews": { @@ -18139,10 +17270,7 @@ "description": "0 = JSON list (default). 1 = Excel export (returns response.fileData).", "schema": { "type": "number", - "enum": [ - 0, - 1 - ] + "enum": [0, 1] } }, { @@ -18151,10 +17279,7 @@ "in": "query", "description": "written (default): authored by this user. received: on events this user organized.", "schema": { - "enum": [ - "written", - "received" - ], + "enum": ["written", "received"], "type": "string" } } @@ -18179,10 +17304,7 @@ "description": "Pagination metadata for the current query." } }, - "required": [ - "reviews", - "response" - ] + "required": ["reviews", "response"] } } } @@ -18254,9 +17376,7 @@ } ], "summary": "Reviews written by this user or received on their events", - "tags": [ - "Admin - User Detail" - ] + "tags": ["Admin - User Detail"] } }, "/api/v1/admin/users/{id}/follows": { @@ -18323,10 +17443,7 @@ "description": "0 = JSON list (default). 1 = Excel export (returns response.fileData).", "schema": { "type": "number", - "enum": [ - 0, - 1 - ] + "enum": [0, 1] } }, { @@ -18335,10 +17452,7 @@ "in": "query", "description": "following (default): organizers this user follows. followers: users following this user.", "schema": { - "enum": [ - "following", - "followers" - ], + "enum": ["following", "followers"], "type": "string" } } @@ -18363,10 +17477,7 @@ "description": "Pagination metadata for the current query." } }, - "required": [ - "follows", - "response" - ] + "required": ["follows", "response"] } } } @@ -18438,9 +17549,7 @@ } ], "summary": "Organizers this user follows, or users following this user", - "tags": [ - "Admin - User Detail" - ] + "tags": ["Admin - User Detail"] } }, "/api/v1/admin/users/{id}/reports": { @@ -18507,10 +17616,7 @@ "description": "0 = JSON list (default). 1 = Excel export (returns response.fileData).", "schema": { "type": "number", - "enum": [ - 0, - 1 - ] + "enum": [0, 1] } }, { @@ -18519,10 +17625,7 @@ "in": "query", "description": "filed (default): reports this user submitted. received: reports submitted about this user.", "schema": { - "enum": [ - "filed", - "received" - ], + "enum": ["filed", "received"], "type": "string" } } @@ -18547,10 +17650,7 @@ "description": "Pagination metadata for the current query." } }, - "required": [ - "reports", - "response" - ] + "required": ["reports", "response"] } } } @@ -18622,9 +17722,7 @@ } ], "summary": "User reports this user filed, or reports filed about them", - "tags": [ - "Admin - User Detail" - ] + "tags": ["Admin - User Detail"] } }, "/api/v1/admin/users/{id}/blocks": { @@ -18691,10 +17789,7 @@ "description": "0 = JSON list (default). 1 = Excel export (returns response.fileData).", "schema": { "type": "number", - "enum": [ - 0, - 1 - ] + "enum": [0, 1] } }, { @@ -18703,10 +17798,7 @@ "in": "query", "description": "blocking (default): users this user blocked. blockedBy: users who blocked this user.", "schema": { - "enum": [ - "blocking", - "blockedBy" - ], + "enum": ["blocking", "blockedBy"], "type": "string" } } @@ -18731,10 +17823,7 @@ "description": "Pagination metadata for the current query." } }, - "required": [ - "blocks", - "response" - ] + "required": ["blocks", "response"] } } } @@ -18806,9 +17895,7 @@ } ], "summary": "Users this user has blocked, or users who blocked this user", - "tags": [ - "Admin - User Detail" - ] + "tags": ["Admin - User Detail"] } }, "/api/v1/admin/audit-logs": { @@ -18870,10 +17957,7 @@ "description": "0 = JSON list (default). 1 = Excel export (returns response.fileData).", "schema": { "type": "number", - "enum": [ - 0, - 1 - ] + "enum": [0, 1] } }, { @@ -18925,10 +18009,7 @@ "description": "Pagination metadata for the current query." } }, - "required": [ - "items", - "response" - ] + "required": ["items", "response"] } } } @@ -19000,9 +18081,7 @@ } ], "summary": "List admin action audit trail", - "tags": [ - "Admin - Audit Logs" - ] + "tags": ["Admin - Audit Logs"] } }, "/api/v1/uploads": { @@ -19016,9 +18095,7 @@ "multipart/form-data": { "schema": { "type": "object", - "required": [ - "file" - ], + "required": ["file"], "properties": { "file": { "type": "string", @@ -19087,9 +18164,7 @@ } ], "summary": "Upload an image file", - "tags": [ - "Uploads" - ] + "tags": ["Uploads"] } }, "/api/v1/uploads/identity": { @@ -19102,9 +18177,7 @@ "multipart/form-data": { "schema": { "type": "object", - "required": [ - "file" - ], + "required": ["file"], "properties": { "file": { "type": "string", @@ -19133,9 +18206,7 @@ } ], "summary": "Upload a private identity document image", - "tags": [ - "Uploads" - ] + "tags": ["Uploads"] } }, "/api/v1/uploads/identity/{ownerId}/{filename}": { @@ -19190,9 +18261,7 @@ } ], "summary": "Read an authorized private identity document", - "tags": [ - "Uploads" - ] + "tags": ["Uploads"] } }, "/api/v1/uploads/internal": { @@ -19231,9 +18300,7 @@ "multipart/form-data": { "schema": { "type": "object", - "required": [ - "file" - ], + "required": ["file"], "properties": { "file": { "type": "string", @@ -19297,9 +18364,7 @@ } }, "summary": "Internal upload from trusted app instances", - "tags": [ - "Uploads" - ] + "tags": ["Uploads"] } }, "/api/v1/blog-articles/page": { @@ -19358,10 +18423,7 @@ "description": "0 = JSON list (default). 1 = Excel export (returns response.fileData).", "schema": { "type": "number", - "enum": [ - 0, - 1 - ] + "enum": [0, 1] } }, { @@ -19394,10 +18456,7 @@ "in": "query", "schema": { "type": "string", - "enum": [ - "true", - "false" - ] + "enum": ["true", "false"] } } ], @@ -19421,19 +18480,14 @@ "description": "Pagination metadata for the current query." } }, - "required": [ - "items", - "response" - ] + "required": ["items", "response"] } } } } }, "summary": "Paginated published blog articles", - "tags": [ - "Blog Articles" - ] + "tags": ["Blog Articles"] } }, "/api/v1/blog-articles/{slug}/related": { @@ -19474,9 +18528,7 @@ } }, "summary": "Related published articles by slug", - "tags": [ - "Blog Articles" - ] + "tags": ["Blog Articles"] } }, "/api/v1/blog-articles/{slug}": { @@ -19505,9 +18557,7 @@ } }, "summary": "Single published article by slug", - "tags": [ - "Blog Articles" - ] + "tags": ["Blog Articles"] } }, "/api/v1/admin/blog-articles": { @@ -19566,10 +18616,7 @@ "description": "0 = JSON list (default). 1 = Excel export (returns response.fileData).", "schema": { "type": "number", - "enum": [ - 0, - 1 - ] + "enum": [0, 1] } } ], @@ -19593,10 +18640,7 @@ "description": "Pagination metadata for the current query." } }, - "required": [ - "items", - "response" - ] + "required": ["items", "response"] } } } @@ -19608,9 +18652,7 @@ } ], "summary": "Paginated article management list", - "tags": [ - "Admin - Blog Articles" - ] + "tags": ["Admin - Blog Articles"] }, "post": { "operationId": "AdminBlogArticlesController_create", @@ -19643,9 +18685,7 @@ } ], "summary": "Create blog article", - "tags": [ - "Admin - Blog Articles" - ] + "tags": ["Admin - Blog Articles"] } }, "/api/v1/admin/blog-articles/{id}": { @@ -19679,9 +18719,7 @@ } ], "summary": "Single article by id (draft or published)", - "tags": [ - "Admin - Blog Articles" - ] + "tags": ["Admin - Blog Articles"] }, "patch": { "operationId": "AdminBlogArticlesController_update", @@ -19723,9 +18761,7 @@ } ], "summary": "Update blog article", - "tags": [ - "Admin - Blog Articles" - ] + "tags": ["Admin - Blog Articles"] }, "delete": { "operationId": "AdminBlogArticlesController_remove", @@ -19757,9 +18793,7 @@ } ], "summary": "Soft-delete blog article", - "tags": [ - "Admin - Blog Articles" - ] + "tags": ["Admin - Blog Articles"] } }, "/health": { @@ -19780,9 +18814,7 @@ } }, "summary": "Health check", - "tags": [ - "Health" - ] + "tags": ["Health"] } }, "/health/ready": { @@ -19813,9 +18845,7 @@ } }, "summary": "Readiness check", - "tags": [ - "Health" - ] + "tags": ["Health"] } } }, @@ -19951,9 +18981,7 @@ "format": "phone" } }, - "required": [ - "mobile" - ] + "required": ["mobile"] }, "OtpRequestResponseDto": { "type": "object", @@ -19961,10 +18989,7 @@ "purpose": { "type": "string", "description": "Whether this OTP flow is for an existing or new account.", - "enum": [ - "login", - "register" - ], + "enum": ["login", "register"], "example": "login" }, "expiresIn": { @@ -19978,11 +19003,7 @@ "example": false } }, - "required": [ - "purpose", - "expiresIn", - "alreadySent" - ] + "required": ["purpose", "expiresIn", "alreadySent"] }, "ApiErrorCode": { "type": "string", @@ -20065,9 +19086,7 @@ "type": "object", "description": "Optional field-level validation errors keyed by request field name.", "example": { - "mobile": [ - "mobile must be a valid Iranian mobile number" - ] + "mobile": ["mobile must be a valid Iranian mobile number"] }, "additionalProperties": { "type": "array", @@ -20077,11 +19096,7 @@ } } }, - "required": [ - "success", - "code", - "message" - ] + "required": ["success", "code", "message"] }, "VerifyOtpDto": { "type": "object", @@ -20122,19 +19137,11 @@ "deprecated": true } }, - "required": [ - "mobile", - "code" - ] + "required": ["mobile", "code"] }, "UserStatus": { "type": "string", - "enum": [ - "active", - "pending", - "suspended", - "deleted" - ], + "enum": ["active", "pending", "suspended", "deleted"], "description": "Account status after OTP verification; pending users must complete profile." }, "AuthTokensDto": { @@ -20167,12 +19174,7 @@ ] } }, - "required": [ - "accessToken", - "sessionId", - "expiresAt", - "status" - ] + "required": ["accessToken", "sessionId", "expiresAt", "status"] }, "LoggedOutResponseDto": { "type": "object", @@ -20182,9 +19184,7 @@ "example": true } }, - "required": [ - "loggedOut" - ] + "required": ["loggedOut"] }, "SessionResponseDto": { "type": "object", @@ -20219,11 +19219,7 @@ "format": "date-time" } }, - "required": [ - "id", - "createdAt", - "expiresAt" - ] + "required": ["id", "createdAt", "expiresAt"] }, "RevokedResponseDto": { "type": "object", @@ -20233,30 +19229,16 @@ "example": true } }, - "required": [ - "revoked" - ] + "required": ["revoked"] }, "Gender": { "type": "string", - "enum": [ - "male", - "female", - "other" - ], + "enum": ["male", "female", "other"], "description": "Gender for placeholder avatars when no photo is set." }, "ContactChannel": { "type": "string", - "enum": [ - "instagram", - "telegram", - "twitter", - "linkedin", - "youtube", - "website", - "support_phone" - ] + "enum": ["instagram", "telegram", "twitter", "linkedin", "youtube", "website", "support_phone"] }, "PublicOrganizerContactLinkDto": { "type": "object", @@ -20280,12 +19262,7 @@ "description": "Raw stored value (username, URL, or phone digits)." } }, - "required": [ - "channel", - "label", - "url", - "value" - ] + "required": ["channel", "label", "url", "value"] }, "PublicOrganizerResponseDto": { "type": "object", @@ -20409,6 +19386,13 @@ "format": "date-time", "type": "string" }, + "categoryId": { + "type": "number" + }, + "categoryName": { + "type": "string", + "description": "Display name of the event category (avoids a second taxonomy round-trip)." + }, "cityName": { "type": "string" }, @@ -20429,6 +19413,8 @@ "posterUrl", "startsAt", "endsAt", + "categoryId", + "categoryName", "cityName", "isFree", "price", @@ -20437,10 +19423,7 @@ }, "ListResultType": { "type": "number", - "enum": [ - 0, - 1 - ], + "enum": [0, 1], "description": "Result type requested by the client: 0 for JSON list, 1 for Excel export." }, "PaginationMetaDto": { @@ -20539,20 +19522,14 @@ "description": "True when newer messages exist beyond this page (pass `newerCursor` as `after`)." } }, - "required": [ - "page", - "pageSize", - "totalItemsCount", - "totalPages", - "sort", - "filters" - ] + "required": ["page", "pageSize", "totalItemsCount", "totalPages", "sort", "filters"] }, "OrganizerViewerStateResponseDto": { "type": "object", "properties": { "isFollowing": { - "type": "boolean" + "type": "boolean", + "description": "Whether the viewer currently follows this organizer (includes muted; excludes unfollowed)." }, "attendeeContactLinks": { "type": "array", @@ -20561,27 +19538,16 @@ } } }, - "required": [ - "isFollowing", - "attendeeContactLinks" - ] + "required": ["isFollowing", "attendeeContactLinks"] }, "IdentityVerificationStatus": { "type": "string", - "enum": [ - "none", - "pending", - "verified", - "rejected" - ], + "enum": ["none", "pending", "verified", "rejected"], "description": "Host identity verification status; verified users may create events." }, "UserRole": { "type": "string", - "enum": [ - "user", - "admin" - ], + "enum": ["user", "admin"], "description": "User role. Admin is staff-only and manually assigned." }, "UserProfileResponseDto": { @@ -20755,14 +19721,7 @@ "format": "date-time" } }, - "required": [ - "id", - "subject", - "status", - "category", - "lastMessageAt", - "updatedAt" - ] + "required": ["id", "subject", "status", "category", "lastMessageAt", "updatedAt"] }, "ProfileSummaryEventPreviewDto": { "type": "object", @@ -20795,14 +19754,7 @@ "format": "date-time" } }, - "required": [ - "id", - "title", - "slug", - "posterUrl", - "squarePosterUrl", - "startsAt" - ] + "required": ["id", "title", "slug", "posterUrl", "squarePosterUrl", "startsAt"] }, "ProfileSummaryRegisteredPreviewDto": { "type": "object", @@ -20840,15 +19792,7 @@ "description": "Booking id" } }, - "required": [ - "id", - "title", - "slug", - "posterUrl", - "squarePosterUrl", - "startsAt", - "bookingId" - ] + "required": ["id", "title", "slug", "posterUrl", "squarePosterUrl", "startsAt", "bookingId"] }, "UserProfileSummaryResponseDto": { "type": "object", @@ -21021,13 +19965,7 @@ "minimum": 1 } }, - "required": [ - "firstName", - "lastName", - "gender", - "dateOfBirth", - "cityId" - ] + "required": ["firstName", "lastName", "gender", "dateOfBirth", "cityId"] }, "AdminUserListItemDto": { "type": "object", @@ -21154,11 +20092,7 @@ "userType": { "type": "string", "description": "Derived admin-facing user type: admin staff, verified host, or guest.", - "enum": [ - "guest", - "host", - "admin" - ], + "enum": ["guest", "host", "admin"], "example": "host" }, "walletBalance": { @@ -21202,9 +20136,7 @@ "format": "phone" } }, - "required": [ - "mobile" - ] + "required": ["mobile"] }, "AdminUpdateUserDto": { "type": "object", @@ -21262,19 +20194,13 @@ "status": { "type": "string", "description": "Suspend or reactivate the account. 'pending' and 'deleted' are not settable here — see the field-level note in this DTO.", - "enum": [ - "active", - "suspended" - ], + "enum": ["active", "suspended"], "example": "suspended" }, "hostPlan": { "type": "string", "description": "Free hosts can create 10 events; unlimited removes the quota.", - "enum": [ - "free", - "unlimited" - ] + "enum": ["free", "unlimited"] } } }, @@ -21287,15 +20213,7 @@ }, "channel": { "type": "string", - "enum": [ - "instagram", - "telegram", - "twitter", - "linkedin", - "youtube", - "website", - "support_phone" - ] + "enum": ["instagram", "telegram", "twitter", "linkedin", "youtube", "website", "support_phone"] }, "value": { "type": "string" @@ -21315,30 +20233,14 @@ "type": "string" } }, - "required": [ - "id", - "channel", - "value", - "isPublic", - "displayOrder", - "createdAt", - "updatedAt" - ] + "required": ["id", "channel", "value", "isPublic", "displayOrder", "createdAt", "updatedAt"] }, "CreateUserContactLinkDto": { "type": "object", "properties": { "channel": { "type": "string", - "enum": [ - "instagram", - "telegram", - "twitter", - "linkedin", - "youtube", - "website", - "support_phone" - ], + "enum": ["instagram", "telegram", "twitter", "linkedin", "youtube", "website", "support_phone"], "example": "instagram" }, "value": { @@ -21355,10 +20257,7 @@ "example": 0 } }, - "required": [ - "channel", - "value" - ] + "required": ["channel", "value"] }, "UpdateUserContactLinkDto": { "type": "object", @@ -21386,9 +20285,7 @@ "example": true } }, - "required": [ - "success" - ] + "required": ["success"] }, "IdentityRejectionReasonResponseDto": { "type": "object", @@ -21420,12 +20317,7 @@ "minimum": 0 } }, - "required": [ - "id", - "code", - "label", - "sortOrder" - ] + "required": ["id", "code", "label", "sortOrder"] }, "RequestHostContractOtpDto": { "type": "object", @@ -21449,11 +20341,7 @@ "description": "Must match the currently published host cooperation contract version." } }, - "required": [ - "nationalCode", - "contractAccepted", - "contractVersion" - ] + "required": ["nationalCode", "contractAccepted", "contractVersion"] }, "HostContractOtpRequestedDto": { "type": "object", @@ -21474,11 +20362,7 @@ "example": "2026-08-22" } }, - "required": [ - "purpose", - "expiresIn", - "contractVersion" - ] + "required": ["purpose", "expiresIn", "contractVersion"] }, "ConfirmHostContractOtpDto": { "type": "object", @@ -21491,16 +20375,11 @@ "maxLength": 4 } }, - "required": [ - "code" - ] + "required": ["code"] }, "IdentityVerificationSource": { "type": "string", - "enum": [ - "host_submission", - "admin_attested" - ], + "enum": ["host_submission", "admin_attested"], "description": "host_submission means the user sent KYC fields; admin_attested means staff verified the user without a host request." }, "IdentityVerificationResponseDto": { @@ -21640,14 +20519,7 @@ "format": "date-time" } }, - "required": [ - "id", - "userId", - "status", - "source", - "createdAt", - "updatedAt" - ] + "required": ["id", "userId", "status", "source", "createdAt", "updatedAt"] }, "AdminIdentityVerificationResponseDto": { "type": "object", @@ -21795,15 +20667,7 @@ } } }, - "required": [ - "id", - "userId", - "status", - "source", - "createdAt", - "updatedAt", - "user" - ] + "required": ["id", "userId", "status", "source", "createdAt", "updatedAt", "user"] }, "RejectIdentityVerificationDto": { "type": "object", @@ -21824,12 +20688,7 @@ }, "NotificationStatus": { "type": "string", - "enum": [ - "pending", - "sent", - "failed", - "cancelled" - ], + "enum": ["pending", "sent", "failed", "cancelled"], "description": "Parent notification delivery status." }, "NotificationResponseDto": { @@ -21903,14 +20762,7 @@ "format": "date-time" } }, - "required": [ - "id", - "category", - "title", - "body", - "status", - "createdAt" - ] + "required": ["id", "category", "title", "body", "status", "createdAt"] }, "NotificationUnreadCountResponseDto": { "type": "object", @@ -21921,9 +20773,7 @@ "example": 2 } }, - "required": [ - "totalUnread" - ] + "required": ["totalUnread"] }, "NotificationMarkAllReadResponseDto": { "type": "object", @@ -21937,10 +20787,7 @@ "format": "date-time" } }, - "required": [ - "updatedCount", - "readAt" - ] + "required": ["updatedCount", "readAt"] }, "PushVapidPublicKeyResponseDto": { "type": "object", @@ -21956,10 +20803,7 @@ "example": true } }, - "required": [ - "publicKey", - "enabled" - ] + "required": ["publicKey", "enabled"] }, "PushDeliveryReceiptDto": { "type": "object", @@ -21979,10 +20823,7 @@ "eventType": { "type": "string", "description": "displayed = browser showed the notification, opened = user tapped it.", - "enum": [ - "displayed", - "opened" - ], + "enum": ["displayed", "opened"], "example": "opened" }, "receiptHmac": { @@ -21991,12 +20832,7 @@ "example": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" } }, - "required": [ - "notificationId", - "subscriptionId", - "eventType", - "receiptHmac" - ] + "required": ["notificationId", "subscriptionId", "eventType", "receiptHmac"] }, "PushDeliveryReceiptResponseDto": { "type": "object", @@ -22033,11 +20869,7 @@ "nullable": true } }, - "required": [ - "recorded", - "notificationId", - "subscriptionId" - ] + "required": ["recorded", "notificationId", "subscriptionId"] }, "PushSubscribeDto": { "type": "object", @@ -22060,11 +20892,7 @@ "description": "Browser user-agent string for debugging multi-device subscriptions." } }, - "required": [ - "endpoint", - "p256dh", - "auth" - ] + "required": ["endpoint", "p256dh", "auth"] }, "PushSubscriptionResponseDto": { "type": "object", @@ -22085,12 +20913,7 @@ "type": "string" } }, - "required": [ - "id", - "userId", - "endpoint", - "createdAt" - ] + "required": ["id", "userId", "endpoint", "createdAt"] }, "DeletedResponseDto": { "type": "object", @@ -22100,9 +20923,7 @@ "example": true } }, - "required": [ - "deleted" - ] + "required": ["deleted"] }, "DeletedCountResponseDto": { "type": "object", @@ -22113,18 +20934,11 @@ "minimum": 0 } }, - "required": [ - "deletedCount" - ] + "required": ["deletedCount"] }, "SmsStatus": { "type": "string", - "enum": [ - "pending", - "sent", - "failed", - "delivered" - ], + "enum": ["pending", "sent", "failed", "delivered"], "description": "SMS delivery status." }, "SmsRecipientDto": { @@ -22143,10 +20957,7 @@ "nullable": true } }, - "required": [ - "firstName", - "lastName" - ] + "required": ["firstName", "lastName"] }, "SmsMessageResponseDto": { "type": "object", @@ -22239,16 +21050,7 @@ ] } }, - "required": [ - "id", - "notificationId", - "userId", - "mobile", - "messageBody", - "status", - "createdAt", - "updatedAt" - ] + "required": ["id", "notificationId", "userId", "mobile", "messageBody", "status", "createdAt", "updatedAt"] }, "NotificationRuleResponseDto": { "type": "object", @@ -22268,11 +21070,7 @@ }, "channel": { "type": "string", - "enum": [ - "in_app", - "sms", - "both" - ] + "enum": ["in_app", "sms", "both"] }, "titleTemplate": { "type": "string" @@ -22326,11 +21124,7 @@ }, "channel": { "type": "string", - "enum": [ - "in_app", - "sms", - "both" - ] + "enum": ["in_app", "sms", "both"] }, "titleTemplate": { "type": "string" @@ -22350,9 +21144,7 @@ "purpose": { "type": "string", "description": "OTP purpose used when confirming a bulk SMS send.", - "enum": [ - "admin_bulk_sms" - ], + "enum": ["admin_bulk_sms"], "example": "admin_bulk_sms" }, "expiresIn": { @@ -22361,18 +21153,11 @@ "example": 300 } }, - "required": [ - "purpose", - "expiresIn" - ] + "required": ["purpose", "expiresIn"] }, "NotificationChannel": { "type": "string", - "enum": [ - "in_app", - "sms", - "both" - ], + "enum": ["in_app", "sms", "both"], "description": "Delivery channel. `in_app` also dispatches Web Push when the user has an active subscription. Defaults to `in_app`." }, "AdminSendManualNotificationDto": { @@ -22408,9 +21193,7 @@ }, "userIds": { "description": "Recipient user ids. At least one of userIds or mobiles must be provided.", - "example": [ - "c3c921d5-4418-42ed-bf39-0f04b1d5123b" - ], + "example": ["c3c921d5-4418-42ed-bf39-0f04b1d5123b"], "type": "array", "items": { "type": "string" @@ -22418,10 +21201,7 @@ }, "mobiles": { "description": "Recipient mobile numbers (0912..., 98912..., or +98912...). At least one of userIds or mobiles must be provided.", - "example": [ - "09153641196", - "989121234567" - ], + "example": ["09153641196", "989121234567"], "type": "array", "items": { "type": "string" @@ -22434,9 +21214,7 @@ "maxLength": 10 } }, - "required": [ - "body" - ] + "required": ["body"] }, "AdminManualNotificationRecipientDto": { "type": "object", @@ -22471,11 +21249,7 @@ "format": "uuid" } }, - "required": [ - "userId", - "mobile", - "notificationId" - ] + "required": ["userId", "mobile", "notificationId"] }, "AdminManualNotificationResponseDto": { "type": "object", @@ -22494,9 +21268,7 @@ }, "missingUserIds": { "description": "Requested user ids that did not resolve to a user row.", - "example": [ - "11111111-1111-1111-1111-111111111111" - ], + "example": ["11111111-1111-1111-1111-111111111111"], "type": "array", "items": { "type": "string" @@ -22504,21 +21276,14 @@ }, "missingMobiles": { "description": "Requested mobile numbers that did not resolve to a user row after normalization.", - "example": [ - "989199999999" - ], + "example": ["989199999999"], "type": "array", "items": { "type": "string" } } }, - "required": [ - "recipientCount", - "recipients", - "missingUserIds", - "missingMobiles" - ] + "required": ["recipientCount", "recipients", "missingUserIds", "missingMobiles"] }, "AdminInAppRecipientDto": { "type": "object", @@ -22536,10 +21301,7 @@ "nullable": true } }, - "required": [ - "firstName", - "lastName" - ] + "required": ["firstName", "lastName"] }, "AdminInAppNotificationResponseDto": { "type": "object", @@ -22613,16 +21375,7 @@ ] } }, - "required": [ - "id", - "userId", - "mobile", - "category", - "title", - "body", - "status", - "createdAt" - ] + "required": ["id", "userId", "mobile", "category", "title", "body", "status", "createdAt"] }, "PushDeliveryRecipientDto": { "type": "object", @@ -22640,10 +21393,7 @@ "nullable": true } }, - "required": [ - "firstName", - "lastName" - ] + "required": ["firstName", "lastName"] }, "PushDeliveryResponseDto": { "type": "object", @@ -22744,18 +21494,7 @@ ] } }, - "required": [ - "id", - "notificationId", - "userId", - "subscriptionId", - "mobile", - "category", - "title", - "body", - "status", - "createdAt" - ] + "required": ["id", "notificationId", "userId", "subscriptionId", "mobile", "category", "title", "body", "status", "createdAt"] }, "EventCategoryResponseDto": { "type": "object", @@ -22876,10 +21615,7 @@ "example": "موسیقی" } }, - "required": [ - "id", - "name" - ] + "required": ["id", "name"] }, "CreateEventCategoryDto": { "type": "object", @@ -22954,10 +21690,7 @@ "nullable": true } }, - "required": [ - "name", - "slug" - ] + "required": ["name", "slug"] }, "UpdateEventCategoryDto": { "type": "object", @@ -23053,12 +21786,7 @@ "example": 51.389 } }, - "required": [ - "id", - "name", - "lat", - "lng" - ] + "required": ["id", "name", "lat", "lng"] }, "CityResponseDto": { "type": "object", @@ -23088,12 +21816,7 @@ "example": 51.389 } }, - "required": [ - "id", - "provinceId", - "name", - "slug" - ] + "required": ["id", "provinceId", "name", "slug"] }, "CityDetailResponseDto": { "type": "object", @@ -23131,26 +21854,11 @@ "example": "tehran-province" } }, - "required": [ - "id", - "provinceId", - "name", - "slug", - "provinceName", - "provinceSlug" - ] + "required": ["id", "provinceId", "name", "slug", "provinceName", "provinceSlug"] }, "EventStatus": { "type": "string", - "enum": [ - "draft", - "pending_review", - "published", - "full", - "rejected", - "cancelled", - "completed" - ] + "enum": ["draft", "pending_review", "published", "full", "rejected", "cancelled", "completed"] }, "MyEventsHostItemDto": { "type": "object", @@ -23236,14 +21944,7 @@ }, "BookingStatus": { "type": "string", - "enum": [ - "pending_payment", - "confirmed", - "cancelled", - "expired", - "refunded", - "no_show" - ] + "enum": ["pending_payment", "confirmed", "cancelled", "expired", "refunded", "no_show"] }, "MyEventsGuestItemDto": { "type": "object", @@ -23347,20 +22048,11 @@ }, "EventGenderRestriction": { "type": "string", - "enum": [ - "open", - "female_only", - "male_only" - ] + "enum": ["open", "female_only", "male_only"] }, "EventAgeRestriction": { "type": "string", - "enum": [ - "open", - "age_15_19", - "age_20_24", - "age_25_plus" - ] + "enum": ["open", "age_15_19", "age_20_24", "age_25_plus"] }, "EventSettingsDto": { "type": "object", @@ -23377,10 +22069,7 @@ }, "addressVisibility": { "type": "string", - "enum": [ - "public", - "attendees_only" - ], + "enum": ["public", "attendees_only"], "default": "public", "description": "When 'attendees_only', only the organizer/admin and guests with a confirmed booking see the exact address/lat/lng; everyone else sees generalArea instead." }, @@ -23406,10 +22095,7 @@ "properties": { "mediaType": { "type": "string", - "enum": [ - "image", - "video" - ], + "enum": ["image", "video"], "example": "image" }, "url": { @@ -23435,10 +22121,7 @@ "description": "Marks the 1:1 square card poster. Exactly one image per event." } }, - "required": [ - "mediaType", - "url" - ] + "required": ["mediaType", "url"] }, "CreateEventFaqDto": { "type": "object", @@ -23459,10 +22142,7 @@ "minimum": 0 } }, - "required": [ - "question", - "answer" - ] + "required": ["question", "answer"] }, "SubmitEventRevisionDto": { "type": "object", @@ -23579,9 +22259,7 @@ } } }, - "required": [ - "media" - ] + "required": ["media"] }, "EventRevisionResponseDto": { "type": "object", @@ -23594,12 +22272,7 @@ }, "status": { "type": "string", - "enum": [ - "pending", - "approved", - "rejected", - "superseded" - ] + "enum": ["pending", "approved", "rejected", "superseded"] }, "payload": { "type": "object", @@ -23622,14 +22295,7 @@ "type": "object" } }, - "required": [ - "id", - "eventId", - "status", - "payload", - "createdBy", - "submittedAt" - ] + "required": ["id", "eventId", "status", "payload", "createdBy", "submittedAt"] }, "CreateEventDto": { "type": "object", @@ -23773,10 +22439,7 @@ }, "addressVisibility": { "type": "string", - "enum": [ - "public", - "attendees_only" - ] + "enum": ["public", "attendees_only"] }, "generalArea": { "type": "string", @@ -23790,14 +22453,7 @@ "description": "When true, review_request after completion is sent as in-app + SMS; otherwise in-app only." } }, - "required": [ - "isDiscoverable", - "autoCreateGroup", - "addressVisibility", - "generalArea", - "waitlistAutoOffer", - "sendReviewRequestSms" - ] + "required": ["isDiscoverable", "autoCreateGroup", "addressVisibility", "generalArea", "waitlistAutoOffer", "sendReviewRequestSms"] }, "EventDiscoveryPlacementDto": { "type": "object", @@ -23810,10 +22466,7 @@ "minimum": 0 } }, - "required": [ - "placement", - "priority" - ] + "required": ["placement", "priority"] }, "EventResponseDto": { "type": "object", @@ -24149,15 +22802,7 @@ "minimum": 0 } }, - "required": [ - "grossAmount", - "commissionAmount", - "guestRefundAmount", - "netAmount", - "heldAmount", - "availableAmount", - "settledAmount" - ] + "required": ["grossAmount", "commissionAmount", "guestRefundAmount", "netAmount", "heldAmount", "availableAmount", "settledAmount"] }, "OwnerEventTrafficChannelInsightsDto": { "type": "object", @@ -24171,10 +22816,7 @@ "minimum": 0 } }, - "required": [ - "uniqueVisits", - "confirmedBookings" - ] + "required": ["uniqueVisits", "confirmedBookings"] }, "OwnerEventTrafficInsightsDto": { "type": "object", @@ -24186,10 +22828,7 @@ "$ref": "#/components/schemas/OwnerEventTrafficChannelInsightsDto" } }, - "required": [ - "instagram", - "telegram" - ] + "required": ["instagram", "telegram"] }, "OwnerEventInsightsResponseDto": { "type": "object", @@ -24208,19 +22847,11 @@ "$ref": "#/components/schemas/OwnerEventTrafficInsightsDto" } }, - "required": [ - "bookmarkCount", - "registrations", - "financial", - "traffic" - ] + "required": ["bookmarkCount", "registrations", "financial", "traffic"] }, "EventMediaType": { "type": "string", - "enum": [ - "image", - "video" - ] + "enum": ["image", "video"] }, "EventMediaResponseDto": { "type": "object", @@ -24263,17 +22894,7 @@ "type": "string" } }, - "required": [ - "id", - "eventId", - "mediaType", - "url", - "thumbnailUrl", - "sortOrder", - "isPoster", - "isSquarePoster", - "createdAt" - ] + "required": ["id", "eventId", "mediaType", "url", "thumbnailUrl", "sortOrder", "isPoster", "isSquarePoster", "createdAt"] }, "EventFaqResponseDto": { "type": "object", @@ -24304,15 +22925,7 @@ "type": "string" } }, - "required": [ - "id", - "eventId", - "question", - "answer", - "sortOrder", - "createdAt", - "updatedAt" - ] + "required": ["id", "eventId", "question", "answer", "sortOrder", "createdAt", "updatedAt"] }, "EventManagementBootstrapResponseDto": { "type": "object", @@ -24345,15 +22958,7 @@ } } }, - "required": [ - "event", - "insights", - "categoryName", - "cityName", - "provinceName", - "media", - "faqs" - ] + "required": ["event", "insights", "categoryName", "cityName", "provinceName", "media", "faqs"] }, "EventAttendeeResponseDto": { "type": "object", @@ -24404,24 +23009,11 @@ "type": "string" } }, - "required": [ - "bookingId", - "userId", - "bookingCode", - "status", - "createdAt" - ] + "required": ["bookingId", "userId", "bookingCode", "status", "createdAt"] }, "EventAttendeeFilter": { "type": "string", - "enum": [ - "all", - "confirmed", - "checked_in", - "not_checked_in", - "pending_payment", - "cancelled" - ] + "enum": ["all", "confirmed", "checked_in", "not_checked_in", "pending_payment", "cancelled"] }, "UpdateEventReservedCapacityDto": { "type": "object", @@ -24431,11 +23023,15 @@ "example": 3, "minimum": 0, "description": "Absolute off-platform reserved seat count. Occupancy is bookedCount + reservedCapacity and cannot exceed capacity. Pending payments already occupy seats." + }, + "capacity": { + "type": "number", + "example": 20, + "minimum": 1, + "description": "Optional total capacity. Hosts may change capacity on live events without admin revision. Must be >= bookedCount + reservedCapacity; occupancy trigger flips published ↔ full." } }, - "required": [ - "reservedCapacity" - ] + "required": ["reservedCapacity"] }, "UpdateEventDto": { "type": "object", @@ -24550,9 +23146,7 @@ } } }, - "required": [ - "eventIds" - ] + "required": ["eventIds"] }, "BookmarkBatchStatusResponseDto": { "type": "object", @@ -24565,9 +23159,7 @@ } } }, - "required": [ - "bookmarkedEventIds" - ] + "required": ["bookmarkedEventIds"] }, "BookmarkStateResponseDto": { "type": "object", @@ -24576,9 +23168,7 @@ "type": "boolean" } }, - "required": [ - "isBookmarked" - ] + "required": ["isBookmarked"] }, "DiscoveryEventOrganizerDto": { "type": "object", @@ -24592,10 +23182,7 @@ "nullable": true } }, - "required": [ - "firstName", - "lastName" - ] + "required": ["firstName", "lastName"] }, "DiscoveryEventResponseDto": { "type": "object", @@ -24842,11 +23429,7 @@ "type": "string" } }, - "required": [ - "id", - "name", - "slug" - ] + "required": ["id", "name", "slug"] }, "EventLandingCityDto": { "type": "object", @@ -24858,10 +23441,7 @@ "type": "string" } }, - "required": [ - "id", - "name" - ] + "required": ["id", "name"] }, "EventLandingOrganizerContactLinkDto": { "type": "object", @@ -24876,11 +23456,7 @@ "type": "string" } }, - "required": [ - "channel", - "label", - "url" - ] + "required": ["channel", "label", "url"] }, "EventLandingOrganizerDto": { "type": "object", @@ -24901,11 +23477,7 @@ }, "gender": { "type": "string", - "enum": [ - "male", - "female", - "other" - ], + "enum": ["male", "female", "other"], "nullable": true }, "bio": { @@ -24957,11 +23529,7 @@ }, "ReviewStatus": { "type": "string", - "enum": [ - "published", - "hidden", - "deleted" - ], + "enum": ["published", "hidden", "deleted"], "description": "Publication status." }, "ReviewUserSummaryDto": { @@ -24992,12 +23560,7 @@ "nullable": true } }, - "required": [ - "id", - "firstName", - "lastName", - "avatarUrl" - ] + "required": ["id", "firstName", "lastName", "avatarUrl"] }, "ReviewResponseDto": { "type": "object", @@ -25082,18 +23645,7 @@ ] } }, - "required": [ - "id", - "eventId", - "userId", - "bookingId", - "rating", - "body", - "status", - "createdAt", - "updatedAt", - "user" - ] + "required": ["id", "eventId", "userId", "bookingId", "rating", "body", "status", "createdAt", "updatedAt", "user"] }, "EventLandingBootstrapResponseDto": { "type": "object", @@ -25135,17 +23687,7 @@ "type": "number" } }, - "required": [ - "event", - "category", - "city", - "media", - "faqs", - "faqsTotal", - "organizer", - "reviews", - "reviewsTotal" - ] + "required": ["event", "category", "city", "media", "faqs", "faqsTotal", "organizer", "reviews", "reviewsTotal"] }, "EventViewerBookingDto": { "type": "object", @@ -25156,20 +23698,10 @@ }, "status": { "type": "string", - "enum": [ - "pending_payment", - "confirmed", - "cancelled", - "expired", - "refunded", - "no_show" - ] + "enum": ["pending_payment", "confirmed", "cancelled", "expired", "refunded", "no_show"] } }, - "required": [ - "id", - "status" - ] + "required": ["id", "status"] }, "EventViewerWaitlistDto": { "type": "object", @@ -25180,20 +23712,10 @@ }, "status": { "type": "string", - "enum": [ - "waiting", - "notified", - "accepted", - "expired", - "cancelled", - "converted" - ] + "enum": ["waiting", "notified", "accepted", "expired", "cancelled", "converted"] } }, - "required": [ - "id", - "status" - ] + "required": ["id", "status"] }, "EventViewerLocationDto": { "type": "object", @@ -25208,11 +23730,7 @@ "type": "number" } }, - "required": [ - "address", - "lat", - "lng" - ] + "required": ["address", "lat", "lng"] }, "EventViewerStateResponseDto": { "type": "object", @@ -25224,7 +23742,8 @@ "type": "boolean" }, "isFollowingOrganizer": { - "type": "boolean" + "type": "boolean", + "description": "Whether the viewer currently follows the event organizer (includes muted; excludes unfollowed)." }, "activeBooking": { "nullable": true, @@ -25262,11 +23781,7 @@ "description": "Empty when canJoinAudience is true.", "items": { "type": "string", - "enum": [ - "gender", - "age", - "city" - ] + "enum": ["gender", "age", "city"] } } }, @@ -25290,9 +23805,7 @@ "maxLength": 2000 } }, - "required": [ - "rejectionReason" - ] + "required": ["rejectionReason"] }, "AdminEventRelationSummaryDto": { "type": "object", @@ -25304,10 +23817,7 @@ "type": "string" } }, - "required": [ - "id", - "name" - ] + "required": ["id", "name"] }, "AdminEventOrganizerSummaryDto": { "type": "object", @@ -25329,9 +23839,7 @@ "nullable": true } }, - "required": [ - "id" - ] + "required": ["id"] }, "AdminEventResponseDto": { "type": "object", @@ -25373,18 +23881,7 @@ "$ref": "#/components/schemas/AdminEventOrganizerSummaryDto" } }, - "required": [ - "id", - "title", - "startsAt", - "status", - "isFree", - "price", - "category", - "province", - "city", - "organizer" - ] + "required": ["id", "title", "startsAt", "status", "isFree", "price", "category", "province", "city", "organizer"] }, "AdminCreateEventDto": { "type": "object", @@ -25784,9 +24281,7 @@ "maxLength": 2000 } }, - "required": [ - "rejectionReason" - ] + "required": ["rejectionReason"] }, "DiscoveryCategorySummaryDto": { "type": "object", @@ -25817,14 +24312,7 @@ "example": true } }, - "required": [ - "id", - "name", - "slug", - "parentId", - "sortOrder", - "isActive" - ] + "required": ["id", "name", "slug", "parentId", "sortOrder", "isActive"] }, "HomeFeedOrganizerDto": { "type": "object", @@ -25866,14 +24354,7 @@ "$ref": "#/components/schemas/HomeFeedOrganizerDto" } }, - "required": [ - "id", - "title", - "slug", - "posterUrl", - "squarePosterUrl", - "organizer" - ] + "required": ["id", "title", "slug", "posterUrl", "squarePosterUrl", "organizer"] }, "HomeCategoryPreviewEventDto": { "type": "object", @@ -25907,15 +24388,7 @@ "nullable": true } }, - "required": [ - "id", - "title", - "slug", - "startsAt", - "endsAt", - "posterUrl", - "squarePosterUrl" - ] + "required": ["id", "title", "slug", "startsAt", "endsAt", "posterUrl", "squarePosterUrl"] }, "HomeFeedCategoryPreviewGroupDto": { "type": "object", @@ -25931,10 +24404,7 @@ } } }, - "required": [ - "categoryId", - "items" - ] + "required": ["categoryId", "items"] }, "HomeCityPreviewEventDto": { "type": "object", @@ -26038,10 +24508,7 @@ } } }, - "required": [ - "cityId", - "items" - ] + "required": ["cityId", "items"] }, "HomeFeedResponseDto": { "type": "object", @@ -26065,11 +24532,7 @@ } } }, - "required": [ - "popular", - "categoryPreviews", - "cityPreviews" - ] + "required": ["popular", "categoryPreviews", "cityPreviews"] }, "DiscoveryBootstrapResponseDto": { "type": "object", @@ -26087,10 +24550,7 @@ } } }, - "required": [ - "categories", - "cities" - ] + "required": ["categories", "cities"] }, "FollowUserSummaryDto": { "type": "object", @@ -26124,10 +24584,7 @@ ] } }, - "required": [ - "firstName", - "lastName" - ] + "required": ["firstName", "lastName"] }, "FollowResponseDto": { "type": "object", @@ -26153,10 +24610,7 @@ "status": { "type": "string", "description": "Follow status.", - "enum": [ - "active", - "muted" - ], + "enum": ["active", "muted"], "example": "active" }, "notifyNewEvents": { @@ -26179,14 +24633,7 @@ ] } }, - "required": [ - "id", - "followerId", - "organizerId", - "status", - "notifyNewEvents", - "createdAt" - ] + "required": ["id", "followerId", "organizerId", "status", "notifyNewEvents", "createdAt"] }, "UpdateFollowSettingsDto": { "type": "object", @@ -26203,10 +24650,7 @@ "properties": { "mediaType": { "type": "string", - "enum": [ - "image", - "video" - ] + "enum": ["image", "video"] }, "url": { "type": "string" @@ -26259,11 +24703,7 @@ "nullable": true } }, - "required": [ - "userId", - "firstName", - "lastName" - ] + "required": ["userId", "firstName", "lastName"] }, "OrganizerGuestListResponseDto": { "type": "object", @@ -26285,10 +24725,7 @@ }, "kind": { "type": "string", - "enum": [ - "manual", - "previous_attendees" - ] + "enum": ["manual", "previous_attendees"] }, "createdAt": { "format": "date-time", @@ -26299,15 +24736,7 @@ "type": "string" } }, - "required": [ - "id", - "organizerId", - "name", - "description", - "kind", - "createdAt", - "updatedAt" - ] + "required": ["id", "organizerId", "name", "description", "kind", "createdAt", "updatedAt"] }, "CreateOrganizerGuestListDto": { "type": "object", @@ -26322,9 +24751,7 @@ "example": "مهمانان رویدادهای قبلی و مخاطبین میزبان" } }, - "required": [ - "name" - ] + "required": ["name"] }, "GuestListItemResponseDto": { "type": "object", @@ -26363,15 +24790,7 @@ "type": "string" } }, - "required": [ - "id", - "listId", - "firstName", - "lastName", - "userId", - "note", - "createdAt" - ] + "required": ["id", "listId", "firstName", "lastName", "userId", "note", "createdAt"] }, "AddGuestListItemDto": { "type": "object", @@ -26396,27 +24815,21 @@ "type": "string" } }, - "required": [ - "mobile" - ] + "required": ["mobile"] }, "SetEventInvitedGuestsDto": { "type": "object", "properties": { "userIds": { "description": "Full replacement set of platform user ids invited to this event from the host guest list. An empty array clears the invite set.", - "example": [ - "b3f1c2a0-1111-4111-8111-b3f1c2a01111" - ], + "example": ["b3f1c2a0-1111-4111-8111-b3f1c2a01111"], "type": "array", "items": { "type": "string" } } }, - "required": [ - "userIds" - ] + "required": ["userIds"] }, "InvitedGuestResponseDto": { "type": "object", @@ -26439,11 +24852,7 @@ "nullable": true } }, - "required": [ - "userId", - "firstName", - "lastName" - ] + "required": ["userId", "firstName", "lastName"] }, "GuestListNotifyResultDto": { "type": "object", @@ -26461,11 +24870,7 @@ "type": "string" } }, - "required": [ - "sent", - "skipped", - "notifiedAt" - ] + "required": ["sent", "skipped", "notifiedAt"] }, "GuestListLinkResponseDto": { "type": "object", @@ -26491,12 +24896,7 @@ "type": "string" } }, - "required": [ - "eventId", - "listId", - "notifiedAt", - "createdAt" - ] + "required": ["eventId", "listId", "notifiedAt", "createdAt"] }, "LinkGuestListToEventDto": { "type": "object", @@ -26506,9 +24906,7 @@ "description": "Guest list to attach to the event" } }, - "required": [ - "listId" - ] + "required": ["listId"] }, "CreatePaymentDto": { "type": "object", @@ -26528,21 +24926,11 @@ }, "PaymentMethod": { "type": "string", - "enum": [ - "gateway", - "wallet", - "mixed" - ] + "enum": ["gateway", "wallet", "mixed"] }, "PaymentStatus": { "type": "string", - "enum": [ - "pending", - "processing", - "succeeded", - "failed", - "cancelled" - ] + "enum": ["pending", "processing", "succeeded", "failed", "cancelled"] }, "PaymentCheckoutResponseDto": { "type": "object", @@ -26555,10 +24943,7 @@ "format": "uri" } }, - "required": [ - "trackingId", - "paymentUrl" - ] + "required": ["trackingId", "paymentUrl"] }, "CreatePaymentResponseDto": { "type": "object", @@ -26702,9 +25087,7 @@ "example": "SAVE20AB" } }, - "required": [ - "code" - ] + "required": ["code"] }, "DiscountPreviewResponseDto": { "type": "object", @@ -26715,10 +25098,7 @@ }, "type": { "type": "string", - "enum": [ - "percent", - "fixed" - ] + "enum": ["percent", "fixed"] }, "value": { "type": "number", @@ -26737,14 +25117,7 @@ "example": 80000 } }, - "required": [ - "code", - "type", - "value", - "listAmount", - "discountAmount", - "payableAmount" - ] + "required": ["code", "type", "value", "listAmount", "discountAmount", "payableAmount"] }, "PaymentResponseDto": { "type": "object", @@ -26882,16 +25255,7 @@ "type": "string" } }, - "required": [ - "id", - "paymentId", - "userId", - "bookingId", - "eventId", - "receiptCode", - "snapshot", - "issuedAt" - ] + "required": ["id", "paymentId", "userId", "bookingId", "eventId", "receiptCode", "snapshot", "issuedAt"] }, "FinancialUserSummaryDto": { "type": "object", @@ -26912,10 +25276,7 @@ "nullable": true } }, - "required": [ - "id", - "mobile" - ] + "required": ["id", "mobile"] }, "AdminPaymentResponseDto": { "type": "object", @@ -27050,10 +25411,7 @@ }, "purpose": { "type": "string", - "enum": [ - "top_up", - "booking_checkout" - ] + "enum": ["top_up", "booking_checkout"] }, "amount": { "type": "number", @@ -27071,13 +25429,7 @@ }, "status": { "type": "string", - "enum": [ - "pending", - "processing", - "succeeded", - "failed", - "cancelled" - ] + "enum": ["pending", "processing", "succeeded", "failed", "cancelled"] }, "gatewayProvider": { "type": "string", @@ -27156,24 +25508,11 @@ "type": "string" } }, - "required": [ - "id", - "userId", - "balance", - "createdAt", - "updatedAt" - ] + "required": ["id", "userId", "balance", "createdAt", "updatedAt"] }, "WalletTransactionType": { "type": "string", - "enum": [ - "booking_payment", - "refund_guest_cancel", - "refund_event_cancel", - "organizer_earning", - "withdrawal", - "deposit" - ] + "enum": ["booking_payment", "refund_guest_cancel", "refund_event_cancel", "organizer_earning", "withdrawal", "deposit"] }, "WalletTransactionResponseDto": { "type": "object", @@ -27226,16 +25565,7 @@ "type": "string" } }, - "required": [ - "id", - "walletId", - "userId", - "transactionCode", - "type", - "amount", - "balanceAfter", - "createdAt" - ] + "required": ["id", "walletId", "userId", "transactionCode", "type", "amount", "balanceAfter", "createdAt"] }, "CreateWalletDepositDto": { "type": "object", @@ -27246,9 +25576,7 @@ "minimum": 10000 } }, - "required": [ - "amount" - ] + "required": ["amount"] }, "CreateWalletDepositResponseDto": { "type": "object", @@ -27270,10 +25598,7 @@ }, "purpose": { "type": "string", - "enum": [ - "top_up", - "booking_checkout" - ] + "enum": ["top_up", "booking_checkout"] }, "amount": { "type": "number", @@ -27291,13 +25616,7 @@ }, "status": { "type": "string", - "enum": [ - "pending", - "processing", - "succeeded", - "failed", - "cancelled" - ] + "enum": ["pending", "processing", "succeeded", "failed", "cancelled"] }, "gatewayProvider": { "type": "string", @@ -27383,10 +25702,7 @@ }, "purpose": { "type": "string", - "enum": [ - "top_up", - "booking_checkout" - ] + "enum": ["top_up", "booking_checkout"] }, "amount": { "type": "number", @@ -27404,13 +25720,7 @@ }, "status": { "type": "string", - "enum": [ - "pending", - "processing", - "succeeded", - "failed", - "cancelled" - ] + "enum": ["pending", "processing", "succeeded", "failed", "cancelled"] }, "gatewayProvider": { "type": "string", @@ -27466,10 +25776,7 @@ "properties": { "status": { "type": "string", - "enum": [ - "succeeded", - "failed" - ] + "enum": ["succeeded", "failed"] }, "signature": { "type": "string" @@ -27494,12 +25801,7 @@ "type": "string" } }, - "required": [ - "status", - "signature", - "timestamp", - "nonce" - ] + "required": ["status", "signature", "timestamp", "nonce"] }, "CreateBankAccountDto": { "type": "object", @@ -27514,24 +25816,15 @@ "example": "0012345678" } }, - "required": [ - "iban" - ] + "required": ["iban"] }, "BankAccountOwnerType": { "type": "string", - "enum": [ - "guest", - "organizer" - ] + "enum": ["guest", "organizer"] }, "BankAccountVerificationStatus": { "type": "string", - "enum": [ - "pending_review", - "approved", - "rejected" - ] + "enum": ["pending_review", "approved", "rejected"] }, "BankAccountResponseDto": { "type": "object", @@ -27628,9 +25921,7 @@ "minLength": 3 } }, - "required": [ - "reason" - ] + "required": ["reason"] }, "CreateWithdrawalRequestDto": { "type": "object", @@ -27644,19 +25935,11 @@ "description": "Amount in Toman" } }, - "required": [ - "bankAccountId", - "amount" - ] + "required": ["bankAccountId", "amount"] }, "WithdrawalStatus": { "type": "string", - "enum": [ - "pending", - "processing", - "completed", - "rejected" - ] + "enum": ["pending", "processing", "completed", "rejected"] }, "WithdrawalUserSummaryDto": { "type": "object", @@ -27673,9 +25956,7 @@ "nullable": true } }, - "required": [ - "mobile" - ] + "required": ["mobile"] }, "WithdrawalBankAccountSummaryDto": { "type": "object", @@ -27684,9 +25965,7 @@ "type": "string" } }, - "required": [ - "iban" - ] + "required": ["iban"] }, "WithdrawalResponseDto": { "type": "object", @@ -27794,10 +26073,7 @@ "description": "Optional admin note shown to the recipient" } }, - "required": [ - "trackingCode", - "receiptUrl" - ] + "required": ["trackingCode", "receiptUrl"] }, "RejectWithdrawalRequestDto": { "type": "object", @@ -27806,18 +26082,11 @@ "type": "string" } }, - "required": [ - "reason" - ] + "required": ["reason"] }, "OrganizerEarningStatus": { "type": "string", - "enum": [ - "held", - "available", - "settled", - "cancelled" - ] + "enum": ["held", "available", "settled", "cancelled"] }, "OrganizerEarningResponseDto": { "type": "object", @@ -27901,12 +26170,7 @@ }, "SettlementBatchStatus": { "type": "string", - "enum": [ - "pending", - "processing", - "completed", - "failed" - ] + "enum": ["pending", "processing", "completed", "failed"] }, "SettlementItemResponseDto": { "type": "object", @@ -27930,13 +26194,7 @@ "type": "string" } }, - "required": [ - "id", - "amount", - "organizerEarningId", - "eventId", - "eventTitle" - ] + "required": ["id", "amount", "organizerEarningId", "eventId", "eventTitle"] }, "SettlementResponseDto": { "type": "object", @@ -28042,12 +26300,7 @@ "example": "2026-07-07" } }, - "required": [ - "organizerId", - "bankAccountId", - "periodStart", - "periodEnd" - ] + "required": ["organizerId", "bankAccountId", "periodStart", "periodEnd"] }, "FailSettlementDto": { "type": "object", @@ -28056,19 +26309,14 @@ "type": "string" } }, - "required": [ - "reason" - ] + "required": ["reason"] }, "CreateDiscountCodesDto": { "type": "object", "properties": { "type": { "type": "string", - "enum": [ - "percent", - "fixed" - ], + "enum": ["percent", "fixed"], "example": "percent" }, "value": { @@ -28108,19 +26356,12 @@ }, "bearer": { "type": "string", - "enum": [ - "organizer", - "platform" - ], + "enum": ["organizer", "platform"], "description": "Who absorbs the discount. Admin-only; host requests are always forced to \"organizer\".", "example": "organizer" } }, - "required": [ - "type", - "value", - "quantity" - ] + "required": ["type", "value", "quantity"] }, "DiscountCodeResponseDto": { "type": "object", @@ -28139,10 +26380,7 @@ }, "type": { "type": "string", - "enum": [ - "percent", - "fixed" - ] + "enum": ["percent", "fixed"] }, "value": { "type": "number", @@ -28150,10 +26388,7 @@ }, "bearer": { "type": "string", - "enum": [ - "organizer", - "platform" - ] + "enum": ["organizer", "platform"] }, "maxUses": { "type": "number", @@ -28224,10 +26459,7 @@ }, "codes": { "description": "The generated codes, ready to share", - "example": [ - "SAVE20AB", - "SAVE20CD" - ], + "example": ["SAVE20AB", "SAVE20CD"], "type": "array", "items": { "type": "string" @@ -28240,12 +26472,7 @@ } } }, - "required": [ - "batchId", - "count", - "codes", - "items" - ] + "required": ["batchId", "count", "codes", "items"] }, "DiscountCodePageDto": { "type": "object", @@ -28257,9 +26484,7 @@ } } }, - "required": [ - "items" - ] + "required": ["items"] }, "DiscountReportSummaryDto": { "type": "object", @@ -28288,13 +26513,7 @@ "example": 70000 } }, - "required": [ - "totalCodes", - "totalRedemptions", - "totalDiscountAmount", - "totalPlatformAbsorbed", - "totalOrganizerAbsorbed" - ] + "required": ["totalCodes", "totalRedemptions", "totalDiscountAmount", "totalPlatformAbsorbed", "totalOrganizerAbsorbed"] }, "DiscountRedemptionResponseDto": { "type": "object", @@ -28345,10 +26564,7 @@ }, "bearer": { "type": "string", - "enum": [ - "organizer", - "platform" - ] + "enum": ["organizer", "platform"] }, "platformAbsorbedAmount": { "type": "number", @@ -28389,9 +26605,7 @@ } } }, - "required": [ - "items" - ] + "required": ["items"] }, "DiscountManagementBootstrapResponseDto": { "type": "object", @@ -28406,11 +26620,7 @@ "$ref": "#/components/schemas/DiscountRedemptionPageDto" } }, - "required": [ - "codes", - "report", - "redemptions" - ] + "required": ["codes", "report", "redemptions"] }, "UpdateDiscountCodeDto": { "type": "object", @@ -28421,16 +26631,11 @@ "example": false } }, - "required": [ - "isActive" - ] + "required": ["isActive"] }, "TrafficSource": { "type": "string", - "enum": [ - "instagram", - "telegram" - ], + "enum": ["instagram", "telegram"], "description": "First-touch attribution from a tagged share link. Ignored if invalid." }, "CreateBookingDto": { @@ -28593,9 +26798,7 @@ "description": "Cancellation reason — mandatory (booking-cancellation-refund.md: required from the product’s point of view, previously only optional in this DTO)." } }, - "required": [ - "cancellationReason" - ] + "required": ["cancellationReason"] }, "JoinWaitlistDto": { "type": "object", @@ -28612,14 +26815,7 @@ }, "WaitlistStatus": { "type": "string", - "enum": [ - "waiting", - "notified", - "accepted", - "expired", - "cancelled", - "converted" - ] + "enum": ["waiting", "notified", "accepted", "expired", "cancelled", "converted"] }, "WaitlistResponseDto": { "type": "object", @@ -28667,14 +26863,7 @@ "type": "string" } }, - "required": [ - "id", - "eventId", - "userId", - "status", - "createdAt", - "updatedAt" - ] + "required": ["id", "eventId", "userId", "status", "createdAt", "updatedAt"] }, "WaitlistAcceptedBookingDto": { "type": "object", @@ -28739,16 +26928,7 @@ "type": "string" } }, - "required": [ - "id", - "eventId", - "userId", - "bookingCode", - "status", - "cancellationReason", - "createdAt", - "updatedAt" - ] + "required": ["id", "eventId", "userId", "bookingCode", "status", "cancellationReason", "createdAt", "updatedAt"] }, "WaitlistAcceptResponseDto": { "type": "object", @@ -28761,10 +26941,7 @@ "$ref": "#/components/schemas/WaitlistAcceptedBookingDto" } }, - "required": [ - "waitlistEntryId", - "booking" - ] + "required": ["waitlistEntryId", "booking"] }, "AdminBookingEventDto": { "type": "object", @@ -28792,13 +26969,7 @@ "format": "uuid" } }, - "required": [ - "id", - "title", - "startsAt", - "status", - "organizerId" - ] + "required": ["id", "title", "startsAt", "status", "organizerId"] }, "AdminBookingUserDto": { "type": "object", @@ -28819,10 +26990,7 @@ "nullable": true } }, - "required": [ - "id", - "mobile" - ] + "required": ["id", "mobile"] }, "AdminBookingResponseDto": { "type": "object", @@ -29101,10 +27269,7 @@ "maxLength": 5000 } }, - "required": [ - "bookingId", - "rating" - ] + "required": ["bookingId", "rating"] }, "UpdateReviewDto": { "type": "object", @@ -29152,10 +27317,7 @@ "example": "Tehran hiking meetup" } }, - "required": [ - "id", - "title" - ] + "required": ["id", "title"] }, "AdminReviewResponseDto": { "type": "object", @@ -29248,19 +27410,7 @@ ] } }, - "required": [ - "id", - "eventId", - "userId", - "bookingId", - "rating", - "body", - "status", - "createdAt", - "updatedAt", - "user", - "event" - ] + "required": ["id", "eventId", "userId", "bookingId", "rating", "body", "status", "createdAt", "updatedAt", "user", "event"] }, "UnreadCountResponseDto": { "type": "object", @@ -29271,16 +27421,11 @@ "example": 3 } }, - "required": [ - "totalUnread" - ] + "required": ["totalUnread"] }, "ConversationType": { "type": "string", - "enum": [ - "event_group", - "direct" - ], + "enum": ["event_group", "direct"], "description": "Conversation type." }, "ConversationResponseDto": { @@ -29375,14 +27520,7 @@ "format": "date-time" } }, - "required": [ - "id", - "type", - "unreadCount", - "memberCount", - "messagingBlocked", - "createdAt" - ] + "required": ["id", "type", "unreadCount", "memberCount", "messagingBlocked", "createdAt"] }, "SendMessageDto": { "type": "object", @@ -29441,13 +27579,7 @@ "description": "True when the parent cannot be jumped to (soft-deleted, missing, or wrong conversation)." } }, - "required": [ - "id", - "senderId", - "senderDisplayName", - "hasImage", - "isUnavailable" - ] + "required": ["id", "senderId", "senderDisplayName", "hasImage", "isUnavailable"] }, "MessageResponseDto": { "type": "object", @@ -29529,12 +27661,7 @@ "format": "date-time" } }, - "required": [ - "id", - "conversationId", - "senderId", - "createdAt" - ] + "required": ["id", "conversationId", "senderId", "createdAt"] }, "ConversationParticipantResponseDto": { "type": "object", @@ -29581,10 +27708,7 @@ "format": "date-time" } }, - "required": [ - "userId", - "joinedAt" - ] + "required": ["userId", "joinedAt"] }, "MarkConversationReadDto": { "type": "object", @@ -29595,9 +27719,7 @@ "format": "uuid" } }, - "required": [ - "lastSeenMessageId" - ] + "required": ["lastSeenMessageId"] }, "AdminChatUserDto": { "type": "object", @@ -29645,12 +27767,7 @@ "format": "date-time" } }, - "required": [ - "userId", - "mobile", - "status", - "joinedAt" - ] + "required": ["userId", "mobile", "status", "joinedAt"] }, "AdminConversationResponseDto": { "type": "object", @@ -29704,13 +27821,7 @@ "format": "date-time" } }, - "required": [ - "id", - "type", - "participantPreview", - "memberCount", - "createdAt" - ] + "required": ["id", "type", "participantPreview", "memberCount", "createdAt"] }, "AdminMessageResponseDto": { "type": "object", @@ -29776,13 +27887,7 @@ "format": "date-time" } }, - "required": [ - "id", - "conversationId", - "senderId", - "senderMobile", - "createdAt" - ] + "required": ["id", "conversationId", "senderId", "senderMobile", "createdAt"] }, "CreateContactMessageDto": { "type": "object", @@ -29821,13 +27926,7 @@ "maxLength": 4096 } }, - "required": [ - "fullName", - "mobile", - "subject", - "message", - "arcaptchaToken" - ] + "required": ["fullName", "mobile", "subject", "message", "arcaptchaToken"] }, "ContactMessageResponseDto": { "type": "object", @@ -29879,24 +27978,14 @@ "format": "date-time" } }, - "required": [ - "id", - "fullName", - "mobile", - "subject", - "message", - "createdAt" - ] + "required": ["id", "fullName", "mobile", "subject", "message", "createdAt"] }, "CreateTrafficVisitDto": { "type": "object", "properties": { "pageKind": { "type": "string", - "enum": [ - "home", - "event" - ] + "enum": ["home", "event"] }, "eventId": { "type": "string", @@ -29916,11 +28005,7 @@ "description": "Durable anonymous visitor id from the browser localStorage." } }, - "required": [ - "pageKind", - "source", - "visitorKey" - ] + "required": ["pageKind", "source", "visitorKey"] }, "CreateUserBlockDto": { "type": "object", @@ -29932,9 +28017,7 @@ "format": "uuid" } }, - "required": [ - "blockedId" - ] + "required": ["blockedId"] }, "UserBlockUserSummaryDto": { "type": "object", @@ -29952,10 +28035,7 @@ "nullable": true } }, - "required": [ - "firstName", - "lastName" - ] + "required": ["firstName", "lastName"] }, "UserBlockResponseDto": { "type": "object", @@ -29993,13 +28073,7 @@ ] } }, - "required": [ - "id", - "blockerId", - "blockedId", - "createdAt", - "blockedUser" - ] + "required": ["id", "blockerId", "blockedId", "createdAt", "blockedUser"] }, "ReportReasonResponseDto": { "type": "object", @@ -30031,12 +28105,7 @@ "minimum": 0 } }, - "required": [ - "id", - "code", - "label", - "sortOrder" - ] + "required": ["id", "code", "label", "sortOrder"] }, "CreateUserReportDto": { "type": "object", @@ -30066,17 +28135,11 @@ "format": "uuid" } }, - "required": [ - "reportedId" - ] + "required": ["reportedId"] }, "ReportStatus": { "type": "string", - "enum": [ - "pending", - "reviewed", - "dismissed" - ], + "enum": ["pending", "reviewed", "dismissed"], "description": "Report review status." }, "UserReportResponseDto": { @@ -30169,13 +28232,7 @@ "format": "date-time" } }, - "required": [ - "id", - "reporterId", - "reportedId", - "status", - "createdAt" - ] + "required": ["id", "reporterId", "reportedId", "status", "createdAt"] }, "UserReportUserSummaryDto": { "type": "object", @@ -30198,11 +28255,7 @@ "nullable": true } }, - "required": [ - "mobile", - "firstName", - "lastName" - ] + "required": ["mobile", "firstName", "lastName"] }, "AdminUserReportResponseDto": { "type": "object", @@ -30318,15 +28371,7 @@ ] } }, - "required": [ - "id", - "reporterId", - "reportedId", - "status", - "createdAt", - "reporter", - "reported" - ] + "required": ["id", "reporterId", "reportedId", "status", "createdAt", "reporter", "reported"] }, "AdminUserReportBlockResponseDto": { "type": "object", @@ -30348,10 +28393,7 @@ ] } }, - "required": [ - "report", - "block" - ] + "required": ["report", "block"] }, "CreateSupportTicketDto": { "type": "object", @@ -30362,24 +28404,12 @@ }, "category": { "type": "string", - "enum": [ - "general", - "account", - "event", - "booking", - "payment", - "technical" - ], + "enum": ["general", "account", "event", "booking", "payment", "technical"], "example": "payment" }, "priority": { "type": "string", - "enum": [ - "low", - "normal", - "high", - "urgent" - ], + "enum": ["low", "normal", "high", "urgent"], "example": "normal" }, "message": { @@ -30387,12 +28417,7 @@ "example": "پرداخت انجام شد اما رزرو ثبت نشده است." } }, - "required": [ - "subject", - "category", - "priority", - "message" - ] + "required": ["subject", "category", "priority", "message"] }, "SupportTicketUserResponseDto": { "type": "object", @@ -30407,9 +28432,7 @@ "example": "علی رضایی" } }, - "required": [ - "mobile" - ] + "required": ["mobile"] }, "SupportTicketMessageResponseDto": { "type": "object", @@ -30433,13 +28456,7 @@ "format": "date-time" } }, - "required": [ - "id", - "senderId", - "body", - "isAdmin", - "createdAt" - ] + "required": ["id", "senderId", "body", "isAdmin", "createdAt"] }, "SupportTicketResponseDto": { "type": "object", @@ -30457,32 +28474,15 @@ }, "category": { "type": "string", - "enum": [ - "general", - "account", - "event", - "booking", - "payment", - "technical" - ] + "enum": ["general", "account", "event", "booking", "payment", "technical"] }, "priority": { "type": "string", - "enum": [ - "low", - "normal", - "high", - "urgent" - ] + "enum": ["low", "normal", "high", "urgent"] }, "status": { "type": "string", - "enum": [ - "open", - "waiting_admin", - "waiting_user", - "closed" - ] + "enum": ["open", "waiting_admin", "waiting_user", "closed"] }, "lastMessageAt": { "type": "string", @@ -30507,18 +28507,7 @@ } } }, - "required": [ - "id", - "userId", - "subject", - "category", - "priority", - "status", - "lastMessageAt", - "createdAt", - "user", - "messages" - ] + "required": ["id", "userId", "subject", "category", "priority", "status", "lastMessageAt", "createdAt", "user", "messages"] }, "SupportTicketSummaryResponseDto": { "type": "object", @@ -30536,32 +28525,15 @@ }, "category": { "type": "string", - "enum": [ - "general", - "account", - "event", - "booking", - "payment", - "technical" - ] + "enum": ["general", "account", "event", "booking", "payment", "technical"] }, "priority": { "type": "string", - "enum": [ - "low", - "normal", - "high", - "urgent" - ] + "enum": ["low", "normal", "high", "urgent"] }, "status": { "type": "string", - "enum": [ - "open", - "waiting_admin", - "waiting_user", - "closed" - ] + "enum": ["open", "waiting_admin", "waiting_user", "closed"] }, "lastMessageAt": { "type": "string", @@ -30590,17 +28562,7 @@ ] } }, - "required": [ - "id", - "userId", - "subject", - "category", - "priority", - "status", - "lastMessageAt", - "createdAt", - "user" - ] + "required": ["id", "userId", "subject", "category", "priority", "status", "lastMessageAt", "createdAt", "user"] }, "ReplySupportTicketDto": { "type": "object", @@ -30610,26 +28572,17 @@ "example": "درخواست شما در حال بررسی است." } }, - "required": [ - "message" - ] + "required": ["message"] }, "UpdateSupportTicketStatusDto": { "type": "object", "properties": { "status": { "type": "string", - "enum": [ - "open", - "waiting_admin", - "waiting_user", - "closed" - ] + "enum": ["open", "waiting_admin", "waiting_user", "closed"] } }, - "required": [ - "status" - ] + "required": ["status"] }, "UserCountsDto": { "type": "object", @@ -30651,12 +28604,7 @@ "example": 12 } }, - "required": [ - "total", - "active", - "pending", - "suspended" - ] + "required": ["total", "active", "pending", "suspended"] }, "EventStatusCountsDto": { "type": "object", @@ -30690,15 +28638,7 @@ "example": 210 } }, - "required": [ - "draft", - "pending_review", - "published", - "full", - "rejected", - "cancelled", - "completed" - ] + "required": ["draft", "pending_review", "published", "full", "rejected", "cancelled", "completed"] }, "EventCountsDto": { "type": "object", @@ -30721,12 +28661,7 @@ "$ref": "#/components/schemas/EventStatusCountsDto" } }, - "required": [ - "total", - "active", - "totalHeld", - "byStatus" - ] + "required": ["total", "active", "totalHeld", "byStatus"] }, "BookingStatusCountsDto": { "type": "object", @@ -30756,14 +28691,7 @@ "example": 25 } }, - "required": [ - "pending_payment", - "confirmed", - "cancelled", - "expired", - "refunded", - "no_show" - ] + "required": ["pending_payment", "confirmed", "cancelled", "expired", "refunded", "no_show"] }, "BookingCountsDto": { "type": "object", @@ -30776,10 +28704,7 @@ "$ref": "#/components/schemas/BookingStatusCountsDto" } }, - "required": [ - "total", - "byStatus" - ] + "required": ["total", "byStatus"] }, "IdentityVerificationCountsDto": { "type": "object", @@ -30801,12 +28726,7 @@ "example": 29 } }, - "required": [ - "none", - "pending", - "verified", - "rejected" - ] + "required": ["none", "pending", "verified", "rejected"] }, "FinancialTotalsDto": { "type": "object", @@ -30822,10 +28742,7 @@ "description": "Sum of wallets.balance across all wallets (Toman, as a string)." } }, - "required": [ - "totalCommissionCollected", - "totalWalletBalance" - ] + "required": ["totalCommissionCollected", "totalWalletBalance"] }, "AdminReportsOverviewDto": { "type": "object", @@ -30846,13 +28763,7 @@ "$ref": "#/components/schemas/FinancialTotalsDto" } }, - "required": [ - "users", - "events", - "bookings", - "identityVerifications", - "financial" - ] + "required": ["users", "events", "bookings", "identityVerifications", "financial"] }, "AdminUserContactLinkDto": { "type": "object", @@ -30885,22 +28796,11 @@ "type": "number" } }, - "required": [ - "id", - "channel", - "label", - "value", - "url", - "isPublic", - "displayOrder" - ] + "required": ["id", "channel", "label", "value", "url", "isPublic", "displayOrder"] }, "HostPlan": { "type": "string", - "enum": [ - "free", - "unlimited" - ] + "enum": ["free", "unlimited"] }, "AdminUserSummaryCountsDto": { "type": "object", @@ -31034,12 +28934,7 @@ }, "identityStatus": { "type": "string", - "enum": [ - "none", - "pending", - "verified", - "rejected" - ] + "enum": ["none", "pending", "verified", "rejected"] }, "identityVerifiedAt": { "type": "string", @@ -31113,9 +29008,7 @@ "description": "Optional admin note (Toman credit reason)" } }, - "required": [ - "amount" - ] + "required": ["amount"] }, "AdminCreditWalletResponseDto": { "type": "object", @@ -31128,10 +29021,7 @@ "$ref": "#/components/schemas/WalletTransactionResponseDto" } }, - "required": [ - "walletBalance", - "transaction" - ] + "required": ["walletBalance", "transaction"] }, "AdminUserHostedEventDto": { "type": "object", @@ -31175,18 +29065,7 @@ "type": "string" } }, - "required": [ - "id", - "title", - "status", - "startsAt", - "endsAt", - "capacity", - "bookedCount", - "isFree", - "price", - "createdAt" - ] + "required": ["id", "title", "status", "startsAt", "endsAt", "capacity", "bookedCount", "isFree", "price", "createdAt"] }, "AdminUserBookingDto": { "type": "object", @@ -31232,14 +29111,7 @@ "type": "string" } }, - "required": [ - "id", - "bookingCode", - "status", - "eventId", - "eventTitle", - "createdAt" - ] + "required": ["id", "bookingCode", "status", "eventId", "eventTitle", "createdAt"] }, "AdminUserPaymentDto": { "type": "object", @@ -31356,15 +29228,7 @@ "type": "string" } }, - "required": [ - "id", - "rating", - "status", - "eventId", - "eventTitle", - "authorId", - "createdAt" - ] + "required": ["id", "rating", "status", "eventId", "eventTitle", "authorId", "createdAt"] }, "AdminUserFollowDto": { "type": "object", @@ -31392,13 +29256,7 @@ "type": "string" } }, - "required": [ - "id", - "userId", - "mobile", - "notifyNewEvents", - "createdAt" - ] + "required": ["id", "userId", "mobile", "notifyNewEvents", "createdAt"] }, "AdminUserReportDto": { "type": "object", @@ -31438,13 +29296,7 @@ "type": "string" } }, - "required": [ - "id", - "status", - "otherUserId", - "otherUserMobile", - "createdAt" - ] + "required": ["id", "status", "otherUserId", "otherUserMobile", "createdAt"] }, "AdminUserBlockDto": { "type": "object", @@ -31469,12 +29321,7 @@ "type": "string" } }, - "required": [ - "id", - "otherUserId", - "otherUserMobile", - "createdAt" - ] + "required": ["id", "otherUserId", "otherUserMobile", "createdAt"] }, "AdminAuditLogResponseDto": { "type": "object", @@ -31530,14 +29377,7 @@ "format": "date-time" } }, - "required": [ - "id", - "method", - "path", - "params", - "statusCode", - "createdAt" - ] + "required": ["id", "method", "path", "params", "statusCode", "createdAt"] }, "UploadFileResponseDto": { "type": "object", @@ -31553,10 +29393,7 @@ "example": "http://localhost:3000/uploads/files/550e8400-e29b-41d4-a716-446655440000.jpg" } }, - "required": [ - "id", - "url" - ] + "required": ["id", "url"] }, "BlogArticleCitySummaryDto": { "type": "object", @@ -31574,11 +29411,7 @@ "example": "اهواز" } }, - "required": [ - "id", - "slug", - "name" - ] + "required": ["id", "slug", "name"] }, "BlogArticleEventCategorySummaryDto": { "type": "object", @@ -31596,11 +29429,7 @@ "example": "عکاسی" } }, - "required": [ - "id", - "slug", - "name" - ] + "required": ["id", "slug", "name"] }, "BlogArticleSummaryResponseDto": { "type": "object", @@ -31830,12 +29659,7 @@ }, "categorySlug": { "type": "string", - "enum": [ - "attendee-guide", - "hosting", - "city-guides", - "event-selection" - ], + "enum": ["attendee-guide", "hosting", "city-guides", "event-selection"], "example": "city-guides" }, "categoryName": { @@ -31873,14 +29697,7 @@ "format": "date-time" } }, - "required": [ - "slug", - "title", - "excerpt", - "categorySlug", - "categoryName", - "bodyHtml" - ] + "required": ["slug", "title", "excerpt", "categorySlug", "categoryName", "bodyHtml"] }, "UpdateBlogArticleDto": { "type": "object", @@ -31909,12 +29726,7 @@ }, "categorySlug": { "type": "string", - "enum": [ - "attendee-guide", - "hosting", - "city-guides", - "event-selection" - ], + "enum": ["attendee-guide", "hosting", "city-guides", "event-selection"], "example": "city-guides" }, "categoryName": { @@ -31962,9 +29774,7 @@ "example": "ok" } }, - "required": [ - "status" - ] + "required": ["status"] } } } diff --git a/services/events.ts b/services/events.ts index 6a92e83..d76ca5d 100644 --- a/services/events.ts +++ b/services/events.ts @@ -95,8 +95,11 @@ export async function deleteEventAsAdmin(eventId: string): Promise return unwrapApiPayload(response.data) } -export async function updateEventReservedCapacity(eventId: string, reservedCapacity: number): Promise { - const response = await axiosInstance.patch(API_ROUTES.EVENTS.ADMIN_RESERVED_CAPACITY(eventId), { reservedCapacity }) +export async function updateEventReservedCapacity( + eventId: string, + payload: { reservedCapacity: number; capacity?: number } +): Promise { + const response = await axiosInstance.patch(API_ROUTES.EVENTS.ADMIN_RESERVED_CAPACITY(eventId), payload) return unwrapApiPayload(response.data) }