{ "openapi": "3.1.0", "info": { "title": "Voyant Operator API", "version": "0.0.0", "description": "Generated from the composed operator app. Do not edit by hand." }, "servers": [ { "url": "/", "description": "This deployment (same origin)" } ], "components": { "schemas": { "CatalogSearchFilter": { "anyOf": [ { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "eq" ] }, "field": { "type": "string", "minLength": 1 }, "value": { "anyOf": [ { "type": "string" }, { "type": "number" }, { "type": "boolean" } ] } }, "required": [ "kind", "field", "value" ] }, { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "in" ] }, "field": { "type": "string", "minLength": 1 }, "values": { "type": "array", "items": { "anyOf": [ { "type": "string" }, { "type": "number" } ] } } }, "required": [ "kind", "field", "values" ] }, { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "range" ] }, "field": { "type": "string", "minLength": 1 }, "gte": { "type": "number" }, "lte": { "type": "number" } }, "required": [ "kind", "field" ] }, { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "and" ] }, "clauses": { "type": "array", "items": { "$ref": "#/components/schemas/CatalogSearchFilter" } } }, "required": [ "kind", "clauses" ] }, { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "or" ] }, "clauses": { "type": "array", "items": { "$ref": "#/components/schemas/CatalogSearchFilter" } } }, "required": [ "kind", "clauses" ] } ] } }, "parameters": {} }, "paths": { "/v1/admin/operations/availability/aggregates": { "get": { "description": "Dashboard KPI aggregates over availability slots, served from a read-through TTL snapshot (#1629). The optional `from`/`to` ISO-datetime query window is anchored on each slot's `startsAt`.", "parameters": [ { "schema": { "type": "string", "format": "date-time" }, "required": false, "name": "from", "in": "query" }, { "schema": { "type": "string", "format": "date-time" }, "required": false, "name": "to", "in": "query" } ], "responses": { "200": { "description": "Availability dashboard aggregates", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "total": { "type": "integer" }, "countsByStatus": { "type": "array", "items": { "type": "object", "properties": { "status": { "type": "string", "enum": [ "open", "closed", "sold_out", "cancelled" ] }, "count": { "type": "integer" } }, "required": [ "status", "count" ] } }, "upcomingSlots": { "type": "integer" }, "upcomingPax": { "type": "integer" }, "monthlyDepartures": { "type": "array", "items": { "type": "object", "properties": { "yearMonth": { "type": "string" }, "count": { "type": "integer" } }, "required": [ "yearMonth", "count" ] } } }, "required": [ "total", "countsByStatus", "upcomingSlots", "upcomingPax", "monthlyDepartures" ] } }, "required": [ "data" ] } } } } }, "operationId": "getAdminOperationsAvailabilityAggregates", "summary": "GET /v1/admin/operations/availability/aggregates", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/availability/overview": { "get": { "description": "Availability operations overview — open / constrained slot counts, active rule and pickup-point counts, products lacking upcoming departures, and the next constrained slots needing attention (`attentionLimit`, default 4).", "parameters": [ { "schema": { "type": "string" }, "required": false, "name": "productId", "in": "query" }, { "schema": { "type": "integer", "minimum": 1, "maximum": 20, "default": 4 }, "required": false, "name": "attentionLimit", "in": "query" } ], "responses": { "200": { "description": "Availability overview read-model", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "openSlotsCount": { "type": "integer" }, "constrainedSlotsCount": { "type": "integer" }, "activeRulesCount": { "type": "integer" }, "activePickupPointsCount": { "type": "integer" }, "productsWithoutUpcomingDeparturesCount": { "type": "integer" }, "productsWithoutUpcomingDepartures": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" } }, "required": [ "id", "name" ] } }, "constrainedSlots": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "productId": { "type": "string" }, "itineraryId": { "type": [ "string", "null" ] }, "optionId": { "type": [ "string", "null" ] }, "facilityId": { "type": [ "string", "null" ] }, "availabilityRuleId": { "type": [ "string", "null" ] }, "startTimeId": { "type": [ "string", "null" ] }, "dateLocal": { "type": "string" }, "startsAt": { "type": "string" }, "endsAt": { "type": [ "string", "null" ] }, "timezone": { "type": "string" }, "status": { "type": "string", "enum": [ "open", "closed", "sold_out", "cancelled" ] }, "unlimited": { "type": "boolean" }, "initialPax": { "type": [ "integer", "null" ] }, "remainingPax": { "type": [ "integer", "null" ] }, "initialPickups": { "type": [ "integer", "null" ] }, "remainingPickups": { "type": [ "integer", "null" ] }, "remainingResources": { "type": [ "integer", "null" ] }, "pastCutoff": { "type": "boolean" }, "tooEarly": { "type": "boolean" }, "nights": { "type": [ "integer", "null" ] }, "days": { "type": [ "integer", "null" ] }, "notes": { "type": [ "string", "null" ] }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" }, "productName": { "type": [ "string", "null" ] } }, "required": [ "id", "productId", "itineraryId", "optionId", "facilityId", "availabilityRuleId", "startTimeId", "dateLocal", "startsAt", "endsAt", "timezone", "status", "unlimited", "initialPax", "remainingPax", "initialPickups", "remainingPickups", "remainingResources", "pastCutoff", "tooEarly", "nights", "days", "notes", "createdAt", "updatedAt", "productName" ] } } }, "required": [ "openSlotsCount", "constrainedSlotsCount", "activeRulesCount", "activePickupPointsCount", "productsWithoutUpcomingDeparturesCount", "productsWithoutUpcomingDepartures", "constrainedSlots" ] } }, "required": [ "data" ] } } } } }, "operationId": "getAdminOperationsAvailabilityOverview", "summary": "GET /v1/admin/operations/availability/overview", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/availability/rules": { "get": { "parameters": [ { "schema": { "type": "integer", "minimum": 1, "maximum": 200, "default": 50 }, "required": false, "name": "limit", "in": "query" }, { "schema": { "type": [ "integer", "null" ], "minimum": 0, "default": 0 }, "required": false, "name": "offset", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "productId", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "optionId", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "facilityId", "in": "query" }, { "schema": { "type": "string", "enum": [ "0", "1", "true", "false" ] }, "required": false, "name": "active", "in": "query" } ], "responses": { "200": { "description": "Paginated availability recurrence rules", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "productId": { "type": "string" }, "optionId": { "type": [ "string", "null" ] }, "facilityId": { "type": [ "string", "null" ] }, "timezone": { "type": "string" }, "recurrenceRule": { "type": "string" }, "maxCapacity": { "type": "integer" }, "maxPickupCapacity": { "type": [ "integer", "null" ] }, "minTotalPax": { "type": [ "integer", "null" ] }, "cutoffMinutes": { "type": [ "integer", "null" ] }, "earlyBookingLimitMinutes": { "type": [ "integer", "null" ] }, "active": { "type": "boolean" }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" }, "productName": { "type": [ "string", "null" ] } }, "required": [ "id", "productId", "optionId", "facilityId", "timezone", "recurrenceRule", "maxCapacity", "maxPickupCapacity", "minTotalPax", "cutoffMinutes", "earlyBookingLimitMinutes", "active", "createdAt", "updatedAt" ] } }, "total": { "type": "integer" }, "limit": { "type": "integer" }, "offset": { "type": "integer" } }, "required": [ "data", "total", "limit", "offset" ] } } } } }, "operationId": "getAdminOperationsAvailabilityRules", "summary": "GET /v1/admin/operations/availability/rules", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "post": { "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "productId": { "type": "string" }, "optionId": { "type": [ "string", "null" ] }, "facilityId": { "type": [ "string", "null" ] }, "timezone": { "type": "string", "minLength": 1 }, "recurrenceRule": { "type": "string", "minLength": 1 }, "maxCapacity": { "type": "integer", "minimum": 0 }, "maxPickupCapacity": { "type": [ "integer", "null" ], "minimum": 0 }, "minTotalPax": { "type": [ "integer", "null" ], "minimum": 0 }, "cutoffMinutes": { "type": [ "integer", "null" ], "minimum": 0 }, "earlyBookingLimitMinutes": { "type": [ "integer", "null" ], "minimum": 0 }, "active": { "type": "boolean", "default": true } }, "required": [ "productId", "timezone", "recurrenceRule", "maxCapacity" ] } } } }, "responses": { "201": { "description": "The created availability rule", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "productId": { "type": "string" }, "optionId": { "type": [ "string", "null" ] }, "facilityId": { "type": [ "string", "null" ] }, "timezone": { "type": "string" }, "recurrenceRule": { "type": "string" }, "maxCapacity": { "type": "integer" }, "maxPickupCapacity": { "type": [ "integer", "null" ] }, "minTotalPax": { "type": [ "integer", "null" ] }, "cutoffMinutes": { "type": [ "integer", "null" ] }, "earlyBookingLimitMinutes": { "type": [ "integer", "null" ] }, "active": { "type": "boolean" }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "productId", "optionId", "facilityId", "timezone", "recurrenceRule", "maxCapacity", "maxPickupCapacity", "minTotalPax", "cutoffMinutes", "earlyBookingLimitMinutes", "active", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "postAdminOperationsAvailabilityRules", "summary": "POST /v1/admin/operations/availability/rules", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/availability/rules/batch-update": { "post": { "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "ids": { "type": "array", "items": { "type": "string" }, "minItems": 1, "maxItems": 200 }, "patch": { "type": "object", "properties": { "productId": { "type": "string" }, "optionId": { "type": [ "string", "null" ] }, "facilityId": { "type": [ "string", "null" ] }, "timezone": { "type": "string", "minLength": 1 }, "recurrenceRule": { "type": "string", "minLength": 1 }, "maxCapacity": { "type": "integer", "minimum": 0 }, "maxPickupCapacity": { "type": [ "integer", "null" ], "minimum": 0 }, "minTotalPax": { "type": [ "integer", "null" ], "minimum": 0 }, "cutoffMinutes": { "type": [ "integer", "null" ], "minimum": 0 }, "earlyBookingLimitMinutes": { "type": [ "integer", "null" ], "minimum": 0 }, "active": { "type": "boolean", "default": true } } } }, "required": [ "ids", "patch" ] } } } }, "responses": { "200": { "description": "Per-id batch-update results (missing ids reported under `failed`)", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "productId": { "type": "string" }, "optionId": { "type": [ "string", "null" ] }, "facilityId": { "type": [ "string", "null" ] }, "timezone": { "type": "string" }, "recurrenceRule": { "type": "string" }, "maxCapacity": { "type": "integer" }, "maxPickupCapacity": { "type": [ "integer", "null" ] }, "minTotalPax": { "type": [ "integer", "null" ] }, "cutoffMinutes": { "type": [ "integer", "null" ] }, "earlyBookingLimitMinutes": { "type": [ "integer", "null" ] }, "active": { "type": "boolean" }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "productId", "optionId", "facilityId", "timezone", "recurrenceRule", "maxCapacity", "maxPickupCapacity", "minTotalPax", "cutoffMinutes", "earlyBookingLimitMinutes", "active", "createdAt", "updatedAt" ] } }, "total": { "type": "integer" }, "succeeded": { "type": "integer" }, "failed": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "error": { "type": "string" } }, "required": [ "id", "error" ] } } }, "required": [ "data", "total", "succeeded", "failed" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "postAdminOperationsAvailabilityRulesBatchUpdate", "summary": "POST /v1/admin/operations/availability/rules/batch-update", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/availability/rules/batch-delete": { "post": { "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "ids": { "type": "array", "items": { "type": "string" }, "minItems": 1, "maxItems": 200 } }, "required": [ "ids" ] } } } }, "responses": { "200": { "description": "Per-id batch-delete results (missing ids reported under `failed`)", "content": { "application/json": { "schema": { "type": "object", "properties": { "deletedIds": { "type": "array", "items": { "type": "string" } }, "total": { "type": "integer" }, "succeeded": { "type": "integer" }, "failed": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "error": { "type": "string" } }, "required": [ "id", "error" ] } } }, "required": [ "deletedIds", "total", "succeeded", "failed" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "postAdminOperationsAvailabilityRulesBatchDelete", "summary": "POST /v1/admin/operations/availability/rules/batch-delete", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/availability/rules/{id}": { "get": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "An availability rule by id", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "productId": { "type": "string" }, "optionId": { "type": [ "string", "null" ] }, "facilityId": { "type": [ "string", "null" ] }, "timezone": { "type": "string" }, "recurrenceRule": { "type": "string" }, "maxCapacity": { "type": "integer" }, "maxPickupCapacity": { "type": [ "integer", "null" ] }, "minTotalPax": { "type": [ "integer", "null" ] }, "cutoffMinutes": { "type": [ "integer", "null" ] }, "earlyBookingLimitMinutes": { "type": [ "integer", "null" ] }, "active": { "type": "boolean" }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "productId", "optionId", "facilityId", "timezone", "recurrenceRule", "maxCapacity", "maxPickupCapacity", "minTotalPax", "cutoffMinutes", "earlyBookingLimitMinutes", "active", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "404": { "description": "Availability rule not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "getAdminOperationsAvailabilityRulesById", "summary": "GET /v1/admin/operations/availability/rules/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "patch": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "productId": { "type": "string" }, "optionId": { "type": [ "string", "null" ] }, "facilityId": { "type": [ "string", "null" ] }, "timezone": { "type": "string", "minLength": 1 }, "recurrenceRule": { "type": "string", "minLength": 1 }, "maxCapacity": { "type": "integer", "minimum": 0 }, "maxPickupCapacity": { "type": [ "integer", "null" ], "minimum": 0 }, "minTotalPax": { "type": [ "integer", "null" ], "minimum": 0 }, "cutoffMinutes": { "type": [ "integer", "null" ], "minimum": 0 }, "earlyBookingLimitMinutes": { "type": [ "integer", "null" ], "minimum": 0 }, "active": { "type": "boolean", "default": true } } } } } }, "responses": { "200": { "description": "The updated availability rule", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "productId": { "type": "string" }, "optionId": { "type": [ "string", "null" ] }, "facilityId": { "type": [ "string", "null" ] }, "timezone": { "type": "string" }, "recurrenceRule": { "type": "string" }, "maxCapacity": { "type": "integer" }, "maxPickupCapacity": { "type": [ "integer", "null" ] }, "minTotalPax": { "type": [ "integer", "null" ] }, "cutoffMinutes": { "type": [ "integer", "null" ] }, "earlyBookingLimitMinutes": { "type": [ "integer", "null" ] }, "active": { "type": "boolean" }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "productId", "optionId", "facilityId", "timezone", "recurrenceRule", "maxCapacity", "maxPickupCapacity", "minTotalPax", "cutoffMinutes", "earlyBookingLimitMinutes", "active", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Availability rule not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "patchAdminOperationsAvailabilityRulesById", "summary": "PATCH /v1/admin/operations/availability/rules/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "delete": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "Availability rule deleted", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] } }, "required": [ "success" ] } } } }, "404": { "description": "Availability rule not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "deleteAdminOperationsAvailabilityRulesById", "summary": "DELETE /v1/admin/operations/availability/rules/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/availability/start-times": { "get": { "parameters": [ { "schema": { "type": "integer", "minimum": 1, "maximum": 200, "default": 50 }, "required": false, "name": "limit", "in": "query" }, { "schema": { "type": [ "integer", "null" ], "minimum": 0, "default": 0 }, "required": false, "name": "offset", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "productId", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "optionId", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "facilityId", "in": "query" }, { "schema": { "type": "string", "enum": [ "0", "1", "true", "false" ] }, "required": false, "name": "active", "in": "query" } ], "responses": { "200": { "description": "Paginated availability start times", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "productId": { "type": "string" }, "optionId": { "type": [ "string", "null" ] }, "facilityId": { "type": [ "string", "null" ] }, "label": { "type": [ "string", "null" ] }, "startTimeLocal": { "type": "string" }, "durationMinutes": { "type": [ "integer", "null" ] }, "sortOrder": { "type": "integer" }, "active": { "type": "boolean" }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" }, "productName": { "type": [ "string", "null" ] } }, "required": [ "id", "productId", "optionId", "facilityId", "label", "startTimeLocal", "durationMinutes", "sortOrder", "active", "createdAt", "updatedAt" ] } }, "total": { "type": "integer" }, "limit": { "type": "integer" }, "offset": { "type": "integer" } }, "required": [ "data", "total", "limit", "offset" ] } } } } }, "operationId": "getAdminOperationsAvailabilityStartTimes", "summary": "GET /v1/admin/operations/availability/start-times", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "post": { "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "productId": { "type": "string" }, "optionId": { "type": [ "string", "null" ] }, "facilityId": { "type": [ "string", "null" ] }, "label": { "type": [ "string", "null" ] }, "startTimeLocal": { "type": "string", "minLength": 1 }, "durationMinutes": { "type": [ "integer", "null" ], "minimum": 0 }, "sortOrder": { "type": "integer", "default": 0 }, "active": { "type": "boolean", "default": true } }, "required": [ "productId", "startTimeLocal" ] } } } }, "responses": { "201": { "description": "The created start time", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "productId": { "type": "string" }, "optionId": { "type": [ "string", "null" ] }, "facilityId": { "type": [ "string", "null" ] }, "label": { "type": [ "string", "null" ] }, "startTimeLocal": { "type": "string" }, "durationMinutes": { "type": [ "integer", "null" ] }, "sortOrder": { "type": "integer" }, "active": { "type": "boolean" }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "productId", "optionId", "facilityId", "label", "startTimeLocal", "durationMinutes", "sortOrder", "active", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "postAdminOperationsAvailabilityStartTimes", "summary": "POST /v1/admin/operations/availability/start-times", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/availability/start-times/batch-update": { "post": { "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "ids": { "type": "array", "items": { "type": "string" }, "minItems": 1, "maxItems": 200 }, "patch": { "type": "object", "properties": { "productId": { "type": "string" }, "optionId": { "type": [ "string", "null" ] }, "facilityId": { "type": [ "string", "null" ] }, "label": { "type": [ "string", "null" ] }, "startTimeLocal": { "type": "string", "minLength": 1 }, "durationMinutes": { "type": [ "integer", "null" ], "minimum": 0 }, "sortOrder": { "type": "integer", "default": 0 }, "active": { "type": "boolean", "default": true } } } }, "required": [ "ids", "patch" ] } } } }, "responses": { "200": { "description": "Per-id batch-update results (missing ids reported under `failed`)", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "productId": { "type": "string" }, "optionId": { "type": [ "string", "null" ] }, "facilityId": { "type": [ "string", "null" ] }, "label": { "type": [ "string", "null" ] }, "startTimeLocal": { "type": "string" }, "durationMinutes": { "type": [ "integer", "null" ] }, "sortOrder": { "type": "integer" }, "active": { "type": "boolean" }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "productId", "optionId", "facilityId", "label", "startTimeLocal", "durationMinutes", "sortOrder", "active", "createdAt", "updatedAt" ] } }, "total": { "type": "integer" }, "succeeded": { "type": "integer" }, "failed": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "error": { "type": "string" } }, "required": [ "id", "error" ] } } }, "required": [ "data", "total", "succeeded", "failed" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "postAdminOperationsAvailabilityStartTimesBatchUpdate", "summary": "POST /v1/admin/operations/availability/start-times/batch-update", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/availability/start-times/batch-delete": { "post": { "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "ids": { "type": "array", "items": { "type": "string" }, "minItems": 1, "maxItems": 200 } }, "required": [ "ids" ] } } } }, "responses": { "200": { "description": "Per-id batch-delete results (missing ids reported under `failed`)", "content": { "application/json": { "schema": { "type": "object", "properties": { "deletedIds": { "type": "array", "items": { "type": "string" } }, "total": { "type": "integer" }, "succeeded": { "type": "integer" }, "failed": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "error": { "type": "string" } }, "required": [ "id", "error" ] } } }, "required": [ "deletedIds", "total", "succeeded", "failed" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "postAdminOperationsAvailabilityStartTimesBatchDelete", "summary": "POST /v1/admin/operations/availability/start-times/batch-delete", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/availability/start-times/{id}": { "get": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "A start time by id", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "productId": { "type": "string" }, "optionId": { "type": [ "string", "null" ] }, "facilityId": { "type": [ "string", "null" ] }, "label": { "type": [ "string", "null" ] }, "startTimeLocal": { "type": "string" }, "durationMinutes": { "type": [ "integer", "null" ] }, "sortOrder": { "type": "integer" }, "active": { "type": "boolean" }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "productId", "optionId", "facilityId", "label", "startTimeLocal", "durationMinutes", "sortOrder", "active", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "404": { "description": "Availability start time not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "getAdminOperationsAvailabilityStartTimesById", "summary": "GET /v1/admin/operations/availability/start-times/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "patch": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "productId": { "type": "string" }, "optionId": { "type": [ "string", "null" ] }, "facilityId": { "type": [ "string", "null" ] }, "label": { "type": [ "string", "null" ] }, "startTimeLocal": { "type": "string", "minLength": 1 }, "durationMinutes": { "type": [ "integer", "null" ], "minimum": 0 }, "sortOrder": { "type": "integer", "default": 0 }, "active": { "type": "boolean", "default": true } } } } } }, "responses": { "200": { "description": "The updated start time", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "productId": { "type": "string" }, "optionId": { "type": [ "string", "null" ] }, "facilityId": { "type": [ "string", "null" ] }, "label": { "type": [ "string", "null" ] }, "startTimeLocal": { "type": "string" }, "durationMinutes": { "type": [ "integer", "null" ] }, "sortOrder": { "type": "integer" }, "active": { "type": "boolean" }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "productId", "optionId", "facilityId", "label", "startTimeLocal", "durationMinutes", "sortOrder", "active", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Availability start time not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "patchAdminOperationsAvailabilityStartTimesById", "summary": "PATCH /v1/admin/operations/availability/start-times/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "delete": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "Start time deleted", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] } }, "required": [ "success" ] } } } }, "404": { "description": "Availability start time not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "deleteAdminOperationsAvailabilityStartTimesById", "summary": "DELETE /v1/admin/operations/availability/start-times/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/availability/slots": { "get": { "parameters": [ { "schema": { "type": "integer", "minimum": 1, "maximum": 200, "default": 50 }, "required": false, "name": "limit", "in": "query" }, { "schema": { "type": [ "integer", "null" ], "minimum": 0, "default": 0 }, "required": false, "name": "offset", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "productId", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "itineraryId", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "optionId", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "facilityId", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "availabilityRuleId", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "startTimeId", "in": "query" }, { "schema": { "type": "string", "format": "date" }, "required": false, "name": "dateLocal", "in": "query" }, { "schema": { "type": "string", "format": "date-time" }, "required": false, "name": "startsAtFrom", "in": "query" }, { "schema": { "type": "string", "enum": [ "open", "closed", "sold_out", "cancelled" ] }, "required": false, "name": "status", "in": "query" } ], "responses": { "200": { "description": "Paginated availability slots (departures)", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "productId": { "type": "string" }, "itineraryId": { "type": [ "string", "null" ] }, "optionId": { "type": [ "string", "null" ] }, "facilityId": { "type": [ "string", "null" ] }, "availabilityRuleId": { "type": [ "string", "null" ] }, "startTimeId": { "type": [ "string", "null" ] }, "dateLocal": { "type": "string" }, "startsAt": { "type": "string" }, "endsAt": { "type": [ "string", "null" ] }, "timezone": { "type": "string" }, "status": { "type": "string", "enum": [ "open", "closed", "sold_out", "cancelled" ] }, "unlimited": { "type": "boolean" }, "initialPax": { "type": [ "integer", "null" ] }, "remainingPax": { "type": [ "integer", "null" ] }, "initialPickups": { "type": [ "integer", "null" ] }, "remainingPickups": { "type": [ "integer", "null" ] }, "remainingResources": { "type": [ "integer", "null" ] }, "pastCutoff": { "type": "boolean" }, "tooEarly": { "type": "boolean" }, "nights": { "type": [ "integer", "null" ] }, "days": { "type": [ "integer", "null" ] }, "notes": { "type": [ "string", "null" ] }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" }, "endDateLocal": { "type": [ "string", "null" ] }, "productName": { "type": [ "string", "null" ] } }, "required": [ "id", "productId", "itineraryId", "optionId", "facilityId", "availabilityRuleId", "startTimeId", "dateLocal", "startsAt", "endsAt", "timezone", "status", "unlimited", "initialPax", "remainingPax", "initialPickups", "remainingPickups", "remainingResources", "pastCutoff", "tooEarly", "nights", "days", "notes", "createdAt", "updatedAt", "endDateLocal" ] } }, "total": { "type": "integer" }, "limit": { "type": "integer" }, "offset": { "type": "integer" } }, "required": [ "data", "total", "limit", "offset" ] } } } } }, "operationId": "getAdminOperationsAvailabilitySlots", "summary": "GET /v1/admin/operations/availability/slots", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "post": { "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "productId": { "type": "string" }, "itineraryId": { "type": [ "string", "null" ] }, "optionId": { "type": [ "string", "null" ] }, "facilityId": { "type": [ "string", "null" ] }, "availabilityRuleId": { "type": [ "string", "null" ] }, "startTimeId": { "type": [ "string", "null" ] }, "dateLocal": { "type": "string", "format": "date" }, "startsAt": { "type": "string", "format": "date-time" }, "endsAt": { "type": [ "string", "null" ], "format": "date-time" }, "timezone": { "type": "string", "minLength": 1 }, "status": { "type": "string", "enum": [ "open", "closed", "sold_out", "cancelled" ], "default": "open" }, "unlimited": { "type": "boolean", "default": false }, "initialPax": { "type": [ "integer", "null" ], "minimum": 0 }, "remainingPax": { "type": [ "integer", "null" ], "minimum": 0 }, "initialPickups": { "type": [ "integer", "null" ], "minimum": 0 }, "remainingPickups": { "type": [ "integer", "null" ], "minimum": 0 }, "remainingResources": { "type": [ "integer", "null" ], "minimum": 0 }, "pastCutoff": { "type": "boolean", "default": false }, "tooEarly": { "type": "boolean", "default": false }, "nights": { "type": [ "integer", "null" ], "minimum": 0 }, "days": { "type": [ "integer", "null" ], "minimum": 0 }, "notes": { "type": [ "string", "null" ] } }, "required": [ "productId", "dateLocal", "startsAt", "timezone" ] } } } }, "responses": { "201": { "description": "The created slot", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "productId": { "type": "string" }, "itineraryId": { "type": [ "string", "null" ] }, "optionId": { "type": [ "string", "null" ] }, "facilityId": { "type": [ "string", "null" ] }, "availabilityRuleId": { "type": [ "string", "null" ] }, "startTimeId": { "type": [ "string", "null" ] }, "dateLocal": { "type": "string" }, "startsAt": { "type": "string" }, "endsAt": { "type": [ "string", "null" ] }, "timezone": { "type": "string" }, "status": { "type": "string", "enum": [ "open", "closed", "sold_out", "cancelled" ] }, "unlimited": { "type": "boolean" }, "initialPax": { "type": [ "integer", "null" ] }, "remainingPax": { "type": [ "integer", "null" ] }, "initialPickups": { "type": [ "integer", "null" ] }, "remainingPickups": { "type": [ "integer", "null" ] }, "remainingResources": { "type": [ "integer", "null" ] }, "pastCutoff": { "type": "boolean" }, "tooEarly": { "type": "boolean" }, "nights": { "type": [ "integer", "null" ] }, "days": { "type": [ "integer", "null" ] }, "notes": { "type": [ "string", "null" ] }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" }, "endDateLocal": { "type": [ "string", "null" ] } }, "required": [ "id", "productId", "itineraryId", "optionId", "facilityId", "availabilityRuleId", "startTimeId", "dateLocal", "startsAt", "endsAt", "timezone", "status", "unlimited", "initialPax", "remainingPax", "initialPickups", "remainingPickups", "remainingResources", "pastCutoff", "tooEarly", "nights", "days", "notes", "createdAt", "updatedAt", "endDateLocal" ] } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "postAdminOperationsAvailabilitySlots", "summary": "POST /v1/admin/operations/availability/slots", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/availability/slots/batch-update": { "post": { "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "ids": { "type": "array", "items": { "type": "string" }, "minItems": 1, "maxItems": 200 }, "patch": { "type": "object", "properties": { "productId": { "type": "string" }, "itineraryId": { "type": [ "string", "null" ] }, "optionId": { "type": [ "string", "null" ] }, "facilityId": { "type": [ "string", "null" ] }, "availabilityRuleId": { "type": [ "string", "null" ] }, "startTimeId": { "type": [ "string", "null" ] }, "dateLocal": { "type": "string", "format": "date" }, "startsAt": { "type": "string", "format": "date-time" }, "endsAt": { "type": [ "string", "null" ], "format": "date-time" }, "timezone": { "type": "string", "minLength": 1 }, "status": { "type": "string", "enum": [ "open", "closed", "sold_out", "cancelled" ], "default": "open" }, "unlimited": { "type": "boolean", "default": false }, "initialPax": { "type": [ "integer", "null" ], "minimum": 0 }, "remainingPax": { "type": [ "integer", "null" ], "minimum": 0 }, "initialPickups": { "type": [ "integer", "null" ], "minimum": 0 }, "remainingPickups": { "type": [ "integer", "null" ], "minimum": 0 }, "remainingResources": { "type": [ "integer", "null" ], "minimum": 0 }, "pastCutoff": { "type": "boolean", "default": false }, "tooEarly": { "type": "boolean", "default": false }, "nights": { "type": [ "integer", "null" ], "minimum": 0 }, "days": { "type": [ "integer", "null" ], "minimum": 0 }, "notes": { "type": [ "string", "null" ] } } } }, "required": [ "ids", "patch" ] } } } }, "responses": { "200": { "description": "Per-id batch-update results (missing ids reported under `failed`)", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "productId": { "type": "string" }, "itineraryId": { "type": [ "string", "null" ] }, "optionId": { "type": [ "string", "null" ] }, "facilityId": { "type": [ "string", "null" ] }, "availabilityRuleId": { "type": [ "string", "null" ] }, "startTimeId": { "type": [ "string", "null" ] }, "dateLocal": { "type": "string" }, "startsAt": { "type": "string" }, "endsAt": { "type": [ "string", "null" ] }, "timezone": { "type": "string" }, "status": { "type": "string", "enum": [ "open", "closed", "sold_out", "cancelled" ] }, "unlimited": { "type": "boolean" }, "initialPax": { "type": [ "integer", "null" ] }, "remainingPax": { "type": [ "integer", "null" ] }, "initialPickups": { "type": [ "integer", "null" ] }, "remainingPickups": { "type": [ "integer", "null" ] }, "remainingResources": { "type": [ "integer", "null" ] }, "pastCutoff": { "type": "boolean" }, "tooEarly": { "type": "boolean" }, "nights": { "type": [ "integer", "null" ] }, "days": { "type": [ "integer", "null" ] }, "notes": { "type": [ "string", "null" ] }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" }, "endDateLocal": { "type": [ "string", "null" ] } }, "required": [ "id", "productId", "itineraryId", "optionId", "facilityId", "availabilityRuleId", "startTimeId", "dateLocal", "startsAt", "endsAt", "timezone", "status", "unlimited", "initialPax", "remainingPax", "initialPickups", "remainingPickups", "remainingResources", "pastCutoff", "tooEarly", "nights", "days", "notes", "createdAt", "updatedAt", "endDateLocal" ] } }, "total": { "type": "integer" }, "succeeded": { "type": "integer" }, "failed": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "error": { "type": "string" } }, "required": [ "id", "error" ] } } }, "required": [ "data", "total", "succeeded", "failed" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "postAdminOperationsAvailabilitySlotsBatchUpdate", "summary": "POST /v1/admin/operations/availability/slots/batch-update", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/availability/slots/batch-delete": { "post": { "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "ids": { "type": "array", "items": { "type": "string" }, "minItems": 1, "maxItems": 200 } }, "required": [ "ids" ] } } } }, "responses": { "200": { "description": "Per-id batch-delete results (missing ids reported under `failed`)", "content": { "application/json": { "schema": { "type": "object", "properties": { "deletedIds": { "type": "array", "items": { "type": "string" } }, "total": { "type": "integer" }, "succeeded": { "type": "integer" }, "failed": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "error": { "type": "string" } }, "required": [ "id", "error" ] } } }, "required": [ "deletedIds", "total", "succeeded", "failed" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "postAdminOperationsAvailabilitySlotsBatchDelete", "summary": "POST /v1/admin/operations/availability/slots/batch-delete", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/availability/slots/{id}": { "get": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "A slot by id", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "productId": { "type": "string" }, "itineraryId": { "type": [ "string", "null" ] }, "optionId": { "type": [ "string", "null" ] }, "facilityId": { "type": [ "string", "null" ] }, "availabilityRuleId": { "type": [ "string", "null" ] }, "startTimeId": { "type": [ "string", "null" ] }, "dateLocal": { "type": "string" }, "startsAt": { "type": "string" }, "endsAt": { "type": [ "string", "null" ] }, "timezone": { "type": "string" }, "status": { "type": "string", "enum": [ "open", "closed", "sold_out", "cancelled" ] }, "unlimited": { "type": "boolean" }, "initialPax": { "type": [ "integer", "null" ] }, "remainingPax": { "type": [ "integer", "null" ] }, "initialPickups": { "type": [ "integer", "null" ] }, "remainingPickups": { "type": [ "integer", "null" ] }, "remainingResources": { "type": [ "integer", "null" ] }, "pastCutoff": { "type": "boolean" }, "tooEarly": { "type": "boolean" }, "nights": { "type": [ "integer", "null" ] }, "days": { "type": [ "integer", "null" ] }, "notes": { "type": [ "string", "null" ] }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" }, "endDateLocal": { "type": [ "string", "null" ] } }, "required": [ "id", "productId", "itineraryId", "optionId", "facilityId", "availabilityRuleId", "startTimeId", "dateLocal", "startsAt", "endsAt", "timezone", "status", "unlimited", "initialPax", "remainingPax", "initialPickups", "remainingPickups", "remainingResources", "pastCutoff", "tooEarly", "nights", "days", "notes", "createdAt", "updatedAt", "endDateLocal" ] } }, "required": [ "data" ] } } } }, "404": { "description": "Availability slot not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "getAdminOperationsAvailabilitySlotsById", "summary": "GET /v1/admin/operations/availability/slots/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "patch": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "productId": { "type": "string" }, "itineraryId": { "type": [ "string", "null" ] }, "optionId": { "type": [ "string", "null" ] }, "facilityId": { "type": [ "string", "null" ] }, "availabilityRuleId": { "type": [ "string", "null" ] }, "startTimeId": { "type": [ "string", "null" ] }, "dateLocal": { "type": "string", "format": "date" }, "startsAt": { "type": "string", "format": "date-time" }, "endsAt": { "type": [ "string", "null" ], "format": "date-time" }, "timezone": { "type": "string", "minLength": 1 }, "status": { "type": "string", "enum": [ "open", "closed", "sold_out", "cancelled" ], "default": "open" }, "unlimited": { "type": "boolean", "default": false }, "initialPax": { "type": [ "integer", "null" ], "minimum": 0 }, "remainingPax": { "type": [ "integer", "null" ], "minimum": 0 }, "initialPickups": { "type": [ "integer", "null" ], "minimum": 0 }, "remainingPickups": { "type": [ "integer", "null" ], "minimum": 0 }, "remainingResources": { "type": [ "integer", "null" ], "minimum": 0 }, "pastCutoff": { "type": "boolean", "default": false }, "tooEarly": { "type": "boolean", "default": false }, "nights": { "type": [ "integer", "null" ], "minimum": 0 }, "days": { "type": [ "integer", "null" ], "minimum": 0 }, "notes": { "type": [ "string", "null" ] } } } } } }, "responses": { "200": { "description": "The updated slot", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "productId": { "type": "string" }, "itineraryId": { "type": [ "string", "null" ] }, "optionId": { "type": [ "string", "null" ] }, "facilityId": { "type": [ "string", "null" ] }, "availabilityRuleId": { "type": [ "string", "null" ] }, "startTimeId": { "type": [ "string", "null" ] }, "dateLocal": { "type": "string" }, "startsAt": { "type": "string" }, "endsAt": { "type": [ "string", "null" ] }, "timezone": { "type": "string" }, "status": { "type": "string", "enum": [ "open", "closed", "sold_out", "cancelled" ] }, "unlimited": { "type": "boolean" }, "initialPax": { "type": [ "integer", "null" ] }, "remainingPax": { "type": [ "integer", "null" ] }, "initialPickups": { "type": [ "integer", "null" ] }, "remainingPickups": { "type": [ "integer", "null" ] }, "remainingResources": { "type": [ "integer", "null" ] }, "pastCutoff": { "type": "boolean" }, "tooEarly": { "type": "boolean" }, "nights": { "type": [ "integer", "null" ] }, "days": { "type": [ "integer", "null" ] }, "notes": { "type": [ "string", "null" ] }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" }, "endDateLocal": { "type": [ "string", "null" ] } }, "required": [ "id", "productId", "itineraryId", "optionId", "facilityId", "availabilityRuleId", "startTimeId", "dateLocal", "startsAt", "endsAt", "timezone", "status", "unlimited", "initialPax", "remainingPax", "initialPickups", "remainingPickups", "remainingResources", "pastCutoff", "tooEarly", "nights", "days", "notes", "createdAt", "updatedAt", "endDateLocal" ] } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Availability slot not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "patchAdminOperationsAvailabilitySlotsById", "summary": "PATCH /v1/admin/operations/availability/slots/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "delete": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "Slot deleted", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] } }, "required": [ "success" ] } } } }, "404": { "description": "Availability slot not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "deleteAdminOperationsAvailabilitySlotsById", "summary": "DELETE /v1/admin/operations/availability/slots/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/availability/slots/{id}/unit-availability": { "get": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "Per-option-unit availability for the slot", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "optionUnitId": { "type": "string" }, "unitName": { "type": "string" }, "occupancyMax": { "type": [ "integer", "null" ] }, "initial": { "type": [ "integer", "null" ] }, "reserved": { "type": "integer" }, "remaining": { "type": [ "integer", "null" ] } }, "required": [ "optionUnitId", "unitName", "occupancyMax", "initial", "reserved", "remaining" ] } } }, "required": [ "data" ] } } } }, "404": { "description": "Availability slot not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "getAdminOperationsAvailabilitySlotsByIdUnitAvailability", "summary": "GET /v1/admin/operations/availability/slots/{id}/unit-availability", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/availability/closeouts": { "get": { "parameters": [ { "schema": { "type": "integer", "minimum": 1, "maximum": 200, "default": 50 }, "required": false, "name": "limit", "in": "query" }, { "schema": { "type": [ "integer", "null" ], "minimum": 0, "default": 0 }, "required": false, "name": "offset", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "productId", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "slotId", "in": "query" }, { "schema": { "type": "string", "format": "date" }, "required": false, "name": "dateLocal", "in": "query" } ], "responses": { "200": { "description": "Paginated availability closeouts", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "productId": { "type": "string" }, "slotId": { "type": [ "string", "null" ] }, "dateLocal": { "type": "string" }, "reason": { "type": [ "string", "null" ] }, "createdBy": { "type": [ "string", "null" ] }, "createdAt": { "type": "string" }, "productName": { "type": [ "string", "null" ] } }, "required": [ "id", "productId", "slotId", "dateLocal", "reason", "createdBy", "createdAt", "productName" ] } }, "total": { "type": "integer" }, "limit": { "type": "integer" }, "offset": { "type": "integer" } }, "required": [ "data", "total", "limit", "offset" ] } } } } }, "operationId": "getAdminOperationsAvailabilityCloseouts", "summary": "GET /v1/admin/operations/availability/closeouts", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "post": { "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "productId": { "type": "string" }, "slotId": { "type": [ "string", "null" ] }, "dateLocal": { "type": "string", "format": "date" }, "reason": { "type": [ "string", "null" ] }, "createdBy": { "type": [ "string", "null" ] } }, "required": [ "productId", "dateLocal" ] } } } }, "responses": { "201": { "description": "The created closeout", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "productId": { "type": "string" }, "slotId": { "type": [ "string", "null" ] }, "dateLocal": { "type": "string" }, "reason": { "type": [ "string", "null" ] }, "createdBy": { "type": [ "string", "null" ] }, "createdAt": { "type": "string" } }, "required": [ "id", "productId", "slotId", "dateLocal", "reason", "createdBy", "createdAt" ] } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "postAdminOperationsAvailabilityCloseouts", "summary": "POST /v1/admin/operations/availability/closeouts", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/availability/closeouts/batch-update": { "post": { "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "ids": { "type": "array", "items": { "type": "string" }, "minItems": 1, "maxItems": 200 }, "patch": { "type": "object", "properties": { "productId": { "type": "string" }, "slotId": { "type": [ "string", "null" ] }, "dateLocal": { "type": "string", "format": "date" }, "reason": { "type": [ "string", "null" ] }, "createdBy": { "type": [ "string", "null" ] } } } }, "required": [ "ids", "patch" ] } } } }, "responses": { "200": { "description": "Per-id batch-update results (missing ids reported under `failed`)", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "productId": { "type": "string" }, "slotId": { "type": [ "string", "null" ] }, "dateLocal": { "type": "string" }, "reason": { "type": [ "string", "null" ] }, "createdBy": { "type": [ "string", "null" ] }, "createdAt": { "type": "string" } }, "required": [ "id", "productId", "slotId", "dateLocal", "reason", "createdBy", "createdAt" ] } }, "total": { "type": "integer" }, "succeeded": { "type": "integer" }, "failed": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "error": { "type": "string" } }, "required": [ "id", "error" ] } } }, "required": [ "data", "total", "succeeded", "failed" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "postAdminOperationsAvailabilityCloseoutsBatchUpdate", "summary": "POST /v1/admin/operations/availability/closeouts/batch-update", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/availability/closeouts/batch-delete": { "post": { "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "ids": { "type": "array", "items": { "type": "string" }, "minItems": 1, "maxItems": 200 } }, "required": [ "ids" ] } } } }, "responses": { "200": { "description": "Per-id batch-delete results (missing ids reported under `failed`)", "content": { "application/json": { "schema": { "type": "object", "properties": { "deletedIds": { "type": "array", "items": { "type": "string" } }, "total": { "type": "integer" }, "succeeded": { "type": "integer" }, "failed": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "error": { "type": "string" } }, "required": [ "id", "error" ] } } }, "required": [ "deletedIds", "total", "succeeded", "failed" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "postAdminOperationsAvailabilityCloseoutsBatchDelete", "summary": "POST /v1/admin/operations/availability/closeouts/batch-delete", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/availability/closeouts/{id}": { "get": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "A closeout by id", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "productId": { "type": "string" }, "slotId": { "type": [ "string", "null" ] }, "dateLocal": { "type": "string" }, "reason": { "type": [ "string", "null" ] }, "createdBy": { "type": [ "string", "null" ] }, "createdAt": { "type": "string" } }, "required": [ "id", "productId", "slotId", "dateLocal", "reason", "createdBy", "createdAt" ] } }, "required": [ "data" ] } } } }, "404": { "description": "Availability closeout not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "getAdminOperationsAvailabilityCloseoutsById", "summary": "GET /v1/admin/operations/availability/closeouts/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "patch": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "productId": { "type": "string" }, "slotId": { "type": [ "string", "null" ] }, "dateLocal": { "type": "string", "format": "date" }, "reason": { "type": [ "string", "null" ] }, "createdBy": { "type": [ "string", "null" ] } } } } } }, "responses": { "200": { "description": "The updated closeout", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "productId": { "type": "string" }, "slotId": { "type": [ "string", "null" ] }, "dateLocal": { "type": "string" }, "reason": { "type": [ "string", "null" ] }, "createdBy": { "type": [ "string", "null" ] }, "createdAt": { "type": "string" } }, "required": [ "id", "productId", "slotId", "dateLocal", "reason", "createdBy", "createdAt" ] } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Availability closeout not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "patchAdminOperationsAvailabilityCloseoutsById", "summary": "PATCH /v1/admin/operations/availability/closeouts/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "delete": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "Closeout deleted", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] } }, "required": [ "success" ] } } } }, "404": { "description": "Availability closeout not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "deleteAdminOperationsAvailabilityCloseoutsById", "summary": "DELETE /v1/admin/operations/availability/closeouts/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/availability/slots/{id}/allocation": { "get": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "The slot's allocation manifest (bookings, travelers, resources, summary)", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "slot": { "type": "object", "properties": { "id": { "type": "string" }, "productId": { "type": [ "string", "null" ] }, "startsAt": { "type": [ "string", "null" ] }, "endsAt": { "type": [ "string", "null" ] } }, "required": [ "id", "productId", "startsAt", "endsAt" ] }, "bookings": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "bookingNumber": { "type": "string" }, "status": { "type": "string" }, "bookingSequence": { "type": "integer" }, "paymentStatus": { "type": "string" }, "contactFirstName": { "type": [ "string", "null" ] }, "contactLastName": { "type": [ "string", "null" ] }, "contactEmail": { "type": [ "string", "null" ] }, "contactPhone": { "type": [ "string", "null" ] }, "sellCurrency": { "type": [ "string", "null" ] }, "pax": { "type": [ "integer", "null" ] }, "sellAmountCents": { "type": [ "integer", "null" ] }, "paidAmountCents": { "type": [ "integer", "null" ] }, "travelers": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "bookingId": { "type": "string" }, "bookingNumber": { "type": "string" }, "bookingStatus": { "type": "string" }, "bookingSequence": { "type": "integer" }, "paymentStatus": { "type": "string" }, "firstName": { "type": "string" }, "lastName": { "type": "string" }, "fullName": { "type": "string" }, "email": { "type": [ "string", "null" ] }, "phone": { "type": [ "string", "null" ] }, "isLeadTraveler": { "type": "boolean" }, "isPrimary": { "type": "boolean" }, "sharingGroupId": { "type": [ "string", "null" ] }, "optionId": { "type": [ "string", "null" ] }, "optionUnitId": { "type": [ "string", "null" ] }, "optionUnitCode": { "type": [ "string", "null" ] }, "roomTypeId": { "type": [ "string", "null" ] }, "bedPreference": { "type": [ "string", "null" ] }, "allocations": { "type": "object", "additionalProperties": { "type": "string" } }, "travelerCategory": { "type": [ "string", "null" ] }, "participantType": { "type": "string" }, "hasAccessibilityNeeds": { "type": "boolean" }, "hasDietaryRequirements": { "type": "boolean" } }, "required": [ "id", "bookingId", "bookingNumber", "bookingStatus", "bookingSequence", "paymentStatus", "firstName", "lastName", "fullName", "email", "phone", "isLeadTraveler", "isPrimary", "sharingGroupId", "optionId", "optionUnitId", "optionUnitCode", "roomTypeId", "bedPreference", "allocations", "travelerCategory", "participantType", "hasAccessibilityNeeds", "hasDietaryRequirements" ] } } }, "required": [ "id", "bookingNumber", "status", "bookingSequence", "paymentStatus", "contactFirstName", "contactLastName", "contactEmail", "contactPhone", "sellCurrency", "pax", "sellAmountCents", "paidAmountCents", "travelers" ] } }, "resources": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "slotId": { "type": "string" }, "kind": { "type": "string" }, "refType": { "type": [ "string", "null" ] }, "refId": { "type": [ "string", "null" ] }, "label": { "type": [ "string", "null" ] }, "capacity": { "type": "integer" }, "flags": { "type": "object", "additionalProperties": {} }, "parentId": { "type": [ "string", "null" ] }, "sortOrder": { "type": "integer" }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "slotId", "kind", "refType", "refId", "label", "capacity", "flags", "parentId", "sortOrder", "createdAt", "updatedAt" ] } }, "sharingGroupLabels": { "type": "object", "additionalProperties": { "type": "string" } }, "summary": { "type": "object", "properties": { "bookingCount": { "type": "integer" }, "travelerCount": { "type": "integer" }, "leadTravelerCount": { "type": "integer" }, "bookingsByStatus": { "type": "object", "additionalProperties": { "type": "integer" } } }, "required": [ "bookingCount", "travelerCount", "leadTravelerCount", "bookingsByStatus" ] } }, "required": [ "slot", "bookings", "resources", "sharingGroupLabels", "summary" ] } }, "required": [ "data" ] } } } }, "404": { "description": "Availability slot not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "getAdminOperationsAvailabilitySlotsByIdAllocation", "summary": "GET /v1/admin/operations/availability/slots/{id}/allocation", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/availability/slots/{id}/allocation/resources": { "post": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "kind": { "type": "string", "minLength": 1, "maxLength": 80 }, "refType": { "type": [ "string", "null" ] }, "refId": { "type": [ "string", "null" ] }, "label": { "type": [ "string", "null" ] }, "capacity": { "type": "integer", "minimum": 1 }, "flags": { "type": "object", "additionalProperties": {}, "default": {} }, "parentId": { "type": [ "string", "null" ] }, "sortOrder": { "type": "integer", "default": 0 } }, "required": [ "kind", "capacity" ] } } } }, "responses": { "201": { "description": "The created allocation resource", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "slotId": { "type": "string" }, "kind": { "type": "string" }, "refType": { "type": [ "string", "null" ] }, "refId": { "type": [ "string", "null" ] }, "label": { "type": [ "string", "null" ] }, "capacity": { "type": "integer" }, "flags": { "type": "object", "additionalProperties": {} }, "parentId": { "type": [ "string", "null" ] }, "sortOrder": { "type": "integer" }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "slotId", "kind", "refType", "refId", "label", "capacity", "flags", "parentId", "sortOrder", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Availability slot not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "postAdminOperationsAvailabilitySlotsByIdAllocationResources", "summary": "POST /v1/admin/operations/availability/slots/{id}/allocation/resources", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/availability/slots/{id}/allocation/resources/{resourceId}": { "patch": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" }, { "schema": { "type": "string" }, "required": true, "name": "resourceId", "in": "path" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "refType": { "type": [ "string", "null" ] }, "refId": { "type": [ "string", "null" ] }, "label": { "type": [ "string", "null" ] }, "capacity": { "type": "integer", "minimum": 1 }, "flags": { "type": "object", "additionalProperties": {}, "default": {} }, "parentId": { "type": [ "string", "null" ] }, "sortOrder": { "type": "integer", "default": 0 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "The updated allocation resource", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "slotId": { "type": "string" }, "kind": { "type": "string" }, "refType": { "type": [ "string", "null" ] }, "refId": { "type": [ "string", "null" ] }, "label": { "type": [ "string", "null" ] }, "capacity": { "type": "integer" }, "flags": { "type": "object", "additionalProperties": {} }, "parentId": { "type": [ "string", "null" ] }, "sortOrder": { "type": "integer" }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "slotId", "kind", "refType", "refId", "label", "capacity", "flags", "parentId", "sortOrder", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request, or an allocation invariant was violated", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "detail": {} }, "required": [ "error" ] } } } }, "404": { "description": "The slot, traveler, resource, sharing group, or template was not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "detail": {} }, "required": [ "error" ] } } } }, "409": { "description": "Resource over capacity, or resources already exist for this kind", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "detail": {} }, "required": [ "error" ] } } } }, "500": { "description": "The allocation operation could not be completed", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "detail": {} }, "required": [ "error" ] } } } } }, "operationId": "patchAdminOperationsAvailabilitySlotsByIdAllocationResourcesByResourceId", "summary": "PATCH /v1/admin/operations/availability/slots/{id}/allocation/resources/{resourceId}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "delete": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" }, { "schema": { "type": "string" }, "required": true, "name": "resourceId", "in": "path" } ], "responses": { "200": { "description": "The deleted allocation resource (id/kind/label/capacity)", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "kind": { "type": "string" }, "label": { "type": [ "string", "null" ] }, "capacity": { "type": "integer" } }, "required": [ "id", "kind", "label", "capacity" ] } }, "required": [ "data" ] } } } }, "404": { "description": "Allocation resource not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "deleteAdminOperationsAvailabilitySlotsByIdAllocationResourcesByResourceId", "summary": "DELETE /v1/admin/operations/availability/slots/{id}/allocation/resources/{resourceId}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/availability/slots/{id}/allocation/travelers/{travelerId}": { "patch": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" }, { "schema": { "type": "string" }, "required": true, "name": "travelerId", "in": "path" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "kind": { "type": "string", "minLength": 1, "maxLength": 80 }, "resourceId": { "type": [ "string", "null" ] } }, "required": [ "kind", "resourceId" ] } } } }, "responses": { "200": { "description": "The traveler's resolved allocation (kind + resourceId, null to unassign)", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "travelerId": { "type": "string" }, "kind": { "type": "string" }, "resourceId": { "type": [ "string", "null" ] } }, "required": [ "travelerId", "kind", "resourceId" ] } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request, or an allocation invariant was violated", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "detail": {} }, "required": [ "error" ] } } } }, "404": { "description": "The slot, traveler, resource, sharing group, or template was not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "detail": {} }, "required": [ "error" ] } } } }, "409": { "description": "Resource over capacity, or resources already exist for this kind", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "detail": {} }, "required": [ "error" ] } } } }, "500": { "description": "The allocation operation could not be completed", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "detail": {} }, "required": [ "error" ] } } } } }, "operationId": "patchAdminOperationsAvailabilitySlotsByIdAllocationTravelersByTravelerId", "summary": "PATCH /v1/admin/operations/availability/slots/{id}/allocation/travelers/{travelerId}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/availability/slots/{id}/allocation/travelers/{travelerId}/sharing-group": { "patch": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" }, { "schema": { "type": "string" }, "required": true, "name": "travelerId", "in": "path" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "sharingGroupId": { "type": [ "string", "null" ], "minLength": 1 } }, "required": [ "sharingGroupId" ] } } } }, "responses": { "200": { "description": "The traveler's resolved sharing group (null to clear)", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "travelerId": { "type": "string" }, "sharingGroupId": { "type": [ "string", "null" ] } }, "required": [ "travelerId", "sharingGroupId" ] } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request, or an allocation invariant was violated", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "detail": {} }, "required": [ "error" ] } } } }, "404": { "description": "The slot, traveler, resource, sharing group, or template was not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "detail": {} }, "required": [ "error" ] } } } }, "409": { "description": "Resource over capacity, or resources already exist for this kind", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "detail": {} }, "required": [ "error" ] } } } }, "500": { "description": "The allocation operation could not be completed", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "detail": {} }, "required": [ "error" ] } } } } }, "operationId": "patchAdminOperationsAvailabilitySlotsByIdAllocationTravelersByTravelerIdSharingGroup", "summary": "PATCH /v1/admin/operations/availability/slots/{id}/allocation/travelers/{travelerId}/sharing-group", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/availability/slots/{id}/allocation/sharing-groups/pair": { "post": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "travelerIds": { "type": "array", "items": { "type": "string", "minLength": 1 }, "minItems": 2, "maxItems": 20 }, "sharingGroupId": { "type": "string", "minLength": 1 } }, "required": [ "travelerIds" ] } } } }, "responses": { "201": { "description": "The paired sharing group (id + member traveler ids)", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "sharingGroupId": { "type": "string" }, "travelerIds": { "type": "array", "items": { "type": "string" } } }, "required": [ "sharingGroupId", "travelerIds" ] } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request, or an allocation invariant was violated", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "detail": {} }, "required": [ "error" ] } } } }, "404": { "description": "The slot, traveler, resource, sharing group, or template was not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "detail": {} }, "required": [ "error" ] } } } }, "409": { "description": "Resource over capacity, or resources already exist for this kind", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "detail": {} }, "required": [ "error" ] } } } }, "500": { "description": "The allocation operation could not be completed", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "detail": {} }, "required": [ "error" ] } } } } }, "operationId": "postAdminOperationsAvailabilitySlotsByIdAllocationSharingGroupsPair", "summary": "POST /v1/admin/operations/availability/slots/{id}/allocation/sharing-groups/pair", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/availability/slots/{id}/allocation/sharing-groups/{groupId}/label": { "put": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" }, { "schema": { "type": "string" }, "required": true, "name": "groupId", "in": "path" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "label": { "type": "string", "minLength": 1, "maxLength": 120 } }, "required": [ "label" ] } } } }, "responses": { "200": { "description": "The upserted sharing-group label", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "groupId": { "type": "string" }, "label": { "type": "string" }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "groupId", "label", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request, or an allocation invariant was violated", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "detail": {} }, "required": [ "error" ] } } } }, "404": { "description": "The slot, traveler, resource, sharing group, or template was not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "detail": {} }, "required": [ "error" ] } } } }, "409": { "description": "Resource over capacity, or resources already exist for this kind", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "detail": {} }, "required": [ "error" ] } } } }, "500": { "description": "The allocation operation could not be completed", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "detail": {} }, "required": [ "error" ] } } } } }, "operationId": "putAdminOperationsAvailabilitySlotsByIdAllocationSharingGroupsByGroupIdLabel", "summary": "PUT /v1/admin/operations/availability/slots/{id}/allocation/sharing-groups/{groupId}/label", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "delete": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" }, { "schema": { "type": "string" }, "required": true, "name": "groupId", "in": "path" } ], "responses": { "200": { "description": "The cleared sharing-group label", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "groupId": { "type": "string" }, "label": { "type": "string" }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "groupId", "label", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request, or an allocation invariant was violated", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "detail": {} }, "required": [ "error" ] } } } }, "404": { "description": "The slot, traveler, resource, sharing group, or template was not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "detail": {} }, "required": [ "error" ] } } } }, "409": { "description": "Resource over capacity, or resources already exist for this kind", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "detail": {} }, "required": [ "error" ] } } } }, "500": { "description": "The allocation operation could not be completed", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "detail": {} }, "required": [ "error" ] } } } } }, "operationId": "deleteAdminOperationsAvailabilitySlotsByIdAllocationSharingGroupsByGroupIdLabel", "summary": "DELETE /v1/admin/operations/availability/slots/{id}/allocation/sharing-groups/{groupId}/label", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/availability/slots/{id}/allocation/audit-log": { "get": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" }, { "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 50 }, "required": false, "name": "limit", "in": "query" } ], "responses": { "200": { "description": "The slot's allocation audit-log entries (newest first)", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "slotId": { "type": "string" }, "action": { "type": "string" }, "actorId": { "type": [ "string", "null" ] }, "travelerId": { "type": [ "string", "null" ] }, "resourceId": { "type": [ "string", "null" ] }, "before": { "type": [ "object", "null" ], "additionalProperties": {} }, "after": { "type": [ "object", "null" ], "additionalProperties": {} }, "createdAt": { "type": "string" } }, "required": [ "id", "slotId", "action", "actorId", "travelerId", "resourceId", "before", "after", "createdAt" ] } } }, "required": [ "data" ] } } } } }, "operationId": "getAdminOperationsAvailabilitySlotsByIdAllocationAuditLog", "summary": "GET /v1/admin/operations/availability/slots/{id}/allocation/audit-log", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/availability/slots/{id}/allocation/export-passengers": { "get": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "Passenger manifest CSV (text/csv attachment)", "content": { "text/csv": { "schema": { "type": "string" } } } }, "404": { "description": "Availability slot not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "getAdminOperationsAvailabilitySlotsByIdAllocationExportPassengers", "summary": "GET /v1/admin/operations/availability/slots/{id}/allocation/export-passengers", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/availability/slots/{id}/allocation/export-rooming-list": { "get": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "Rooming-list CSV (text/csv attachment)", "content": { "text/csv": { "schema": { "type": "string" } } } }, "404": { "description": "Availability slot not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "getAdminOperationsAvailabilitySlotsByIdAllocationExportRoomingList", "summary": "GET /v1/admin/operations/availability/slots/{id}/allocation/export-rooming-list", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/availability/slots/{id}/allocation/auto-materialize": { "post": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "kind": { "type": "string", "minLength": 1, "maxLength": 80, "default": "room" } } } } } }, "responses": { "200": { "description": "Pax-derived materialisation result (kind + created count + resources)", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "kind": { "type": "string" }, "assigned": { "type": "integer" }, "skipped": { "type": "integer" }, "created": { "type": "integer" }, "resources": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "slotId": { "type": "string" }, "kind": { "type": "string" }, "refType": { "type": [ "string", "null" ] }, "refId": { "type": [ "string", "null" ] }, "label": { "type": [ "string", "null" ] }, "capacity": { "type": "integer" }, "flags": { "type": "object", "additionalProperties": {} }, "parentId": { "type": [ "string", "null" ] }, "sortOrder": { "type": "integer" }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "slotId", "kind", "refType", "refId", "label", "capacity", "flags", "parentId", "sortOrder", "createdAt", "updatedAt" ] } } }, "required": [ "kind" ] } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request, or an allocation invariant was violated", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "detail": {} }, "required": [ "error" ] } } } }, "404": { "description": "The slot, traveler, resource, sharing group, or template was not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "detail": {} }, "required": [ "error" ] } } } }, "409": { "description": "Resource over capacity, or resources already exist for this kind", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "detail": {} }, "required": [ "error" ] } } } }, "500": { "description": "The allocation operation could not be completed", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "detail": {} }, "required": [ "error" ] } } } } }, "operationId": "postAdminOperationsAvailabilitySlotsByIdAllocationAutoMaterialize", "summary": "POST /v1/admin/operations/availability/slots/{id}/allocation/auto-materialize", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/availability/slots/{id}/allocation/materialize-templates": { "post": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "The count of resources materialised from the slot's template defaults", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "created": { "type": "integer" } }, "required": [ "created" ] } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request, or an allocation invariant was violated", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "detail": {} }, "required": [ "error" ] } } } }, "404": { "description": "The slot, traveler, resource, sharing group, or template was not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "detail": {} }, "required": [ "error" ] } } } }, "409": { "description": "Resource over capacity, or resources already exist for this kind", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "detail": {} }, "required": [ "error" ] } } } }, "500": { "description": "The allocation operation could not be completed", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "detail": {} }, "required": [ "error" ] } } } } }, "operationId": "postAdminOperationsAvailabilitySlotsByIdAllocationMaterializeTemplates", "summary": "POST /v1/admin/operations/availability/slots/{id}/allocation/materialize-templates", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/availability/slots/{id}/allocation/auto-allocate": { "post": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "kind": { "type": "string", "minLength": 1, "maxLength": 80, "default": "room" } } } } } }, "responses": { "200": { "description": "Auto-allocation result (kind + assigned + skipped counts)", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "kind": { "type": "string" }, "assigned": { "type": "integer" }, "skipped": { "type": "integer" }, "created": { "type": "integer" }, "resources": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "slotId": { "type": "string" }, "kind": { "type": "string" }, "refType": { "type": [ "string", "null" ] }, "refId": { "type": [ "string", "null" ] }, "label": { "type": [ "string", "null" ] }, "capacity": { "type": "integer" }, "flags": { "type": "object", "additionalProperties": {} }, "parentId": { "type": [ "string", "null" ] }, "sortOrder": { "type": "integer" }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "slotId", "kind", "refType", "refId", "label", "capacity", "flags", "parentId", "sortOrder", "createdAt", "updatedAt" ] } } }, "required": [ "kind" ] } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request, or an allocation invariant was violated", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "detail": {} }, "required": [ "error" ] } } } }, "404": { "description": "The slot, traveler, resource, sharing group, or template was not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "detail": {} }, "required": [ "error" ] } } } }, "409": { "description": "Resource over capacity, or resources already exist for this kind", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "detail": {} }, "required": [ "error" ] } } } }, "500": { "description": "The allocation operation could not be completed", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "detail": {} }, "required": [ "error" ] } } } } }, "operationId": "postAdminOperationsAvailabilitySlotsByIdAllocationAutoAllocate", "summary": "POST /v1/admin/operations/availability/slots/{id}/allocation/auto-allocate", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/availability/products/{productId}/allocation/resource-templates": { "get": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "productId", "in": "path" } ], "responses": { "200": { "description": "The product's options, each with its configured resource templates", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "code": { "type": [ "string", "null" ] }, "description": { "type": [ "string", "null" ] }, "status": { "type": "string" }, "isDefault": { "type": "boolean" }, "sortOrder": { "type": "integer" }, "templates": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "productOptionId": { "type": "string" }, "kind": { "type": "string" }, "refType": { "type": [ "string", "null" ] }, "refId": { "type": [ "string", "null" ] }, "capacity": { "type": "integer" }, "namePattern": { "type": "string" }, "layout": { "type": [ "string", "null" ] }, "defaultCount": { "type": [ "integer", "null" ] }, "flags": { "type": "object", "additionalProperties": {} }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "productOptionId", "kind", "refType", "refId", "capacity", "namePattern", "layout", "defaultCount", "flags", "createdAt", "updatedAt" ] } } }, "required": [ "id", "name", "code", "description", "status", "isDefault", "sortOrder", "templates" ] } } }, "required": [ "data" ] } } } } }, "operationId": "getAdminOperationsAvailabilityProductsByProductIdAllocationResourceTemplates", "summary": "GET /v1/admin/operations/availability/products/{productId}/allocation/resource-templates", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/availability/products/{productId}/options/{optionId}/allocation/resource-templates/{kind}": { "put": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "productId", "in": "path" }, { "schema": { "type": "string" }, "required": true, "name": "optionId", "in": "path" }, { "schema": { "type": "string" }, "required": true, "name": "kind", "in": "path" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "capacity": { "type": "integer", "minimum": 1 }, "namePattern": { "type": "string", "minLength": 1, "maxLength": 160, "default": "Room {sequence}" }, "refType": { "type": [ "string", "null" ], "minLength": 1 }, "refId": { "type": [ "string", "null" ], "minLength": 1 }, "layout": { "type": [ "string", "null" ], "minLength": 1 }, "defaultCount": { "type": [ "integer", "null" ], "minimum": 0 }, "flags": { "type": "object", "additionalProperties": {}, "default": {} } }, "required": [ "capacity" ] } } } }, "responses": { "200": { "description": "The upserted resource template", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "productOptionId": { "type": "string" }, "kind": { "type": "string" }, "refType": { "type": [ "string", "null" ] }, "refId": { "type": [ "string", "null" ] }, "capacity": { "type": "integer" }, "namePattern": { "type": "string" }, "layout": { "type": [ "string", "null" ] }, "defaultCount": { "type": [ "integer", "null" ] }, "flags": { "type": "object", "additionalProperties": {} }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "productOptionId", "kind", "refType", "refId", "capacity", "namePattern", "layout", "defaultCount", "flags", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request, or an allocation invariant was violated", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "detail": {} }, "required": [ "error" ] } } } }, "404": { "description": "The slot, traveler, resource, sharing group, or template was not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "detail": {} }, "required": [ "error" ] } } } }, "409": { "description": "Resource over capacity, or resources already exist for this kind", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "detail": {} }, "required": [ "error" ] } } } }, "500": { "description": "The allocation operation could not be completed", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "detail": {} }, "required": [ "error" ] } } } } }, "operationId": "putAdminOperationsAvailabilityProductsByProductIdOptionsByOptionIdAllocationResourceTemplatesByKind", "summary": "PUT /v1/admin/operations/availability/products/{productId}/options/{optionId}/allocation/resource-templates/{kind}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "delete": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "productId", "in": "path" }, { "schema": { "type": "string" }, "required": true, "name": "optionId", "in": "path" }, { "schema": { "type": "string" }, "required": true, "name": "kind", "in": "path" }, { "schema": { "type": "string" }, "required": false, "name": "refId", "in": "query" } ], "responses": { "200": { "description": "The deleted template's option + kind", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "productOptionId": { "type": "string" }, "kind": { "type": "string" } }, "required": [ "productOptionId", "kind" ] } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request, or an allocation invariant was violated", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "detail": {} }, "required": [ "error" ] } } } }, "404": { "description": "The slot, traveler, resource, sharing group, or template was not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "detail": {} }, "required": [ "error" ] } } } }, "409": { "description": "Resource over capacity, or resources already exist for this kind", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "detail": {} }, "required": [ "error" ] } } } }, "500": { "description": "The allocation operation could not be completed", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "detail": {} }, "required": [ "error" ] } } } } }, "operationId": "deleteAdminOperationsAvailabilityProductsByProductIdOptionsByOptionIdAllocationResourceTemplatesByKind", "summary": "DELETE /v1/admin/operations/availability/products/{productId}/options/{optionId}/allocation/resource-templates/{kind}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/availability/products/{id}/allocation/materialize-open-slots": { "post": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "optionId": { "type": "string" } } } } } }, "responses": { "200": { "description": "Open-slot back-fill result (slots touched + resources created)", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "slots": { "type": "integer" }, "created": { "type": "integer" } }, "required": [ "slots", "created" ] } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request, or an allocation invariant was violated", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "detail": {} }, "required": [ "error" ] } } } }, "404": { "description": "The slot, traveler, resource, sharing group, or template was not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "detail": {} }, "required": [ "error" ] } } } }, "409": { "description": "Resource over capacity, or resources already exist for this kind", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "detail": {} }, "required": [ "error" ] } } } }, "500": { "description": "The allocation operation could not be completed", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "detail": {} }, "required": [ "error" ] } } } } }, "operationId": "postAdminOperationsAvailabilityProductsByIdAllocationMaterializeOpenSlots", "summary": "POST /v1/admin/operations/availability/products/{id}/allocation/materialize-open-slots", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/availability/pickup-points": { "get": { "parameters": [ { "schema": { "type": "integer", "minimum": 1, "maximum": 200, "default": 50 }, "required": false, "name": "limit", "in": "query" }, { "schema": { "type": [ "integer", "null" ], "minimum": 0, "default": 0 }, "required": false, "name": "offset", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "productId", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "facilityId", "in": "query" }, { "schema": { "type": "string", "enum": [ "0", "1", "true", "false" ] }, "required": false, "name": "active", "in": "query" } ], "responses": { "200": { "description": "Paginated availability pickup points", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "productId": { "type": "string" }, "facilityId": { "type": [ "string", "null" ] }, "name": { "type": "string" }, "description": { "type": [ "string", "null" ] }, "locationText": { "type": [ "string", "null" ] }, "active": { "type": "boolean" }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" }, "productName": { "type": [ "string", "null" ] } }, "required": [ "id", "productId", "facilityId", "name", "description", "locationText", "active", "createdAt", "updatedAt" ] } }, "total": { "type": "integer" }, "limit": { "type": "integer" }, "offset": { "type": "integer" } }, "required": [ "data", "total", "limit", "offset" ] } } } } }, "operationId": "getAdminOperationsAvailabilityPickupPoints", "summary": "GET /v1/admin/operations/availability/pickup-points", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "post": { "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "productId": { "type": "string" }, "facilityId": { "type": [ "string", "null" ] }, "name": { "type": "string", "minLength": 1 }, "description": { "type": [ "string", "null" ] }, "locationText": { "type": [ "string", "null" ] }, "active": { "type": "boolean", "default": true } }, "required": [ "productId", "name" ] } } } }, "responses": { "201": { "description": "The created availability pickup point", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "productId": { "type": "string" }, "facilityId": { "type": [ "string", "null" ] }, "name": { "type": "string" }, "description": { "type": [ "string", "null" ] }, "locationText": { "type": [ "string", "null" ] }, "active": { "type": "boolean" }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "productId", "facilityId", "name", "description", "locationText", "active", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "postAdminOperationsAvailabilityPickupPoints", "summary": "POST /v1/admin/operations/availability/pickup-points", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/availability/pickup-points/batch-update": { "post": { "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "ids": { "type": "array", "items": { "type": "string" }, "minItems": 1, "maxItems": 200 }, "patch": { "type": "object", "properties": { "productId": { "type": "string" }, "facilityId": { "type": [ "string", "null" ] }, "name": { "type": "string", "minLength": 1 }, "description": { "type": [ "string", "null" ] }, "locationText": { "type": [ "string", "null" ] }, "active": { "type": "boolean", "default": true } } } }, "required": [ "ids", "patch" ] } } } }, "responses": { "200": { "description": "Per-id batch-update results (missing ids reported under `failed`)", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "productId": { "type": "string" }, "facilityId": { "type": [ "string", "null" ] }, "name": { "type": "string" }, "description": { "type": [ "string", "null" ] }, "locationText": { "type": [ "string", "null" ] }, "active": { "type": "boolean" }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "productId", "facilityId", "name", "description", "locationText", "active", "createdAt", "updatedAt" ] } }, "total": { "type": "integer" }, "succeeded": { "type": "integer" }, "failed": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "error": { "type": "string" } }, "required": [ "id", "error" ] } } }, "required": [ "data", "total", "succeeded", "failed" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "postAdminOperationsAvailabilityPickupPointsBatchUpdate", "summary": "POST /v1/admin/operations/availability/pickup-points/batch-update", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/availability/pickup-points/batch-delete": { "post": { "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "ids": { "type": "array", "items": { "type": "string" }, "minItems": 1, "maxItems": 200 } }, "required": [ "ids" ] } } } }, "responses": { "200": { "description": "Per-id batch-delete results (missing ids reported under `failed`)", "content": { "application/json": { "schema": { "type": "object", "properties": { "deletedIds": { "type": "array", "items": { "type": "string" } }, "total": { "type": "integer" }, "succeeded": { "type": "integer" }, "failed": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "error": { "type": "string" } }, "required": [ "id", "error" ] } } }, "required": [ "deletedIds", "total", "succeeded", "failed" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "postAdminOperationsAvailabilityPickupPointsBatchDelete", "summary": "POST /v1/admin/operations/availability/pickup-points/batch-delete", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/availability/pickup-points/{id}": { "get": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "An availability pickup point by id", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "productId": { "type": "string" }, "facilityId": { "type": [ "string", "null" ] }, "name": { "type": "string" }, "description": { "type": [ "string", "null" ] }, "locationText": { "type": [ "string", "null" ] }, "active": { "type": "boolean" }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "productId", "facilityId", "name", "description", "locationText", "active", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "404": { "description": "Availability pickup point not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "getAdminOperationsAvailabilityPickupPointsById", "summary": "GET /v1/admin/operations/availability/pickup-points/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "patch": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "productId": { "type": "string" }, "facilityId": { "type": [ "string", "null" ] }, "name": { "type": "string", "minLength": 1 }, "description": { "type": [ "string", "null" ] }, "locationText": { "type": [ "string", "null" ] }, "active": { "type": "boolean", "default": true } } } } } }, "responses": { "200": { "description": "The updated availability pickup point", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "productId": { "type": "string" }, "facilityId": { "type": [ "string", "null" ] }, "name": { "type": "string" }, "description": { "type": [ "string", "null" ] }, "locationText": { "type": [ "string", "null" ] }, "active": { "type": "boolean" }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "productId", "facilityId", "name", "description", "locationText", "active", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Availability pickup point not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "patchAdminOperationsAvailabilityPickupPointsById", "summary": "PATCH /v1/admin/operations/availability/pickup-points/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "delete": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "Availability pickup point deleted", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] } }, "required": [ "success" ] } } } }, "404": { "description": "Availability pickup point not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "deleteAdminOperationsAvailabilityPickupPointsById", "summary": "DELETE /v1/admin/operations/availability/pickup-points/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/availability/slot-pickups": { "get": { "parameters": [ { "schema": { "type": "integer", "minimum": 1, "maximum": 200, "default": 50 }, "required": false, "name": "limit", "in": "query" }, { "schema": { "type": [ "integer", "null" ], "minimum": 0, "default": 0 }, "required": false, "name": "offset", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "slotId", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "pickupPointId", "in": "query" } ], "responses": { "200": { "description": "Paginated availability slot pickups", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "slotId": { "type": "string" }, "pickupPointId": { "type": "string" }, "initialCapacity": { "type": [ "integer", "null" ] }, "remainingCapacity": { "type": [ "integer", "null" ] }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "slotId", "pickupPointId", "initialCapacity", "remainingCapacity", "createdAt", "updatedAt" ] } }, "total": { "type": "integer" }, "limit": { "type": "integer" }, "offset": { "type": "integer" } }, "required": [ "data", "total", "limit", "offset" ] } } } } }, "operationId": "getAdminOperationsAvailabilitySlotPickups", "summary": "GET /v1/admin/operations/availability/slot-pickups", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "post": { "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "slotId": { "type": "string" }, "pickupPointId": { "type": "string" }, "initialCapacity": { "type": [ "integer", "null" ], "minimum": 0 }, "remainingCapacity": { "type": [ "integer", "null" ], "minimum": 0 } }, "required": [ "slotId", "pickupPointId" ] } } } }, "responses": { "201": { "description": "The created availability slot pickup", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "slotId": { "type": "string" }, "pickupPointId": { "type": "string" }, "initialCapacity": { "type": [ "integer", "null" ] }, "remainingCapacity": { "type": [ "integer", "null" ] }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "slotId", "pickupPointId", "initialCapacity", "remainingCapacity", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "postAdminOperationsAvailabilitySlotPickups", "summary": "POST /v1/admin/operations/availability/slot-pickups", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/availability/slot-pickups/batch-update": { "post": { "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "ids": { "type": "array", "items": { "type": "string" }, "minItems": 1, "maxItems": 200 }, "patch": { "type": "object", "properties": { "slotId": { "type": "string" }, "pickupPointId": { "type": "string" }, "initialCapacity": { "type": [ "integer", "null" ], "minimum": 0 }, "remainingCapacity": { "type": [ "integer", "null" ], "minimum": 0 } } } }, "required": [ "ids", "patch" ] } } } }, "responses": { "200": { "description": "Per-id batch-update results (missing ids reported under `failed`)", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "slotId": { "type": "string" }, "pickupPointId": { "type": "string" }, "initialCapacity": { "type": [ "integer", "null" ] }, "remainingCapacity": { "type": [ "integer", "null" ] }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "slotId", "pickupPointId", "initialCapacity", "remainingCapacity", "createdAt", "updatedAt" ] } }, "total": { "type": "integer" }, "succeeded": { "type": "integer" }, "failed": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "error": { "type": "string" } }, "required": [ "id", "error" ] } } }, "required": [ "data", "total", "succeeded", "failed" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "postAdminOperationsAvailabilitySlotPickupsBatchUpdate", "summary": "POST /v1/admin/operations/availability/slot-pickups/batch-update", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/availability/slot-pickups/batch-delete": { "post": { "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "ids": { "type": "array", "items": { "type": "string" }, "minItems": 1, "maxItems": 200 } }, "required": [ "ids" ] } } } }, "responses": { "200": { "description": "Per-id batch-delete results (missing ids reported under `failed`)", "content": { "application/json": { "schema": { "type": "object", "properties": { "deletedIds": { "type": "array", "items": { "type": "string" } }, "total": { "type": "integer" }, "succeeded": { "type": "integer" }, "failed": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "error": { "type": "string" } }, "required": [ "id", "error" ] } } }, "required": [ "deletedIds", "total", "succeeded", "failed" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "postAdminOperationsAvailabilitySlotPickupsBatchDelete", "summary": "POST /v1/admin/operations/availability/slot-pickups/batch-delete", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/availability/slot-pickups/{id}": { "get": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "An availability slot pickup by id", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "slotId": { "type": "string" }, "pickupPointId": { "type": "string" }, "initialCapacity": { "type": [ "integer", "null" ] }, "remainingCapacity": { "type": [ "integer", "null" ] }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "slotId", "pickupPointId", "initialCapacity", "remainingCapacity", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "404": { "description": "Availability slot pickup not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "getAdminOperationsAvailabilitySlotPickupsById", "summary": "GET /v1/admin/operations/availability/slot-pickups/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "patch": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "slotId": { "type": "string" }, "pickupPointId": { "type": "string" }, "initialCapacity": { "type": [ "integer", "null" ], "minimum": 0 }, "remainingCapacity": { "type": [ "integer", "null" ], "minimum": 0 } } } } } }, "responses": { "200": { "description": "The updated availability slot pickup", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "slotId": { "type": "string" }, "pickupPointId": { "type": "string" }, "initialCapacity": { "type": [ "integer", "null" ] }, "remainingCapacity": { "type": [ "integer", "null" ] }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "slotId", "pickupPointId", "initialCapacity", "remainingCapacity", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Availability slot pickup not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "patchAdminOperationsAvailabilitySlotPickupsById", "summary": "PATCH /v1/admin/operations/availability/slot-pickups/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "delete": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "Availability slot pickup deleted", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] } }, "required": [ "success" ] } } } }, "404": { "description": "Availability slot pickup not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "deleteAdminOperationsAvailabilitySlotPickupsById", "summary": "DELETE /v1/admin/operations/availability/slot-pickups/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/availability/meeting-configs": { "get": { "parameters": [ { "schema": { "type": "integer", "minimum": 1, "maximum": 200, "default": 50 }, "required": false, "name": "limit", "in": "query" }, { "schema": { "type": [ "integer", "null" ], "minimum": 0, "default": 0 }, "required": false, "name": "offset", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "productId", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "optionId", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "facilityId", "in": "query" }, { "schema": { "type": "string", "enum": [ "meeting_only", "pickup_only", "meet_or_pickup" ] }, "required": false, "name": "mode", "in": "query" }, { "schema": { "type": "string", "enum": [ "0", "1", "true", "false" ] }, "required": false, "name": "active", "in": "query" } ], "responses": { "200": { "description": "Paginated product meeting configs", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "productId": { "type": "string" }, "optionId": { "type": [ "string", "null" ] }, "facilityId": { "type": [ "string", "null" ] }, "mode": { "type": "string", "enum": [ "meeting_only", "pickup_only", "meet_or_pickup" ] }, "allowCustomPickup": { "type": "boolean" }, "allowCustomDropoff": { "type": "boolean" }, "requiresPickupSelection": { "type": "boolean" }, "requiresDropoffSelection": { "type": "boolean" }, "usePickupAllotment": { "type": "boolean" }, "meetingInstructions": { "type": [ "string", "null" ] }, "pickupInstructions": { "type": [ "string", "null" ] }, "dropoffInstructions": { "type": [ "string", "null" ] }, "active": { "type": "boolean" }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" }, "productName": { "type": [ "string", "null" ] } }, "required": [ "id", "productId", "optionId", "facilityId", "mode", "allowCustomPickup", "allowCustomDropoff", "requiresPickupSelection", "requiresDropoffSelection", "usePickupAllotment", "meetingInstructions", "pickupInstructions", "dropoffInstructions", "active", "createdAt", "updatedAt" ] } }, "total": { "type": "integer" }, "limit": { "type": "integer" }, "offset": { "type": "integer" } }, "required": [ "data", "total", "limit", "offset" ] } } } } }, "operationId": "getAdminOperationsAvailabilityMeetingConfigs", "summary": "GET /v1/admin/operations/availability/meeting-configs", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "post": { "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "productId": { "type": "string" }, "optionId": { "type": [ "string", "null" ] }, "facilityId": { "type": [ "string", "null" ] }, "mode": { "type": "string", "enum": [ "meeting_only", "pickup_only", "meet_or_pickup" ], "default": "meeting_only" }, "allowCustomPickup": { "type": "boolean", "default": false }, "allowCustomDropoff": { "type": "boolean", "default": false }, "requiresPickupSelection": { "type": "boolean", "default": false }, "requiresDropoffSelection": { "type": "boolean", "default": false }, "usePickupAllotment": { "type": "boolean", "default": false }, "meetingInstructions": { "type": [ "string", "null" ] }, "pickupInstructions": { "type": [ "string", "null" ] }, "dropoffInstructions": { "type": [ "string", "null" ] }, "active": { "type": "boolean", "default": true } }, "required": [ "productId" ] } } } }, "responses": { "201": { "description": "The created product meeting config", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "productId": { "type": "string" }, "optionId": { "type": [ "string", "null" ] }, "facilityId": { "type": [ "string", "null" ] }, "mode": { "type": "string", "enum": [ "meeting_only", "pickup_only", "meet_or_pickup" ] }, "allowCustomPickup": { "type": "boolean" }, "allowCustomDropoff": { "type": "boolean" }, "requiresPickupSelection": { "type": "boolean" }, "requiresDropoffSelection": { "type": "boolean" }, "usePickupAllotment": { "type": "boolean" }, "meetingInstructions": { "type": [ "string", "null" ] }, "pickupInstructions": { "type": [ "string", "null" ] }, "dropoffInstructions": { "type": [ "string", "null" ] }, "active": { "type": "boolean" }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "productId", "optionId", "facilityId", "mode", "allowCustomPickup", "allowCustomDropoff", "requiresPickupSelection", "requiresDropoffSelection", "usePickupAllotment", "meetingInstructions", "pickupInstructions", "dropoffInstructions", "active", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "postAdminOperationsAvailabilityMeetingConfigs", "summary": "POST /v1/admin/operations/availability/meeting-configs", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/availability/meeting-configs/batch-update": { "post": { "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "ids": { "type": "array", "items": { "type": "string" }, "minItems": 1, "maxItems": 200 }, "patch": { "type": "object", "properties": { "productId": { "type": "string" }, "optionId": { "type": [ "string", "null" ] }, "facilityId": { "type": [ "string", "null" ] }, "mode": { "type": "string", "enum": [ "meeting_only", "pickup_only", "meet_or_pickup" ], "default": "meeting_only" }, "allowCustomPickup": { "type": "boolean", "default": false }, "allowCustomDropoff": { "type": "boolean", "default": false }, "requiresPickupSelection": { "type": "boolean", "default": false }, "requiresDropoffSelection": { "type": "boolean", "default": false }, "usePickupAllotment": { "type": "boolean", "default": false }, "meetingInstructions": { "type": [ "string", "null" ] }, "pickupInstructions": { "type": [ "string", "null" ] }, "dropoffInstructions": { "type": [ "string", "null" ] }, "active": { "type": "boolean", "default": true } } } }, "required": [ "ids", "patch" ] } } } }, "responses": { "200": { "description": "Per-id batch-update results (missing ids reported under `failed`)", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "productId": { "type": "string" }, "optionId": { "type": [ "string", "null" ] }, "facilityId": { "type": [ "string", "null" ] }, "mode": { "type": "string", "enum": [ "meeting_only", "pickup_only", "meet_or_pickup" ] }, "allowCustomPickup": { "type": "boolean" }, "allowCustomDropoff": { "type": "boolean" }, "requiresPickupSelection": { "type": "boolean" }, "requiresDropoffSelection": { "type": "boolean" }, "usePickupAllotment": { "type": "boolean" }, "meetingInstructions": { "type": [ "string", "null" ] }, "pickupInstructions": { "type": [ "string", "null" ] }, "dropoffInstructions": { "type": [ "string", "null" ] }, "active": { "type": "boolean" }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "productId", "optionId", "facilityId", "mode", "allowCustomPickup", "allowCustomDropoff", "requiresPickupSelection", "requiresDropoffSelection", "usePickupAllotment", "meetingInstructions", "pickupInstructions", "dropoffInstructions", "active", "createdAt", "updatedAt" ] } }, "total": { "type": "integer" }, "succeeded": { "type": "integer" }, "failed": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "error": { "type": "string" } }, "required": [ "id", "error" ] } } }, "required": [ "data", "total", "succeeded", "failed" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "postAdminOperationsAvailabilityMeetingConfigsBatchUpdate", "summary": "POST /v1/admin/operations/availability/meeting-configs/batch-update", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/availability/meeting-configs/batch-delete": { "post": { "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "ids": { "type": "array", "items": { "type": "string" }, "minItems": 1, "maxItems": 200 } }, "required": [ "ids" ] } } } }, "responses": { "200": { "description": "Per-id batch-delete results (missing ids reported under `failed`)", "content": { "application/json": { "schema": { "type": "object", "properties": { "deletedIds": { "type": "array", "items": { "type": "string" } }, "total": { "type": "integer" }, "succeeded": { "type": "integer" }, "failed": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "error": { "type": "string" } }, "required": [ "id", "error" ] } } }, "required": [ "deletedIds", "total", "succeeded", "failed" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "postAdminOperationsAvailabilityMeetingConfigsBatchDelete", "summary": "POST /v1/admin/operations/availability/meeting-configs/batch-delete", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/availability/meeting-configs/{id}": { "get": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "A product meeting config by id", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "productId": { "type": "string" }, "optionId": { "type": [ "string", "null" ] }, "facilityId": { "type": [ "string", "null" ] }, "mode": { "type": "string", "enum": [ "meeting_only", "pickup_only", "meet_or_pickup" ] }, "allowCustomPickup": { "type": "boolean" }, "allowCustomDropoff": { "type": "boolean" }, "requiresPickupSelection": { "type": "boolean" }, "requiresDropoffSelection": { "type": "boolean" }, "usePickupAllotment": { "type": "boolean" }, "meetingInstructions": { "type": [ "string", "null" ] }, "pickupInstructions": { "type": [ "string", "null" ] }, "dropoffInstructions": { "type": [ "string", "null" ] }, "active": { "type": "boolean" }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "productId", "optionId", "facilityId", "mode", "allowCustomPickup", "allowCustomDropoff", "requiresPickupSelection", "requiresDropoffSelection", "usePickupAllotment", "meetingInstructions", "pickupInstructions", "dropoffInstructions", "active", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "404": { "description": "Product meeting config not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "getAdminOperationsAvailabilityMeetingConfigsById", "summary": "GET /v1/admin/operations/availability/meeting-configs/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "patch": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "productId": { "type": "string" }, "optionId": { "type": [ "string", "null" ] }, "facilityId": { "type": [ "string", "null" ] }, "mode": { "type": "string", "enum": [ "meeting_only", "pickup_only", "meet_or_pickup" ], "default": "meeting_only" }, "allowCustomPickup": { "type": "boolean", "default": false }, "allowCustomDropoff": { "type": "boolean", "default": false }, "requiresPickupSelection": { "type": "boolean", "default": false }, "requiresDropoffSelection": { "type": "boolean", "default": false }, "usePickupAllotment": { "type": "boolean", "default": false }, "meetingInstructions": { "type": [ "string", "null" ] }, "pickupInstructions": { "type": [ "string", "null" ] }, "dropoffInstructions": { "type": [ "string", "null" ] }, "active": { "type": "boolean", "default": true } } } } } }, "responses": { "200": { "description": "The updated product meeting config", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "productId": { "type": "string" }, "optionId": { "type": [ "string", "null" ] }, "facilityId": { "type": [ "string", "null" ] }, "mode": { "type": "string", "enum": [ "meeting_only", "pickup_only", "meet_or_pickup" ] }, "allowCustomPickup": { "type": "boolean" }, "allowCustomDropoff": { "type": "boolean" }, "requiresPickupSelection": { "type": "boolean" }, "requiresDropoffSelection": { "type": "boolean" }, "usePickupAllotment": { "type": "boolean" }, "meetingInstructions": { "type": [ "string", "null" ] }, "pickupInstructions": { "type": [ "string", "null" ] }, "dropoffInstructions": { "type": [ "string", "null" ] }, "active": { "type": "boolean" }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "productId", "optionId", "facilityId", "mode", "allowCustomPickup", "allowCustomDropoff", "requiresPickupSelection", "requiresDropoffSelection", "usePickupAllotment", "meetingInstructions", "pickupInstructions", "dropoffInstructions", "active", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Product meeting config not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "patchAdminOperationsAvailabilityMeetingConfigsById", "summary": "PATCH /v1/admin/operations/availability/meeting-configs/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "delete": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "Product meeting config deleted", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] } }, "required": [ "success" ] } } } }, "404": { "description": "Product meeting config not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "deleteAdminOperationsAvailabilityMeetingConfigsById", "summary": "DELETE /v1/admin/operations/availability/meeting-configs/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/availability/pickup-groups": { "get": { "parameters": [ { "schema": { "type": "integer", "minimum": 1, "maximum": 200, "default": 50 }, "required": false, "name": "limit", "in": "query" }, { "schema": { "type": [ "integer", "null" ], "minimum": 0, "default": 0 }, "required": false, "name": "offset", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "meetingConfigId", "in": "query" }, { "schema": { "type": "string", "enum": [ "pickup", "dropoff", "meeting" ] }, "required": false, "name": "kind", "in": "query" }, { "schema": { "type": "string", "enum": [ "0", "1", "true", "false" ] }, "required": false, "name": "active", "in": "query" } ], "responses": { "200": { "description": "Paginated pickup groups", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "meetingConfigId": { "type": "string" }, "kind": { "type": "string", "enum": [ "pickup", "dropoff", "meeting" ] }, "name": { "type": "string" }, "description": { "type": [ "string", "null" ] }, "active": { "type": "boolean" }, "sortOrder": { "type": "integer" }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "meetingConfigId", "kind", "name", "description", "active", "sortOrder", "createdAt", "updatedAt" ] } }, "total": { "type": "integer" }, "limit": { "type": "integer" }, "offset": { "type": "integer" } }, "required": [ "data", "total", "limit", "offset" ] } } } } }, "operationId": "getAdminOperationsAvailabilityPickupGroups", "summary": "GET /v1/admin/operations/availability/pickup-groups", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "post": { "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "meetingConfigId": { "type": "string" }, "kind": { "type": "string", "enum": [ "pickup", "dropoff", "meeting" ] }, "name": { "type": "string", "minLength": 1 }, "description": { "type": [ "string", "null" ] }, "active": { "type": "boolean", "default": true }, "sortOrder": { "type": "integer", "default": 0 } }, "required": [ "meetingConfigId", "kind", "name" ] } } } }, "responses": { "201": { "description": "The created pickup group", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "meetingConfigId": { "type": "string" }, "kind": { "type": "string", "enum": [ "pickup", "dropoff", "meeting" ] }, "name": { "type": "string" }, "description": { "type": [ "string", "null" ] }, "active": { "type": "boolean" }, "sortOrder": { "type": "integer" }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "meetingConfigId", "kind", "name", "description", "active", "sortOrder", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "postAdminOperationsAvailabilityPickupGroups", "summary": "POST /v1/admin/operations/availability/pickup-groups", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/availability/pickup-groups/batch-update": { "post": { "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "ids": { "type": "array", "items": { "type": "string" }, "minItems": 1, "maxItems": 200 }, "patch": { "type": "object", "properties": { "meetingConfigId": { "type": "string" }, "kind": { "type": "string", "enum": [ "pickup", "dropoff", "meeting" ] }, "name": { "type": "string", "minLength": 1 }, "description": { "type": [ "string", "null" ] }, "active": { "type": "boolean", "default": true }, "sortOrder": { "type": "integer", "default": 0 } } } }, "required": [ "ids", "patch" ] } } } }, "responses": { "200": { "description": "Per-id batch-update results (missing ids reported under `failed`)", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "meetingConfigId": { "type": "string" }, "kind": { "type": "string", "enum": [ "pickup", "dropoff", "meeting" ] }, "name": { "type": "string" }, "description": { "type": [ "string", "null" ] }, "active": { "type": "boolean" }, "sortOrder": { "type": "integer" }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "meetingConfigId", "kind", "name", "description", "active", "sortOrder", "createdAt", "updatedAt" ] } }, "total": { "type": "integer" }, "succeeded": { "type": "integer" }, "failed": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "error": { "type": "string" } }, "required": [ "id", "error" ] } } }, "required": [ "data", "total", "succeeded", "failed" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "postAdminOperationsAvailabilityPickupGroupsBatchUpdate", "summary": "POST /v1/admin/operations/availability/pickup-groups/batch-update", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/availability/pickup-groups/batch-delete": { "post": { "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "ids": { "type": "array", "items": { "type": "string" }, "minItems": 1, "maxItems": 200 } }, "required": [ "ids" ] } } } }, "responses": { "200": { "description": "Per-id batch-delete results (missing ids reported under `failed`)", "content": { "application/json": { "schema": { "type": "object", "properties": { "deletedIds": { "type": "array", "items": { "type": "string" } }, "total": { "type": "integer" }, "succeeded": { "type": "integer" }, "failed": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "error": { "type": "string" } }, "required": [ "id", "error" ] } } }, "required": [ "deletedIds", "total", "succeeded", "failed" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "postAdminOperationsAvailabilityPickupGroupsBatchDelete", "summary": "POST /v1/admin/operations/availability/pickup-groups/batch-delete", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/availability/pickup-groups/{id}": { "get": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "A pickup group by id", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "meetingConfigId": { "type": "string" }, "kind": { "type": "string", "enum": [ "pickup", "dropoff", "meeting" ] }, "name": { "type": "string" }, "description": { "type": [ "string", "null" ] }, "active": { "type": "boolean" }, "sortOrder": { "type": "integer" }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "meetingConfigId", "kind", "name", "description", "active", "sortOrder", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "404": { "description": "Pickup group not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "getAdminOperationsAvailabilityPickupGroupsById", "summary": "GET /v1/admin/operations/availability/pickup-groups/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "patch": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "meetingConfigId": { "type": "string" }, "kind": { "type": "string", "enum": [ "pickup", "dropoff", "meeting" ] }, "name": { "type": "string", "minLength": 1 }, "description": { "type": [ "string", "null" ] }, "active": { "type": "boolean", "default": true }, "sortOrder": { "type": "integer", "default": 0 } } } } } }, "responses": { "200": { "description": "The updated pickup group", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "meetingConfigId": { "type": "string" }, "kind": { "type": "string", "enum": [ "pickup", "dropoff", "meeting" ] }, "name": { "type": "string" }, "description": { "type": [ "string", "null" ] }, "active": { "type": "boolean" }, "sortOrder": { "type": "integer" }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "meetingConfigId", "kind", "name", "description", "active", "sortOrder", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Pickup group not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "patchAdminOperationsAvailabilityPickupGroupsById", "summary": "PATCH /v1/admin/operations/availability/pickup-groups/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "delete": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "Pickup group deleted", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] } }, "required": [ "success" ] } } } }, "404": { "description": "Pickup group not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "deleteAdminOperationsAvailabilityPickupGroupsById", "summary": "DELETE /v1/admin/operations/availability/pickup-groups/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/availability/pickup-locations": { "get": { "parameters": [ { "schema": { "type": "integer", "minimum": 1, "maximum": 200, "default": 50 }, "required": false, "name": "limit", "in": "query" }, { "schema": { "type": [ "integer", "null" ], "minimum": 0, "default": 0 }, "required": false, "name": "offset", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "groupId", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "facilityId", "in": "query" }, { "schema": { "type": "string", "enum": [ "0", "1", "true", "false" ] }, "required": false, "name": "active", "in": "query" } ], "responses": { "200": { "description": "Paginated pickup locations", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "groupId": { "type": "string" }, "facilityId": { "type": [ "string", "null" ] }, "name": { "type": "string" }, "description": { "type": [ "string", "null" ] }, "locationText": { "type": [ "string", "null" ] }, "leadTimeMinutes": { "type": [ "integer", "null" ] }, "active": { "type": "boolean" }, "sortOrder": { "type": "integer" }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "groupId", "facilityId", "name", "description", "locationText", "leadTimeMinutes", "active", "sortOrder", "createdAt", "updatedAt" ] } }, "total": { "type": "integer" }, "limit": { "type": "integer" }, "offset": { "type": "integer" } }, "required": [ "data", "total", "limit", "offset" ] } } } } }, "operationId": "getAdminOperationsAvailabilityPickupLocations", "summary": "GET /v1/admin/operations/availability/pickup-locations", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "post": { "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "groupId": { "type": "string" }, "facilityId": { "type": [ "string", "null" ] }, "name": { "type": "string", "minLength": 1 }, "description": { "type": [ "string", "null" ] }, "locationText": { "type": [ "string", "null" ] }, "leadTimeMinutes": { "type": [ "integer", "null" ], "minimum": 0 }, "active": { "type": "boolean", "default": true }, "sortOrder": { "type": "integer", "default": 0 } }, "required": [ "groupId", "name" ] } } } }, "responses": { "201": { "description": "The created pickup location", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "groupId": { "type": "string" }, "facilityId": { "type": [ "string", "null" ] }, "name": { "type": "string" }, "description": { "type": [ "string", "null" ] }, "locationText": { "type": [ "string", "null" ] }, "leadTimeMinutes": { "type": [ "integer", "null" ] }, "active": { "type": "boolean" }, "sortOrder": { "type": "integer" }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "groupId", "facilityId", "name", "description", "locationText", "leadTimeMinutes", "active", "sortOrder", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "postAdminOperationsAvailabilityPickupLocations", "summary": "POST /v1/admin/operations/availability/pickup-locations", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/availability/pickup-locations/batch-update": { "post": { "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "ids": { "type": "array", "items": { "type": "string" }, "minItems": 1, "maxItems": 200 }, "patch": { "type": "object", "properties": { "groupId": { "type": "string" }, "facilityId": { "type": [ "string", "null" ] }, "name": { "type": "string", "minLength": 1 }, "description": { "type": [ "string", "null" ] }, "locationText": { "type": [ "string", "null" ] }, "leadTimeMinutes": { "type": [ "integer", "null" ], "minimum": 0 }, "active": { "type": "boolean", "default": true }, "sortOrder": { "type": "integer", "default": 0 } } } }, "required": [ "ids", "patch" ] } } } }, "responses": { "200": { "description": "Per-id batch-update results (missing ids reported under `failed`)", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "groupId": { "type": "string" }, "facilityId": { "type": [ "string", "null" ] }, "name": { "type": "string" }, "description": { "type": [ "string", "null" ] }, "locationText": { "type": [ "string", "null" ] }, "leadTimeMinutes": { "type": [ "integer", "null" ] }, "active": { "type": "boolean" }, "sortOrder": { "type": "integer" }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "groupId", "facilityId", "name", "description", "locationText", "leadTimeMinutes", "active", "sortOrder", "createdAt", "updatedAt" ] } }, "total": { "type": "integer" }, "succeeded": { "type": "integer" }, "failed": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "error": { "type": "string" } }, "required": [ "id", "error" ] } } }, "required": [ "data", "total", "succeeded", "failed" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "postAdminOperationsAvailabilityPickupLocationsBatchUpdate", "summary": "POST /v1/admin/operations/availability/pickup-locations/batch-update", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/availability/pickup-locations/batch-delete": { "post": { "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "ids": { "type": "array", "items": { "type": "string" }, "minItems": 1, "maxItems": 200 } }, "required": [ "ids" ] } } } }, "responses": { "200": { "description": "Per-id batch-delete results (missing ids reported under `failed`)", "content": { "application/json": { "schema": { "type": "object", "properties": { "deletedIds": { "type": "array", "items": { "type": "string" } }, "total": { "type": "integer" }, "succeeded": { "type": "integer" }, "failed": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "error": { "type": "string" } }, "required": [ "id", "error" ] } } }, "required": [ "deletedIds", "total", "succeeded", "failed" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "postAdminOperationsAvailabilityPickupLocationsBatchDelete", "summary": "POST /v1/admin/operations/availability/pickup-locations/batch-delete", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/availability/pickup-locations/{id}": { "get": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "A pickup location by id", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "groupId": { "type": "string" }, "facilityId": { "type": [ "string", "null" ] }, "name": { "type": "string" }, "description": { "type": [ "string", "null" ] }, "locationText": { "type": [ "string", "null" ] }, "leadTimeMinutes": { "type": [ "integer", "null" ] }, "active": { "type": "boolean" }, "sortOrder": { "type": "integer" }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "groupId", "facilityId", "name", "description", "locationText", "leadTimeMinutes", "active", "sortOrder", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "404": { "description": "Pickup location not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "getAdminOperationsAvailabilityPickupLocationsById", "summary": "GET /v1/admin/operations/availability/pickup-locations/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "patch": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "groupId": { "type": "string" }, "facilityId": { "type": [ "string", "null" ] }, "name": { "type": "string", "minLength": 1 }, "description": { "type": [ "string", "null" ] }, "locationText": { "type": [ "string", "null" ] }, "leadTimeMinutes": { "type": [ "integer", "null" ], "minimum": 0 }, "active": { "type": "boolean", "default": true }, "sortOrder": { "type": "integer", "default": 0 } } } } } }, "responses": { "200": { "description": "The updated pickup location", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "groupId": { "type": "string" }, "facilityId": { "type": [ "string", "null" ] }, "name": { "type": "string" }, "description": { "type": [ "string", "null" ] }, "locationText": { "type": [ "string", "null" ] }, "leadTimeMinutes": { "type": [ "integer", "null" ] }, "active": { "type": "boolean" }, "sortOrder": { "type": "integer" }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "groupId", "facilityId", "name", "description", "locationText", "leadTimeMinutes", "active", "sortOrder", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Pickup location not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "patchAdminOperationsAvailabilityPickupLocationsById", "summary": "PATCH /v1/admin/operations/availability/pickup-locations/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "delete": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "Pickup location deleted", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] } }, "required": [ "success" ] } } } }, "404": { "description": "Pickup location not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "deleteAdminOperationsAvailabilityPickupLocationsById", "summary": "DELETE /v1/admin/operations/availability/pickup-locations/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/availability/location-pickup-times": { "get": { "parameters": [ { "schema": { "type": "integer", "minimum": 1, "maximum": 200, "default": 50 }, "required": false, "name": "limit", "in": "query" }, { "schema": { "type": [ "integer", "null" ], "minimum": 0, "default": 0 }, "required": false, "name": "offset", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "pickupLocationId", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "slotId", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "startTimeId", "in": "query" }, { "schema": { "type": "string", "enum": [ "0", "1", "true", "false" ] }, "required": false, "name": "active", "in": "query" } ], "responses": { "200": { "description": "Paginated location pickup times", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "pickupLocationId": { "type": "string" }, "slotId": { "type": [ "string", "null" ] }, "startTimeId": { "type": [ "string", "null" ] }, "timingMode": { "type": "string", "enum": [ "fixed_time", "offset_from_start" ] }, "localTime": { "type": [ "string", "null" ] }, "offsetMinutes": { "type": [ "integer", "null" ] }, "instructions": { "type": [ "string", "null" ] }, "initialCapacity": { "type": [ "integer", "null" ] }, "remainingCapacity": { "type": [ "integer", "null" ] }, "active": { "type": "boolean" }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "pickupLocationId", "slotId", "startTimeId", "timingMode", "localTime", "offsetMinutes", "instructions", "initialCapacity", "remainingCapacity", "active", "createdAt", "updatedAt" ] } }, "total": { "type": "integer" }, "limit": { "type": "integer" }, "offset": { "type": "integer" } }, "required": [ "data", "total", "limit", "offset" ] } } } } }, "operationId": "getAdminOperationsAvailabilityLocationPickupTimes", "summary": "GET /v1/admin/operations/availability/location-pickup-times", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "post": { "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "pickupLocationId": { "type": "string" }, "slotId": { "type": [ "string", "null" ] }, "startTimeId": { "type": [ "string", "null" ] }, "timingMode": { "type": "string", "enum": [ "fixed_time", "offset_from_start" ], "default": "fixed_time" }, "localTime": { "type": [ "string", "null" ] }, "offsetMinutes": { "type": [ "integer", "null" ] }, "instructions": { "type": [ "string", "null" ] }, "initialCapacity": { "type": [ "integer", "null" ], "minimum": 0 }, "remainingCapacity": { "type": [ "integer", "null" ], "minimum": 0 }, "active": { "type": "boolean", "default": true } }, "required": [ "pickupLocationId" ] } } } }, "responses": { "201": { "description": "The created location pickup time", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "pickupLocationId": { "type": "string" }, "slotId": { "type": [ "string", "null" ] }, "startTimeId": { "type": [ "string", "null" ] }, "timingMode": { "type": "string", "enum": [ "fixed_time", "offset_from_start" ] }, "localTime": { "type": [ "string", "null" ] }, "offsetMinutes": { "type": [ "integer", "null" ] }, "instructions": { "type": [ "string", "null" ] }, "initialCapacity": { "type": [ "integer", "null" ] }, "remainingCapacity": { "type": [ "integer", "null" ] }, "active": { "type": "boolean" }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "pickupLocationId", "slotId", "startTimeId", "timingMode", "localTime", "offsetMinutes", "instructions", "initialCapacity", "remainingCapacity", "active", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "postAdminOperationsAvailabilityLocationPickupTimes", "summary": "POST /v1/admin/operations/availability/location-pickup-times", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/availability/location-pickup-times/batch-update": { "post": { "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "ids": { "type": "array", "items": { "type": "string" }, "minItems": 1, "maxItems": 200 }, "patch": { "type": "object", "properties": { "pickupLocationId": { "type": "string" }, "slotId": { "type": [ "string", "null" ] }, "startTimeId": { "type": [ "string", "null" ] }, "timingMode": { "type": "string", "enum": [ "fixed_time", "offset_from_start" ], "default": "fixed_time" }, "localTime": { "type": [ "string", "null" ] }, "offsetMinutes": { "type": [ "integer", "null" ] }, "instructions": { "type": [ "string", "null" ] }, "initialCapacity": { "type": [ "integer", "null" ], "minimum": 0 }, "remainingCapacity": { "type": [ "integer", "null" ], "minimum": 0 }, "active": { "type": "boolean", "default": true } } } }, "required": [ "ids", "patch" ] } } } }, "responses": { "200": { "description": "Per-id batch-update results (missing ids reported under `failed`)", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "pickupLocationId": { "type": "string" }, "slotId": { "type": [ "string", "null" ] }, "startTimeId": { "type": [ "string", "null" ] }, "timingMode": { "type": "string", "enum": [ "fixed_time", "offset_from_start" ] }, "localTime": { "type": [ "string", "null" ] }, "offsetMinutes": { "type": [ "integer", "null" ] }, "instructions": { "type": [ "string", "null" ] }, "initialCapacity": { "type": [ "integer", "null" ] }, "remainingCapacity": { "type": [ "integer", "null" ] }, "active": { "type": "boolean" }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "pickupLocationId", "slotId", "startTimeId", "timingMode", "localTime", "offsetMinutes", "instructions", "initialCapacity", "remainingCapacity", "active", "createdAt", "updatedAt" ] } }, "total": { "type": "integer" }, "succeeded": { "type": "integer" }, "failed": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "error": { "type": "string" } }, "required": [ "id", "error" ] } } }, "required": [ "data", "total", "succeeded", "failed" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "postAdminOperationsAvailabilityLocationPickupTimesBatchUpdate", "summary": "POST /v1/admin/operations/availability/location-pickup-times/batch-update", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/availability/location-pickup-times/batch-delete": { "post": { "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "ids": { "type": "array", "items": { "type": "string" }, "minItems": 1, "maxItems": 200 } }, "required": [ "ids" ] } } } }, "responses": { "200": { "description": "Per-id batch-delete results (missing ids reported under `failed`)", "content": { "application/json": { "schema": { "type": "object", "properties": { "deletedIds": { "type": "array", "items": { "type": "string" } }, "total": { "type": "integer" }, "succeeded": { "type": "integer" }, "failed": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "error": { "type": "string" } }, "required": [ "id", "error" ] } } }, "required": [ "deletedIds", "total", "succeeded", "failed" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "postAdminOperationsAvailabilityLocationPickupTimesBatchDelete", "summary": "POST /v1/admin/operations/availability/location-pickup-times/batch-delete", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/availability/location-pickup-times/{id}": { "get": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "A location pickup time by id", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "pickupLocationId": { "type": "string" }, "slotId": { "type": [ "string", "null" ] }, "startTimeId": { "type": [ "string", "null" ] }, "timingMode": { "type": "string", "enum": [ "fixed_time", "offset_from_start" ] }, "localTime": { "type": [ "string", "null" ] }, "offsetMinutes": { "type": [ "integer", "null" ] }, "instructions": { "type": [ "string", "null" ] }, "initialCapacity": { "type": [ "integer", "null" ] }, "remainingCapacity": { "type": [ "integer", "null" ] }, "active": { "type": "boolean" }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "pickupLocationId", "slotId", "startTimeId", "timingMode", "localTime", "offsetMinutes", "instructions", "initialCapacity", "remainingCapacity", "active", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "404": { "description": "Location pickup time not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "getAdminOperationsAvailabilityLocationPickupTimesById", "summary": "GET /v1/admin/operations/availability/location-pickup-times/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "patch": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "pickupLocationId": { "type": "string" }, "slotId": { "type": [ "string", "null" ] }, "startTimeId": { "type": [ "string", "null" ] }, "timingMode": { "type": "string", "enum": [ "fixed_time", "offset_from_start" ], "default": "fixed_time" }, "localTime": { "type": [ "string", "null" ] }, "offsetMinutes": { "type": [ "integer", "null" ] }, "instructions": { "type": [ "string", "null" ] }, "initialCapacity": { "type": [ "integer", "null" ], "minimum": 0 }, "remainingCapacity": { "type": [ "integer", "null" ], "minimum": 0 }, "active": { "type": "boolean", "default": true } } } } } }, "responses": { "200": { "description": "The updated location pickup time", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "pickupLocationId": { "type": "string" }, "slotId": { "type": [ "string", "null" ] }, "startTimeId": { "type": [ "string", "null" ] }, "timingMode": { "type": "string", "enum": [ "fixed_time", "offset_from_start" ] }, "localTime": { "type": [ "string", "null" ] }, "offsetMinutes": { "type": [ "integer", "null" ] }, "instructions": { "type": [ "string", "null" ] }, "initialCapacity": { "type": [ "integer", "null" ] }, "remainingCapacity": { "type": [ "integer", "null" ] }, "active": { "type": "boolean" }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "pickupLocationId", "slotId", "startTimeId", "timingMode", "localTime", "offsetMinutes", "instructions", "initialCapacity", "remainingCapacity", "active", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Location pickup time not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "patchAdminOperationsAvailabilityLocationPickupTimesById", "summary": "PATCH /v1/admin/operations/availability/location-pickup-times/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "delete": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "Location pickup time deleted", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] } }, "required": [ "success" ] } } } }, "404": { "description": "Location pickup time not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "deleteAdminOperationsAvailabilityLocationPickupTimesById", "summary": "DELETE /v1/admin/operations/availability/location-pickup-times/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/availability/custom-pickup-areas": { "get": { "parameters": [ { "schema": { "type": "integer", "minimum": 1, "maximum": 200, "default": 50 }, "required": false, "name": "limit", "in": "query" }, { "schema": { "type": [ "integer", "null" ], "minimum": 0, "default": 0 }, "required": false, "name": "offset", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "meetingConfigId", "in": "query" }, { "schema": { "type": "string", "enum": [ "0", "1", "true", "false" ] }, "required": false, "name": "active", "in": "query" } ], "responses": { "200": { "description": "Paginated custom pickup areas", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "meetingConfigId": { "type": "string" }, "name": { "type": "string" }, "description": { "type": [ "string", "null" ] }, "geographicText": { "type": [ "string", "null" ] }, "active": { "type": "boolean" }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "meetingConfigId", "name", "description", "geographicText", "active", "createdAt", "updatedAt" ] } }, "total": { "type": "integer" }, "limit": { "type": "integer" }, "offset": { "type": "integer" } }, "required": [ "data", "total", "limit", "offset" ] } } } } }, "operationId": "getAdminOperationsAvailabilityCustomPickupAreas", "summary": "GET /v1/admin/operations/availability/custom-pickup-areas", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "post": { "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "meetingConfigId": { "type": "string" }, "name": { "type": "string", "minLength": 1 }, "description": { "type": [ "string", "null" ] }, "geographicText": { "type": [ "string", "null" ] }, "active": { "type": "boolean", "default": true } }, "required": [ "meetingConfigId", "name" ] } } } }, "responses": { "201": { "description": "The created custom pickup area", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "meetingConfigId": { "type": "string" }, "name": { "type": "string" }, "description": { "type": [ "string", "null" ] }, "geographicText": { "type": [ "string", "null" ] }, "active": { "type": "boolean" }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "meetingConfigId", "name", "description", "geographicText", "active", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "postAdminOperationsAvailabilityCustomPickupAreas", "summary": "POST /v1/admin/operations/availability/custom-pickup-areas", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/availability/custom-pickup-areas/batch-update": { "post": { "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "ids": { "type": "array", "items": { "type": "string" }, "minItems": 1, "maxItems": 200 }, "patch": { "type": "object", "properties": { "meetingConfigId": { "type": "string" }, "name": { "type": "string", "minLength": 1 }, "description": { "type": [ "string", "null" ] }, "geographicText": { "type": [ "string", "null" ] }, "active": { "type": "boolean", "default": true } } } }, "required": [ "ids", "patch" ] } } } }, "responses": { "200": { "description": "Per-id batch-update results (missing ids reported under `failed`)", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "meetingConfigId": { "type": "string" }, "name": { "type": "string" }, "description": { "type": [ "string", "null" ] }, "geographicText": { "type": [ "string", "null" ] }, "active": { "type": "boolean" }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "meetingConfigId", "name", "description", "geographicText", "active", "createdAt", "updatedAt" ] } }, "total": { "type": "integer" }, "succeeded": { "type": "integer" }, "failed": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "error": { "type": "string" } }, "required": [ "id", "error" ] } } }, "required": [ "data", "total", "succeeded", "failed" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "postAdminOperationsAvailabilityCustomPickupAreasBatchUpdate", "summary": "POST /v1/admin/operations/availability/custom-pickup-areas/batch-update", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/availability/custom-pickup-areas/batch-delete": { "post": { "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "ids": { "type": "array", "items": { "type": "string" }, "minItems": 1, "maxItems": 200 } }, "required": [ "ids" ] } } } }, "responses": { "200": { "description": "Per-id batch-delete results (missing ids reported under `failed`)", "content": { "application/json": { "schema": { "type": "object", "properties": { "deletedIds": { "type": "array", "items": { "type": "string" } }, "total": { "type": "integer" }, "succeeded": { "type": "integer" }, "failed": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "error": { "type": "string" } }, "required": [ "id", "error" ] } } }, "required": [ "deletedIds", "total", "succeeded", "failed" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "postAdminOperationsAvailabilityCustomPickupAreasBatchDelete", "summary": "POST /v1/admin/operations/availability/custom-pickup-areas/batch-delete", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/availability/custom-pickup-areas/{id}": { "get": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "A custom pickup area by id", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "meetingConfigId": { "type": "string" }, "name": { "type": "string" }, "description": { "type": [ "string", "null" ] }, "geographicText": { "type": [ "string", "null" ] }, "active": { "type": "boolean" }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "meetingConfigId", "name", "description", "geographicText", "active", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "404": { "description": "Custom pickup area not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "getAdminOperationsAvailabilityCustomPickupAreasById", "summary": "GET /v1/admin/operations/availability/custom-pickup-areas/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "patch": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "meetingConfigId": { "type": "string" }, "name": { "type": "string", "minLength": 1 }, "description": { "type": [ "string", "null" ] }, "geographicText": { "type": [ "string", "null" ] }, "active": { "type": "boolean", "default": true } } } } } }, "responses": { "200": { "description": "The updated custom pickup area", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "meetingConfigId": { "type": "string" }, "name": { "type": "string" }, "description": { "type": [ "string", "null" ] }, "geographicText": { "type": [ "string", "null" ] }, "active": { "type": "boolean" }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "meetingConfigId", "name", "description", "geographicText", "active", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Custom pickup area not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "patchAdminOperationsAvailabilityCustomPickupAreasById", "summary": "PATCH /v1/admin/operations/availability/custom-pickup-areas/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "delete": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "Custom pickup area deleted", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] } }, "required": [ "success" ] } } } }, "404": { "description": "Custom pickup area not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "deleteAdminOperationsAvailabilityCustomPickupAreasById", "summary": "DELETE /v1/admin/operations/availability/custom-pickup-areas/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/resources": { "get": { "parameters": [ { "schema": { "type": "integer", "minimum": 1, "maximum": 200, "default": 50 }, "required": false, "name": "limit", "in": "query" }, { "schema": { "type": [ "integer", "null" ], "minimum": 0, "default": 0 }, "required": false, "name": "offset", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "supplierId", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "facilityId", "in": "query" }, { "schema": { "type": "string", "enum": [ "guide", "vehicle", "room", "boat", "equipment", "other" ] }, "required": false, "name": "kind", "in": "query" }, { "schema": { "type": "string", "enum": [ "0", "1", "true", "false" ] }, "required": false, "name": "active", "in": "query" } ], "responses": { "200": { "description": "Paginated operated resources", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "supplierId": { "type": [ "string", "null" ] }, "facilityId": { "type": [ "string", "null" ] }, "kind": { "type": "string", "enum": [ "guide", "vehicle", "room", "boat", "equipment", "other" ] }, "name": { "type": "string" }, "code": { "type": [ "string", "null" ] }, "capacity": { "type": [ "integer", "null" ] }, "active": { "type": "boolean" }, "notes": { "type": [ "string", "null" ] }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "supplierId", "facilityId", "kind", "name", "code", "capacity", "active", "notes", "createdAt", "updatedAt" ] } }, "total": { "type": "integer" }, "limit": { "type": "integer" }, "offset": { "type": "integer" } }, "required": [ "data", "total", "limit", "offset" ] } } } } }, "operationId": "getAdminOperationsResources", "summary": "GET /v1/admin/operations/resources", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "post": { "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "supplierId": { "type": [ "string", "null" ] }, "facilityId": { "type": [ "string", "null" ] }, "kind": { "type": "string", "enum": [ "guide", "vehicle", "room", "boat", "equipment", "other" ] }, "name": { "type": "string", "minLength": 1 }, "code": { "type": [ "string", "null" ] }, "capacity": { "type": [ "integer", "null" ], "minimum": 0 }, "active": { "type": "boolean", "default": true }, "notes": { "type": [ "string", "null" ] } }, "required": [ "kind", "name" ] } } } }, "responses": { "201": { "description": "The created resource", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "supplierId": { "type": [ "string", "null" ] }, "facilityId": { "type": [ "string", "null" ] }, "kind": { "type": "string", "enum": [ "guide", "vehicle", "room", "boat", "equipment", "other" ] }, "name": { "type": "string" }, "code": { "type": [ "string", "null" ] }, "capacity": { "type": [ "integer", "null" ] }, "active": { "type": "boolean" }, "notes": { "type": [ "string", "null" ] }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "supplierId", "facilityId", "kind", "name", "code", "capacity", "active", "notes", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "postAdminOperationsResources", "summary": "POST /v1/admin/operations/resources", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/resources/batch-update": { "post": { "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "ids": { "type": "array", "items": { "type": "string" }, "minItems": 1, "maxItems": 200 }, "patch": { "type": "object", "properties": { "supplierId": { "type": [ "string", "null" ] }, "facilityId": { "type": [ "string", "null" ] }, "kind": { "type": "string", "enum": [ "guide", "vehicle", "room", "boat", "equipment", "other" ] }, "name": { "type": "string", "minLength": 1 }, "code": { "type": [ "string", "null" ] }, "capacity": { "type": [ "integer", "null" ], "minimum": 0 }, "active": { "type": "boolean" }, "notes": { "type": [ "string", "null" ] } } } }, "required": [ "ids", "patch" ] } } } }, "responses": { "200": { "description": "Per-id batch-update results (missing ids reported under `failed`)", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "supplierId": { "type": [ "string", "null" ] }, "facilityId": { "type": [ "string", "null" ] }, "kind": { "type": "string", "enum": [ "guide", "vehicle", "room", "boat", "equipment", "other" ] }, "name": { "type": "string" }, "code": { "type": [ "string", "null" ] }, "capacity": { "type": [ "integer", "null" ] }, "active": { "type": "boolean" }, "notes": { "type": [ "string", "null" ] }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "supplierId", "facilityId", "kind", "name", "code", "capacity", "active", "notes", "createdAt", "updatedAt" ] } }, "total": { "type": "integer" }, "succeeded": { "type": "integer" }, "failed": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "error": { "type": "string" } }, "required": [ "id", "error" ] } } }, "required": [ "data", "total", "succeeded", "failed" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "postAdminOperationsResourcesBatchUpdate", "summary": "POST /v1/admin/operations/resources/batch-update", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/resources/batch-delete": { "post": { "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "ids": { "type": "array", "items": { "type": "string" }, "minItems": 1, "maxItems": 200 } }, "required": [ "ids" ] } } } }, "responses": { "200": { "description": "Per-id batch-delete results (missing ids reported under `failed`)", "content": { "application/json": { "schema": { "type": "object", "properties": { "deletedIds": { "type": "array", "items": { "type": "string" } }, "total": { "type": "integer" }, "succeeded": { "type": "integer" }, "failed": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "error": { "type": "string" } }, "required": [ "id", "error" ] } } }, "required": [ "deletedIds", "total", "succeeded", "failed" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "postAdminOperationsResourcesBatchDelete", "summary": "POST /v1/admin/operations/resources/batch-delete", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/resources/{id}": { "get": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "A resource by id", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "supplierId": { "type": [ "string", "null" ] }, "facilityId": { "type": [ "string", "null" ] }, "kind": { "type": "string", "enum": [ "guide", "vehicle", "room", "boat", "equipment", "other" ] }, "name": { "type": "string" }, "code": { "type": [ "string", "null" ] }, "capacity": { "type": [ "integer", "null" ] }, "active": { "type": "boolean" }, "notes": { "type": [ "string", "null" ] }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "supplierId", "facilityId", "kind", "name", "code", "capacity", "active", "notes", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "404": { "description": "Resource not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "getAdminOperationsResourcesById", "summary": "GET /v1/admin/operations/resources/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "patch": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "supplierId": { "type": [ "string", "null" ] }, "facilityId": { "type": [ "string", "null" ] }, "kind": { "type": "string", "enum": [ "guide", "vehicle", "room", "boat", "equipment", "other" ] }, "name": { "type": "string", "minLength": 1 }, "code": { "type": [ "string", "null" ] }, "capacity": { "type": [ "integer", "null" ], "minimum": 0 }, "active": { "type": "boolean" }, "notes": { "type": [ "string", "null" ] } } } } } }, "responses": { "200": { "description": "The updated resource", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "supplierId": { "type": [ "string", "null" ] }, "facilityId": { "type": [ "string", "null" ] }, "kind": { "type": "string", "enum": [ "guide", "vehicle", "room", "boat", "equipment", "other" ] }, "name": { "type": "string" }, "code": { "type": [ "string", "null" ] }, "capacity": { "type": [ "integer", "null" ] }, "active": { "type": "boolean" }, "notes": { "type": [ "string", "null" ] }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "supplierId", "facilityId", "kind", "name", "code", "capacity", "active", "notes", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Resource not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "patchAdminOperationsResourcesById", "summary": "PATCH /v1/admin/operations/resources/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "delete": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "Resource deleted", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] } }, "required": [ "success" ] } } } }, "404": { "description": "Resource not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "deleteAdminOperationsResourcesById", "summary": "DELETE /v1/admin/operations/resources/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/pools": { "get": { "parameters": [ { "schema": { "type": "integer", "minimum": 1, "maximum": 200, "default": 50 }, "required": false, "name": "limit", "in": "query" }, { "schema": { "type": [ "integer", "null" ], "minimum": 0, "default": 0 }, "required": false, "name": "offset", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "productId", "in": "query" }, { "schema": { "type": "string", "enum": [ "guide", "vehicle", "room", "boat", "equipment", "other" ] }, "required": false, "name": "kind", "in": "query" }, { "schema": { "type": "string", "enum": [ "0", "1", "true", "false" ] }, "required": false, "name": "active", "in": "query" } ], "responses": { "200": { "description": "Paginated resource pools", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "productId": { "type": [ "string", "null" ] }, "kind": { "type": "string", "enum": [ "guide", "vehicle", "room", "boat", "equipment", "other" ] }, "name": { "type": "string" }, "sharedCapacity": { "type": [ "integer", "null" ] }, "active": { "type": "boolean" }, "notes": { "type": [ "string", "null" ] }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "productId", "kind", "name", "sharedCapacity", "active", "notes", "createdAt", "updatedAt" ] } }, "total": { "type": "integer" }, "limit": { "type": "integer" }, "offset": { "type": "integer" } }, "required": [ "data", "total", "limit", "offset" ] } } } } }, "operationId": "getAdminOperationsPools", "summary": "GET /v1/admin/operations/pools", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "post": { "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "productId": { "type": [ "string", "null" ] }, "kind": { "type": "string", "enum": [ "guide", "vehicle", "room", "boat", "equipment", "other" ] }, "name": { "type": "string", "minLength": 1 }, "sharedCapacity": { "type": [ "integer", "null" ], "minimum": 0 }, "active": { "type": "boolean", "default": true }, "notes": { "type": [ "string", "null" ] } }, "required": [ "kind", "name" ] } } } }, "responses": { "201": { "description": "The created resource pool", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "productId": { "type": [ "string", "null" ] }, "kind": { "type": "string", "enum": [ "guide", "vehicle", "room", "boat", "equipment", "other" ] }, "name": { "type": "string" }, "sharedCapacity": { "type": [ "integer", "null" ] }, "active": { "type": "boolean" }, "notes": { "type": [ "string", "null" ] }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "productId", "kind", "name", "sharedCapacity", "active", "notes", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "postAdminOperationsPools", "summary": "POST /v1/admin/operations/pools", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/pools/batch-update": { "post": { "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "ids": { "type": "array", "items": { "type": "string" }, "minItems": 1, "maxItems": 200 }, "patch": { "type": "object", "properties": { "productId": { "type": [ "string", "null" ] }, "kind": { "type": "string", "enum": [ "guide", "vehicle", "room", "boat", "equipment", "other" ] }, "name": { "type": "string", "minLength": 1 }, "sharedCapacity": { "type": [ "integer", "null" ], "minimum": 0 }, "active": { "type": "boolean" }, "notes": { "type": [ "string", "null" ] } } } }, "required": [ "ids", "patch" ] } } } }, "responses": { "200": { "description": "Per-id batch-update results (missing ids reported under `failed`)", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "productId": { "type": [ "string", "null" ] }, "kind": { "type": "string", "enum": [ "guide", "vehicle", "room", "boat", "equipment", "other" ] }, "name": { "type": "string" }, "sharedCapacity": { "type": [ "integer", "null" ] }, "active": { "type": "boolean" }, "notes": { "type": [ "string", "null" ] }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "productId", "kind", "name", "sharedCapacity", "active", "notes", "createdAt", "updatedAt" ] } }, "total": { "type": "integer" }, "succeeded": { "type": "integer" }, "failed": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "error": { "type": "string" } }, "required": [ "id", "error" ] } } }, "required": [ "data", "total", "succeeded", "failed" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "postAdminOperationsPoolsBatchUpdate", "summary": "POST /v1/admin/operations/pools/batch-update", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/pools/batch-delete": { "post": { "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "ids": { "type": "array", "items": { "type": "string" }, "minItems": 1, "maxItems": 200 } }, "required": [ "ids" ] } } } }, "responses": { "200": { "description": "Per-id batch-delete results (missing ids reported under `failed`)", "content": { "application/json": { "schema": { "type": "object", "properties": { "deletedIds": { "type": "array", "items": { "type": "string" } }, "total": { "type": "integer" }, "succeeded": { "type": "integer" }, "failed": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "error": { "type": "string" } }, "required": [ "id", "error" ] } } }, "required": [ "deletedIds", "total", "succeeded", "failed" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "postAdminOperationsPoolsBatchDelete", "summary": "POST /v1/admin/operations/pools/batch-delete", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/pools/{id}": { "get": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "A resource pool by id", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "productId": { "type": [ "string", "null" ] }, "kind": { "type": "string", "enum": [ "guide", "vehicle", "room", "boat", "equipment", "other" ] }, "name": { "type": "string" }, "sharedCapacity": { "type": [ "integer", "null" ] }, "active": { "type": "boolean" }, "notes": { "type": [ "string", "null" ] }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "productId", "kind", "name", "sharedCapacity", "active", "notes", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "404": { "description": "Resource pool not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "getAdminOperationsPoolsById", "summary": "GET /v1/admin/operations/pools/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "patch": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "productId": { "type": [ "string", "null" ] }, "kind": { "type": "string", "enum": [ "guide", "vehicle", "room", "boat", "equipment", "other" ] }, "name": { "type": "string", "minLength": 1 }, "sharedCapacity": { "type": [ "integer", "null" ], "minimum": 0 }, "active": { "type": "boolean" }, "notes": { "type": [ "string", "null" ] } } } } } }, "responses": { "200": { "description": "The updated resource pool", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "productId": { "type": [ "string", "null" ] }, "kind": { "type": "string", "enum": [ "guide", "vehicle", "room", "boat", "equipment", "other" ] }, "name": { "type": "string" }, "sharedCapacity": { "type": [ "integer", "null" ] }, "active": { "type": "boolean" }, "notes": { "type": [ "string", "null" ] }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "productId", "kind", "name", "sharedCapacity", "active", "notes", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Resource pool not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "patchAdminOperationsPoolsById", "summary": "PATCH /v1/admin/operations/pools/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "delete": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "Resource pool deleted", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] } }, "required": [ "success" ] } } } }, "404": { "description": "Resource pool not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "deleteAdminOperationsPoolsById", "summary": "DELETE /v1/admin/operations/pools/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/pool-members": { "get": { "parameters": [ { "schema": { "type": "integer", "minimum": 1, "maximum": 200, "default": 50 }, "required": false, "name": "limit", "in": "query" }, { "schema": { "type": [ "integer", "null" ], "minimum": 0, "default": 0 }, "required": false, "name": "offset", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "poolId", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "resourceId", "in": "query" } ], "responses": { "200": { "description": "Paginated resource pool members", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "poolId": { "type": "string" }, "resourceId": { "type": "string" }, "createdAt": { "type": "string" } }, "required": [ "id", "poolId", "resourceId", "createdAt" ] } }, "total": { "type": "integer" }, "limit": { "type": "integer" }, "offset": { "type": "integer" } }, "required": [ "data", "total", "limit", "offset" ] } } } } }, "operationId": "getAdminOperationsPoolMembers", "summary": "GET /v1/admin/operations/pool-members", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "post": { "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "poolId": { "type": "string" }, "resourceId": { "type": "string" } }, "required": [ "poolId", "resourceId" ] } } } }, "responses": { "201": { "description": "The created resource pool member", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "poolId": { "type": "string" }, "resourceId": { "type": "string" }, "createdAt": { "type": "string" } }, "required": [ "id", "poolId", "resourceId", "createdAt" ] } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Referenced resource pool or resource not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } }, "409": { "description": "Resource pool member already exists", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "postAdminOperationsPoolMembers", "summary": "POST /v1/admin/operations/pool-members", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/pool-members/{id}": { "delete": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "Resource pool member deleted", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] } }, "required": [ "success" ] } } } }, "404": { "description": "Resource pool member not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "deleteAdminOperationsPoolMembersById", "summary": "DELETE /v1/admin/operations/pool-members/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/requirements": { "get": { "parameters": [ { "schema": { "type": "integer", "minimum": 1, "maximum": 200, "default": 50 }, "required": false, "name": "limit", "in": "query" }, { "schema": { "type": [ "integer", "null" ], "minimum": 0, "default": 0 }, "required": false, "name": "offset", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "poolId", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "productId", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "availabilityRuleId", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "startTimeId", "in": "query" } ], "responses": { "200": { "description": "Paginated resource requirements", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "poolId": { "type": "string" }, "productId": { "type": "string" }, "availabilityRuleId": { "type": [ "string", "null" ] }, "startTimeId": { "type": [ "string", "null" ] }, "quantityRequired": { "type": "integer" }, "allocationMode": { "type": "string", "enum": [ "shared", "exclusive" ] }, "priority": { "type": "integer" }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "poolId", "productId", "availabilityRuleId", "startTimeId", "quantityRequired", "allocationMode", "priority", "createdAt", "updatedAt" ] } }, "total": { "type": "integer" }, "limit": { "type": "integer" }, "offset": { "type": "integer" } }, "required": [ "data", "total", "limit", "offset" ] } } } } }, "operationId": "getAdminOperationsRequirements", "summary": "GET /v1/admin/operations/requirements", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "post": { "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "poolId": { "type": "string" }, "productId": { "type": "string" }, "availabilityRuleId": { "type": [ "string", "null" ] }, "startTimeId": { "type": [ "string", "null" ] }, "quantityRequired": { "type": "integer", "minimum": 1, "default": 1 }, "allocationMode": { "type": "string", "enum": [ "shared", "exclusive" ], "default": "shared" }, "priority": { "type": "integer", "default": 0 } }, "required": [ "poolId", "productId" ] } } } }, "responses": { "201": { "description": "The created resource requirement", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "poolId": { "type": "string" }, "productId": { "type": "string" }, "availabilityRuleId": { "type": [ "string", "null" ] }, "startTimeId": { "type": [ "string", "null" ] }, "quantityRequired": { "type": "integer" }, "allocationMode": { "type": "string", "enum": [ "shared", "exclusive" ] }, "priority": { "type": "integer" }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "poolId", "productId", "availabilityRuleId", "startTimeId", "quantityRequired", "allocationMode", "priority", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Referenced resource pool not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "postAdminOperationsRequirements", "summary": "POST /v1/admin/operations/requirements", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/requirements/batch-update": { "post": { "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "ids": { "type": "array", "items": { "type": "string" }, "minItems": 1, "maxItems": 200 }, "patch": { "type": "object", "properties": { "poolId": { "type": "string" }, "productId": { "type": "string" }, "availabilityRuleId": { "type": [ "string", "null" ] }, "startTimeId": { "type": [ "string", "null" ] }, "quantityRequired": { "type": "integer", "minimum": 1 }, "allocationMode": { "type": "string", "enum": [ "shared", "exclusive" ] }, "priority": { "type": "integer" } } } }, "required": [ "ids", "patch" ] } } } }, "responses": { "200": { "description": "Per-id batch-update results (missing ids reported under `failed`)", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "poolId": { "type": "string" }, "productId": { "type": "string" }, "availabilityRuleId": { "type": [ "string", "null" ] }, "startTimeId": { "type": [ "string", "null" ] }, "quantityRequired": { "type": "integer" }, "allocationMode": { "type": "string", "enum": [ "shared", "exclusive" ] }, "priority": { "type": "integer" }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "poolId", "productId", "availabilityRuleId", "startTimeId", "quantityRequired", "allocationMode", "priority", "createdAt", "updatedAt" ] } }, "total": { "type": "integer" }, "succeeded": { "type": "integer" }, "failed": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "error": { "type": "string" } }, "required": [ "id", "error" ] } } }, "required": [ "data", "total", "succeeded", "failed" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "postAdminOperationsRequirementsBatchUpdate", "summary": "POST /v1/admin/operations/requirements/batch-update", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/requirements/batch-delete": { "post": { "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "ids": { "type": "array", "items": { "type": "string" }, "minItems": 1, "maxItems": 200 } }, "required": [ "ids" ] } } } }, "responses": { "200": { "description": "Per-id batch-delete results (missing ids reported under `failed`)", "content": { "application/json": { "schema": { "type": "object", "properties": { "deletedIds": { "type": "array", "items": { "type": "string" } }, "total": { "type": "integer" }, "succeeded": { "type": "integer" }, "failed": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "error": { "type": "string" } }, "required": [ "id", "error" ] } } }, "required": [ "deletedIds", "total", "succeeded", "failed" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "postAdminOperationsRequirementsBatchDelete", "summary": "POST /v1/admin/operations/requirements/batch-delete", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/requirements/{id}": { "get": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "A resource requirement by id", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "poolId": { "type": "string" }, "productId": { "type": "string" }, "availabilityRuleId": { "type": [ "string", "null" ] }, "startTimeId": { "type": [ "string", "null" ] }, "quantityRequired": { "type": "integer" }, "allocationMode": { "type": "string", "enum": [ "shared", "exclusive" ] }, "priority": { "type": "integer" }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "poolId", "productId", "availabilityRuleId", "startTimeId", "quantityRequired", "allocationMode", "priority", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "404": { "description": "Resource requirement not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "getAdminOperationsRequirementsById", "summary": "GET /v1/admin/operations/requirements/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "patch": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "poolId": { "type": "string" }, "productId": { "type": "string" }, "availabilityRuleId": { "type": [ "string", "null" ] }, "startTimeId": { "type": [ "string", "null" ] }, "quantityRequired": { "type": "integer", "minimum": 1 }, "allocationMode": { "type": "string", "enum": [ "shared", "exclusive" ] }, "priority": { "type": "integer" } } } } } }, "responses": { "200": { "description": "The updated resource requirement", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "poolId": { "type": "string" }, "productId": { "type": "string" }, "availabilityRuleId": { "type": [ "string", "null" ] }, "startTimeId": { "type": [ "string", "null" ] }, "quantityRequired": { "type": "integer" }, "allocationMode": { "type": "string", "enum": [ "shared", "exclusive" ] }, "priority": { "type": "integer" }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "poolId", "productId", "availabilityRuleId", "startTimeId", "quantityRequired", "allocationMode", "priority", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Resource requirement or referenced resource pool not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "patchAdminOperationsRequirementsById", "summary": "PATCH /v1/admin/operations/requirements/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "delete": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "Resource requirement deleted", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] } }, "required": [ "success" ] } } } }, "404": { "description": "Resource requirement not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "deleteAdminOperationsRequirementsById", "summary": "DELETE /v1/admin/operations/requirements/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/allocations": { "get": { "parameters": [ { "schema": { "type": "integer", "minimum": 1, "maximum": 200, "default": 50 }, "required": false, "name": "limit", "in": "query" }, { "schema": { "type": [ "integer", "null" ], "minimum": 0, "default": 0 }, "required": false, "name": "offset", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "poolId", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "productId", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "availabilityRuleId", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "startTimeId", "in": "query" } ], "responses": { "200": { "description": "Paginated resource allocations", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "poolId": { "type": "string" }, "productId": { "type": "string" }, "availabilityRuleId": { "type": [ "string", "null" ] }, "startTimeId": { "type": [ "string", "null" ] }, "quantityRequired": { "type": "integer" }, "allocationMode": { "type": "string", "enum": [ "shared", "exclusive" ] }, "priority": { "type": "integer" }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "poolId", "productId", "availabilityRuleId", "startTimeId", "quantityRequired", "allocationMode", "priority", "createdAt", "updatedAt" ] } }, "total": { "type": "integer" }, "limit": { "type": "integer" }, "offset": { "type": "integer" } }, "required": [ "data", "total", "limit", "offset" ] } } } } }, "operationId": "getAdminOperationsAllocations", "summary": "GET /v1/admin/operations/allocations", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "post": { "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "poolId": { "type": "string" }, "productId": { "type": "string" }, "availabilityRuleId": { "type": [ "string", "null" ] }, "startTimeId": { "type": [ "string", "null" ] }, "quantityRequired": { "type": "integer", "minimum": 1, "default": 1 }, "allocationMode": { "type": "string", "enum": [ "shared", "exclusive" ], "default": "shared" }, "priority": { "type": "integer", "default": 0 } }, "required": [ "poolId", "productId" ] } } } }, "responses": { "201": { "description": "The created resource allocation", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "poolId": { "type": "string" }, "productId": { "type": "string" }, "availabilityRuleId": { "type": [ "string", "null" ] }, "startTimeId": { "type": [ "string", "null" ] }, "quantityRequired": { "type": "integer" }, "allocationMode": { "type": "string", "enum": [ "shared", "exclusive" ] }, "priority": { "type": "integer" }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "poolId", "productId", "availabilityRuleId", "startTimeId", "quantityRequired", "allocationMode", "priority", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Referenced resource pool not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "postAdminOperationsAllocations", "summary": "POST /v1/admin/operations/allocations", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/allocations/batch-update": { "post": { "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "ids": { "type": "array", "items": { "type": "string" }, "minItems": 1, "maxItems": 200 }, "patch": { "type": "object", "properties": { "poolId": { "type": "string" }, "productId": { "type": "string" }, "availabilityRuleId": { "type": [ "string", "null" ] }, "startTimeId": { "type": [ "string", "null" ] }, "quantityRequired": { "type": "integer", "minimum": 1 }, "allocationMode": { "type": "string", "enum": [ "shared", "exclusive" ] }, "priority": { "type": "integer" } } } }, "required": [ "ids", "patch" ] } } } }, "responses": { "200": { "description": "Per-id batch-update results (missing ids reported under `failed`)", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "poolId": { "type": "string" }, "productId": { "type": "string" }, "availabilityRuleId": { "type": [ "string", "null" ] }, "startTimeId": { "type": [ "string", "null" ] }, "quantityRequired": { "type": "integer" }, "allocationMode": { "type": "string", "enum": [ "shared", "exclusive" ] }, "priority": { "type": "integer" }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "poolId", "productId", "availabilityRuleId", "startTimeId", "quantityRequired", "allocationMode", "priority", "createdAt", "updatedAt" ] } }, "total": { "type": "integer" }, "succeeded": { "type": "integer" }, "failed": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "error": { "type": "string" } }, "required": [ "id", "error" ] } } }, "required": [ "data", "total", "succeeded", "failed" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "postAdminOperationsAllocationsBatchUpdate", "summary": "POST /v1/admin/operations/allocations/batch-update", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/allocations/batch-delete": { "post": { "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "ids": { "type": "array", "items": { "type": "string" }, "minItems": 1, "maxItems": 200 } }, "required": [ "ids" ] } } } }, "responses": { "200": { "description": "Per-id batch-delete results (missing ids reported under `failed`)", "content": { "application/json": { "schema": { "type": "object", "properties": { "deletedIds": { "type": "array", "items": { "type": "string" } }, "total": { "type": "integer" }, "succeeded": { "type": "integer" }, "failed": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "error": { "type": "string" } }, "required": [ "id", "error" ] } } }, "required": [ "deletedIds", "total", "succeeded", "failed" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "postAdminOperationsAllocationsBatchDelete", "summary": "POST /v1/admin/operations/allocations/batch-delete", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/allocations/{id}": { "get": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "A resource allocation by id", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "poolId": { "type": "string" }, "productId": { "type": "string" }, "availabilityRuleId": { "type": [ "string", "null" ] }, "startTimeId": { "type": [ "string", "null" ] }, "quantityRequired": { "type": "integer" }, "allocationMode": { "type": "string", "enum": [ "shared", "exclusive" ] }, "priority": { "type": "integer" }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "poolId", "productId", "availabilityRuleId", "startTimeId", "quantityRequired", "allocationMode", "priority", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "404": { "description": "Resource allocation not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "getAdminOperationsAllocationsById", "summary": "GET /v1/admin/operations/allocations/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "patch": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "poolId": { "type": "string" }, "productId": { "type": "string" }, "availabilityRuleId": { "type": [ "string", "null" ] }, "startTimeId": { "type": [ "string", "null" ] }, "quantityRequired": { "type": "integer", "minimum": 1 }, "allocationMode": { "type": "string", "enum": [ "shared", "exclusive" ] }, "priority": { "type": "integer" } } } } } }, "responses": { "200": { "description": "The updated resource allocation", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "poolId": { "type": "string" }, "productId": { "type": "string" }, "availabilityRuleId": { "type": [ "string", "null" ] }, "startTimeId": { "type": [ "string", "null" ] }, "quantityRequired": { "type": "integer" }, "allocationMode": { "type": "string", "enum": [ "shared", "exclusive" ] }, "priority": { "type": "integer" }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "poolId", "productId", "availabilityRuleId", "startTimeId", "quantityRequired", "allocationMode", "priority", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Resource allocation or referenced resource pool not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "patchAdminOperationsAllocationsById", "summary": "PATCH /v1/admin/operations/allocations/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "delete": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "Resource allocation deleted", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] } }, "required": [ "success" ] } } } }, "404": { "description": "Resource allocation not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "deleteAdminOperationsAllocationsById", "summary": "DELETE /v1/admin/operations/allocations/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/slot-assignments": { "get": { "parameters": [ { "schema": { "type": "integer", "minimum": 1, "maximum": 200, "default": 50 }, "required": false, "name": "limit", "in": "query" }, { "schema": { "type": [ "integer", "null" ], "minimum": 0, "default": 0 }, "required": false, "name": "offset", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "slotId", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "poolId", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "resourceId", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "bookingId", "in": "query" }, { "schema": { "type": "string", "enum": [ "reserved", "assigned", "released", "cancelled", "completed" ] }, "required": false, "name": "status", "in": "query" } ], "responses": { "200": { "description": "Paginated resource slot assignments", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "slotId": { "type": "string" }, "poolId": { "type": [ "string", "null" ] }, "resourceId": { "type": [ "string", "null" ] }, "bookingId": { "type": [ "string", "null" ] }, "status": { "type": "string", "enum": [ "reserved", "assigned", "released", "cancelled", "completed" ] }, "assignedAt": { "type": "string" }, "assignedBy": { "type": [ "string", "null" ] }, "releasedAt": { "type": [ "string", "null" ] }, "notes": { "type": [ "string", "null" ] } }, "required": [ "id", "slotId", "poolId", "resourceId", "bookingId", "status", "assignedAt", "assignedBy", "releasedAt", "notes" ] } }, "total": { "type": "integer" }, "limit": { "type": "integer" }, "offset": { "type": "integer" } }, "required": [ "data", "total", "limit", "offset" ] } } } } }, "operationId": "getAdminOperationsSlotAssignments", "summary": "GET /v1/admin/operations/slot-assignments", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "post": { "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "slotId": { "type": "string" }, "poolId": { "type": [ "string", "null" ] }, "resourceId": { "type": [ "string", "null" ] }, "bookingId": { "type": [ "string", "null" ] }, "status": { "type": "string", "enum": [ "reserved", "assigned", "released", "cancelled", "completed" ], "default": "reserved" }, "assignedAt": { "type": "string", "format": "date-time" }, "assignedBy": { "type": [ "string", "null" ] }, "releasedAt": { "type": [ "string", "null" ], "format": "date-time" }, "notes": { "type": [ "string", "null" ] } }, "required": [ "slotId" ] } } } }, "responses": { "201": { "description": "The created resource slot assignment", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "slotId": { "type": "string" }, "poolId": { "type": [ "string", "null" ] }, "resourceId": { "type": [ "string", "null" ] }, "bookingId": { "type": [ "string", "null" ] }, "status": { "type": "string", "enum": [ "reserved", "assigned", "released", "cancelled", "completed" ] }, "assignedAt": { "type": "string" }, "assignedBy": { "type": [ "string", "null" ] }, "releasedAt": { "type": [ "string", "null" ] }, "notes": { "type": [ "string", "null" ] } }, "required": [ "id", "slotId", "poolId", "resourceId", "bookingId", "status", "assignedAt", "assignedBy", "releasedAt", "notes" ] } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Referenced resource pool or resource not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "postAdminOperationsSlotAssignments", "summary": "POST /v1/admin/operations/slot-assignments", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/slot-assignments/batch-update": { "post": { "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "ids": { "type": "array", "items": { "type": "string" }, "minItems": 1, "maxItems": 200 }, "patch": { "type": "object", "properties": { "slotId": { "type": "string" }, "poolId": { "type": [ "string", "null" ] }, "resourceId": { "type": [ "string", "null" ] }, "bookingId": { "type": [ "string", "null" ] }, "status": { "type": "string", "enum": [ "reserved", "assigned", "released", "cancelled", "completed" ] }, "assignedAt": { "type": "string", "format": "date-time" }, "assignedBy": { "type": [ "string", "null" ] }, "releasedAt": { "type": [ "string", "null" ], "format": "date-time" }, "notes": { "type": [ "string", "null" ] } } } }, "required": [ "ids", "patch" ] } } } }, "responses": { "200": { "description": "Per-id batch-update results (missing ids reported under `failed`)", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "slotId": { "type": "string" }, "poolId": { "type": [ "string", "null" ] }, "resourceId": { "type": [ "string", "null" ] }, "bookingId": { "type": [ "string", "null" ] }, "status": { "type": "string", "enum": [ "reserved", "assigned", "released", "cancelled", "completed" ] }, "assignedAt": { "type": "string" }, "assignedBy": { "type": [ "string", "null" ] }, "releasedAt": { "type": [ "string", "null" ] }, "notes": { "type": [ "string", "null" ] } }, "required": [ "id", "slotId", "poolId", "resourceId", "bookingId", "status", "assignedAt", "assignedBy", "releasedAt", "notes" ] } }, "total": { "type": "integer" }, "succeeded": { "type": "integer" }, "failed": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "error": { "type": "string" } }, "required": [ "id", "error" ] } } }, "required": [ "data", "total", "succeeded", "failed" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "postAdminOperationsSlotAssignmentsBatchUpdate", "summary": "POST /v1/admin/operations/slot-assignments/batch-update", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/slot-assignments/batch-delete": { "post": { "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "ids": { "type": "array", "items": { "type": "string" }, "minItems": 1, "maxItems": 200 } }, "required": [ "ids" ] } } } }, "responses": { "200": { "description": "Per-id batch-delete results (missing ids reported under `failed`)", "content": { "application/json": { "schema": { "type": "object", "properties": { "deletedIds": { "type": "array", "items": { "type": "string" } }, "total": { "type": "integer" }, "succeeded": { "type": "integer" }, "failed": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "error": { "type": "string" } }, "required": [ "id", "error" ] } } }, "required": [ "deletedIds", "total", "succeeded", "failed" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "postAdminOperationsSlotAssignmentsBatchDelete", "summary": "POST /v1/admin/operations/slot-assignments/batch-delete", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/slot-assignments/{id}": { "get": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "A resource slot assignment by id", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "slotId": { "type": "string" }, "poolId": { "type": [ "string", "null" ] }, "resourceId": { "type": [ "string", "null" ] }, "bookingId": { "type": [ "string", "null" ] }, "status": { "type": "string", "enum": [ "reserved", "assigned", "released", "cancelled", "completed" ] }, "assignedAt": { "type": "string" }, "assignedBy": { "type": [ "string", "null" ] }, "releasedAt": { "type": [ "string", "null" ] }, "notes": { "type": [ "string", "null" ] } }, "required": [ "id", "slotId", "poolId", "resourceId", "bookingId", "status", "assignedAt", "assignedBy", "releasedAt", "notes" ] } }, "required": [ "data" ] } } } }, "404": { "description": "Resource slot assignment not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "getAdminOperationsSlotAssignmentsById", "summary": "GET /v1/admin/operations/slot-assignments/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "patch": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "slotId": { "type": "string" }, "poolId": { "type": [ "string", "null" ] }, "resourceId": { "type": [ "string", "null" ] }, "bookingId": { "type": [ "string", "null" ] }, "status": { "type": "string", "enum": [ "reserved", "assigned", "released", "cancelled", "completed" ] }, "assignedAt": { "type": "string", "format": "date-time" }, "assignedBy": { "type": [ "string", "null" ] }, "releasedAt": { "type": [ "string", "null" ], "format": "date-time" }, "notes": { "type": [ "string", "null" ] } } } } } }, "responses": { "200": { "description": "The updated resource slot assignment", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "slotId": { "type": "string" }, "poolId": { "type": [ "string", "null" ] }, "resourceId": { "type": [ "string", "null" ] }, "bookingId": { "type": [ "string", "null" ] }, "status": { "type": "string", "enum": [ "reserved", "assigned", "released", "cancelled", "completed" ] }, "assignedAt": { "type": "string" }, "assignedBy": { "type": [ "string", "null" ] }, "releasedAt": { "type": [ "string", "null" ] }, "notes": { "type": [ "string", "null" ] } }, "required": [ "id", "slotId", "poolId", "resourceId", "bookingId", "status", "assignedAt", "assignedBy", "releasedAt", "notes" ] } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Resource slot assignment or referenced resource pool/resource not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "patchAdminOperationsSlotAssignmentsById", "summary": "PATCH /v1/admin/operations/slot-assignments/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "delete": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "Resource slot assignment deleted", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] } }, "required": [ "success" ] } } } }, "404": { "description": "Resource slot assignment not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "deleteAdminOperationsSlotAssignmentsById", "summary": "DELETE /v1/admin/operations/slot-assignments/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/closeouts": { "get": { "parameters": [ { "schema": { "type": "integer", "minimum": 1, "maximum": 200, "default": 50 }, "required": false, "name": "limit", "in": "query" }, { "schema": { "type": [ "integer", "null" ], "minimum": 0, "default": 0 }, "required": false, "name": "offset", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "resourceId", "in": "query" }, { "schema": { "type": "string", "format": "date" }, "required": false, "name": "dateLocal", "in": "query" } ], "responses": { "200": { "description": "Paginated resource closeouts", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "resourceId": { "type": "string" }, "dateLocal": { "type": "string" }, "startsAt": { "type": [ "string", "null" ] }, "endsAt": { "type": [ "string", "null" ] }, "reason": { "type": [ "string", "null" ] }, "createdBy": { "type": [ "string", "null" ] }, "createdAt": { "type": "string" } }, "required": [ "id", "resourceId", "dateLocal", "startsAt", "endsAt", "reason", "createdBy", "createdAt" ] } }, "total": { "type": "integer" }, "limit": { "type": "integer" }, "offset": { "type": "integer" } }, "required": [ "data", "total", "limit", "offset" ] } } } } }, "operationId": "getAdminOperationsCloseouts", "summary": "GET /v1/admin/operations/closeouts", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "post": { "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "resourceId": { "type": "string" }, "dateLocal": { "type": "string", "format": "date" }, "startsAt": { "type": [ "string", "null" ], "format": "date-time" }, "endsAt": { "type": [ "string", "null" ], "format": "date-time" }, "reason": { "type": [ "string", "null" ] }, "createdBy": { "type": [ "string", "null" ] } }, "required": [ "resourceId", "dateLocal" ] } } } }, "responses": { "201": { "description": "The created resource closeout", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "resourceId": { "type": "string" }, "dateLocal": { "type": "string" }, "startsAt": { "type": [ "string", "null" ] }, "endsAt": { "type": [ "string", "null" ] }, "reason": { "type": [ "string", "null" ] }, "createdBy": { "type": [ "string", "null" ] }, "createdAt": { "type": "string" } }, "required": [ "id", "resourceId", "dateLocal", "startsAt", "endsAt", "reason", "createdBy", "createdAt" ] } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Referenced resource not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } }, "409": { "description": "Resource closeout overlaps an existing closeout", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "postAdminOperationsCloseouts", "summary": "POST /v1/admin/operations/closeouts", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/closeouts/batch-update": { "post": { "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "ids": { "type": "array", "items": { "type": "string" }, "minItems": 1, "maxItems": 200 }, "patch": { "type": "object", "properties": { "resourceId": { "type": "string" }, "dateLocal": { "type": "string", "format": "date" }, "startsAt": { "type": [ "string", "null" ], "format": "date-time" }, "endsAt": { "type": [ "string", "null" ], "format": "date-time" }, "reason": { "type": [ "string", "null" ] }, "createdBy": { "type": [ "string", "null" ] } } } }, "required": [ "ids", "patch" ] } } } }, "responses": { "200": { "description": "Per-id batch-update results (missing ids reported under `failed`)", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "resourceId": { "type": "string" }, "dateLocal": { "type": "string" }, "startsAt": { "type": [ "string", "null" ] }, "endsAt": { "type": [ "string", "null" ] }, "reason": { "type": [ "string", "null" ] }, "createdBy": { "type": [ "string", "null" ] }, "createdAt": { "type": "string" } }, "required": [ "id", "resourceId", "dateLocal", "startsAt", "endsAt", "reason", "createdBy", "createdAt" ] } }, "total": { "type": "integer" }, "succeeded": { "type": "integer" }, "failed": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "error": { "type": "string" } }, "required": [ "id", "error" ] } } }, "required": [ "data", "total", "succeeded", "failed" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "postAdminOperationsCloseoutsBatchUpdate", "summary": "POST /v1/admin/operations/closeouts/batch-update", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/closeouts/batch-delete": { "post": { "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "ids": { "type": "array", "items": { "type": "string" }, "minItems": 1, "maxItems": 200 } }, "required": [ "ids" ] } } } }, "responses": { "200": { "description": "Per-id batch-delete results (missing ids reported under `failed`)", "content": { "application/json": { "schema": { "type": "object", "properties": { "deletedIds": { "type": "array", "items": { "type": "string" } }, "total": { "type": "integer" }, "succeeded": { "type": "integer" }, "failed": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "error": { "type": "string" } }, "required": [ "id", "error" ] } } }, "required": [ "deletedIds", "total", "succeeded", "failed" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "postAdminOperationsCloseoutsBatchDelete", "summary": "POST /v1/admin/operations/closeouts/batch-delete", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/closeouts/{id}": { "get": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "A resource closeout by id", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "resourceId": { "type": "string" }, "dateLocal": { "type": "string" }, "startsAt": { "type": [ "string", "null" ] }, "endsAt": { "type": [ "string", "null" ] }, "reason": { "type": [ "string", "null" ] }, "createdBy": { "type": [ "string", "null" ] }, "createdAt": { "type": "string" } }, "required": [ "id", "resourceId", "dateLocal", "startsAt", "endsAt", "reason", "createdBy", "createdAt" ] } }, "required": [ "data" ] } } } }, "404": { "description": "Resource closeout not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "getAdminOperationsCloseoutsById", "summary": "GET /v1/admin/operations/closeouts/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "patch": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "resourceId": { "type": "string" }, "dateLocal": { "type": "string", "format": "date" }, "startsAt": { "type": [ "string", "null" ], "format": "date-time" }, "endsAt": { "type": [ "string", "null" ], "format": "date-time" }, "reason": { "type": [ "string", "null" ] }, "createdBy": { "type": [ "string", "null" ] } } } } } }, "responses": { "200": { "description": "The updated resource closeout", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "resourceId": { "type": "string" }, "dateLocal": { "type": "string" }, "startsAt": { "type": [ "string", "null" ] }, "endsAt": { "type": [ "string", "null" ] }, "reason": { "type": [ "string", "null" ] }, "createdBy": { "type": [ "string", "null" ] }, "createdAt": { "type": "string" } }, "required": [ "id", "resourceId", "dateLocal", "startsAt", "endsAt", "reason", "createdBy", "createdAt" ] } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Resource closeout or referenced resource not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } }, "409": { "description": "Resource closeout overlaps an existing closeout", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "patchAdminOperationsCloseoutsById", "summary": "PATCH /v1/admin/operations/closeouts/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "delete": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "Resource closeout deleted", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] } }, "required": [ "success" ] } } } }, "404": { "description": "Resource closeout not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "deleteAdminOperationsCloseoutsById", "summary": "DELETE /v1/admin/operations/closeouts/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/operators": { "get": { "parameters": [ { "schema": { "type": "integer", "minimum": 1, "maximum": 200, "default": 50 }, "required": false, "name": "limit", "in": "query" }, { "schema": { "type": [ "integer", "null" ], "minimum": 0, "default": 0 }, "required": false, "name": "offset", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "supplierId", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "facilityId", "in": "query" }, { "schema": { "type": "string", "enum": [ "0", "1", "true", "false" ] }, "required": false, "name": "active", "in": "query" } ], "responses": { "200": { "description": "Paginated ground operators", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "supplierId": { "type": [ "string", "null" ] }, "facilityId": { "type": [ "string", "null" ] }, "name": { "type": "string" }, "code": { "type": [ "string", "null" ] }, "active": { "type": "boolean" }, "notes": { "type": [ "string", "null" ] }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "supplierId", "facilityId", "name", "code", "active", "notes", "createdAt", "updatedAt" ] } }, "total": { "type": "integer" }, "limit": { "type": "integer" }, "offset": { "type": "integer" } }, "required": [ "data", "total", "limit", "offset" ] } } } } }, "operationId": "getAdminOperationsOperators", "summary": "GET /v1/admin/operations/operators", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "post": { "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "supplierId": { "type": [ "string", "null" ] }, "facilityId": { "type": [ "string", "null" ] }, "name": { "type": "string", "minLength": 1, "maxLength": 255 }, "code": { "type": [ "string", "null" ], "maxLength": 100 }, "active": { "type": "boolean", "default": true }, "notes": { "type": [ "string", "null" ] } }, "required": [ "name" ] } } } }, "responses": { "201": { "description": "The created ground operator", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "supplierId": { "type": [ "string", "null" ] }, "facilityId": { "type": [ "string", "null" ] }, "name": { "type": "string" }, "code": { "type": [ "string", "null" ] }, "active": { "type": "boolean" }, "notes": { "type": [ "string", "null" ] }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "supplierId", "facilityId", "name", "code", "active", "notes", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "postAdminOperationsOperators", "summary": "POST /v1/admin/operations/operators", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/operators/{id}": { "get": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "A ground operator by id", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "supplierId": { "type": [ "string", "null" ] }, "facilityId": { "type": [ "string", "null" ] }, "name": { "type": "string" }, "code": { "type": [ "string", "null" ] }, "active": { "type": "boolean" }, "notes": { "type": [ "string", "null" ] }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "supplierId", "facilityId", "name", "code", "active", "notes", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "404": { "description": "Ground operator not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "getAdminOperationsOperatorsById", "summary": "GET /v1/admin/operations/operators/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "patch": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "supplierId": { "type": [ "string", "null" ] }, "facilityId": { "type": [ "string", "null" ] }, "name": { "type": "string", "minLength": 1, "maxLength": 255 }, "code": { "type": [ "string", "null" ], "maxLength": 100 }, "active": { "type": "boolean", "default": true }, "notes": { "type": [ "string", "null" ] } } } } } }, "responses": { "200": { "description": "The updated ground operator", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "supplierId": { "type": [ "string", "null" ] }, "facilityId": { "type": [ "string", "null" ] }, "name": { "type": "string" }, "code": { "type": [ "string", "null" ] }, "active": { "type": "boolean" }, "notes": { "type": [ "string", "null" ] }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "supplierId", "facilityId", "name", "code", "active", "notes", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Ground operator not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "patchAdminOperationsOperatorsById", "summary": "PATCH /v1/admin/operations/operators/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "delete": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "Ground operator deleted", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] } }, "required": [ "success" ] } } } }, "404": { "description": "Ground operator not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "deleteAdminOperationsOperatorsById", "summary": "DELETE /v1/admin/operations/operators/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/vehicles": { "get": { "parameters": [ { "schema": { "type": "integer", "minimum": 1, "maximum": 200, "default": 50 }, "required": false, "name": "limit", "in": "query" }, { "schema": { "type": [ "integer", "null" ], "minimum": 0, "default": 0 }, "required": false, "name": "offset", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "resourceId", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "operatorId", "in": "query" }, { "schema": { "type": "string", "enum": [ "car", "sedan", "suv", "van", "minibus", "bus", "boat", "train", "other" ] }, "required": false, "name": "category", "in": "query" }, { "schema": { "type": "string", "enum": [ "0", "1", "true", "false" ] }, "required": false, "name": "active", "in": "query" } ], "responses": { "200": { "description": "Paginated ground vehicles", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "resourceId": { "type": "string" }, "operatorId": { "type": [ "string", "null" ] }, "category": { "type": "string", "enum": [ "car", "sedan", "suv", "van", "minibus", "bus", "boat", "train", "other" ] }, "vehicleClass": { "type": "string", "enum": [ "economy", "standard", "premium", "luxury", "accessible", "other" ] }, "passengerCapacity": { "type": [ "integer", "null" ] }, "checkedBagCapacity": { "type": [ "integer", "null" ] }, "carryOnCapacity": { "type": [ "integer", "null" ] }, "wheelchairCapacity": { "type": [ "integer", "null" ] }, "childSeatCapacity": { "type": [ "integer", "null" ] }, "isAccessible": { "type": "boolean" }, "active": { "type": "boolean" }, "notes": { "type": [ "string", "null" ] }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "resourceId", "operatorId", "category", "vehicleClass", "passengerCapacity", "checkedBagCapacity", "carryOnCapacity", "wheelchairCapacity", "childSeatCapacity", "isAccessible", "active", "notes", "createdAt", "updatedAt" ] } }, "total": { "type": "integer" }, "limit": { "type": "integer" }, "offset": { "type": "integer" } }, "required": [ "data", "total", "limit", "offset" ] } } } } }, "operationId": "getAdminOperationsVehicles", "summary": "GET /v1/admin/operations/vehicles", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "post": { "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "resourceId": { "type": "string" }, "operatorId": { "type": [ "string", "null" ] }, "category": { "type": "string", "enum": [ "car", "sedan", "suv", "van", "minibus", "bus", "boat", "train", "other" ], "default": "other" }, "vehicleClass": { "type": "string", "enum": [ "economy", "standard", "premium", "luxury", "accessible", "other" ], "default": "standard" }, "passengerCapacity": { "type": [ "integer", "null" ], "minimum": 0 }, "checkedBagCapacity": { "type": [ "integer", "null" ], "minimum": 0 }, "carryOnCapacity": { "type": [ "integer", "null" ], "minimum": 0 }, "wheelchairCapacity": { "type": [ "integer", "null" ], "minimum": 0 }, "childSeatCapacity": { "type": [ "integer", "null" ], "minimum": 0 }, "isAccessible": { "type": "boolean", "default": false }, "active": { "type": "boolean", "default": true }, "notes": { "type": [ "string", "null" ] } }, "required": [ "resourceId" ] } } } }, "responses": { "201": { "description": "The created ground vehicle", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "resourceId": { "type": "string" }, "operatorId": { "type": [ "string", "null" ] }, "category": { "type": "string", "enum": [ "car", "sedan", "suv", "van", "minibus", "bus", "boat", "train", "other" ] }, "vehicleClass": { "type": "string", "enum": [ "economy", "standard", "premium", "luxury", "accessible", "other" ] }, "passengerCapacity": { "type": [ "integer", "null" ] }, "checkedBagCapacity": { "type": [ "integer", "null" ] }, "carryOnCapacity": { "type": [ "integer", "null" ] }, "wheelchairCapacity": { "type": [ "integer", "null" ] }, "childSeatCapacity": { "type": [ "integer", "null" ] }, "isAccessible": { "type": "boolean" }, "active": { "type": "boolean" }, "notes": { "type": [ "string", "null" ] }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "resourceId", "operatorId", "category", "vehicleClass", "passengerCapacity", "checkedBagCapacity", "carryOnCapacity", "wheelchairCapacity", "childSeatCapacity", "isAccessible", "active", "notes", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "postAdminOperationsVehicles", "summary": "POST /v1/admin/operations/vehicles", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/vehicles/{id}": { "get": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "A ground vehicle by id", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "resourceId": { "type": "string" }, "operatorId": { "type": [ "string", "null" ] }, "category": { "type": "string", "enum": [ "car", "sedan", "suv", "van", "minibus", "bus", "boat", "train", "other" ] }, "vehicleClass": { "type": "string", "enum": [ "economy", "standard", "premium", "luxury", "accessible", "other" ] }, "passengerCapacity": { "type": [ "integer", "null" ] }, "checkedBagCapacity": { "type": [ "integer", "null" ] }, "carryOnCapacity": { "type": [ "integer", "null" ] }, "wheelchairCapacity": { "type": [ "integer", "null" ] }, "childSeatCapacity": { "type": [ "integer", "null" ] }, "isAccessible": { "type": "boolean" }, "active": { "type": "boolean" }, "notes": { "type": [ "string", "null" ] }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "resourceId", "operatorId", "category", "vehicleClass", "passengerCapacity", "checkedBagCapacity", "carryOnCapacity", "wheelchairCapacity", "childSeatCapacity", "isAccessible", "active", "notes", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "404": { "description": "Ground vehicle not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "getAdminOperationsVehiclesById", "summary": "GET /v1/admin/operations/vehicles/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "patch": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "resourceId": { "type": "string" }, "operatorId": { "type": [ "string", "null" ] }, "category": { "type": "string", "enum": [ "car", "sedan", "suv", "van", "minibus", "bus", "boat", "train", "other" ], "default": "other" }, "vehicleClass": { "type": "string", "enum": [ "economy", "standard", "premium", "luxury", "accessible", "other" ], "default": "standard" }, "passengerCapacity": { "type": [ "integer", "null" ], "minimum": 0 }, "checkedBagCapacity": { "type": [ "integer", "null" ], "minimum": 0 }, "carryOnCapacity": { "type": [ "integer", "null" ], "minimum": 0 }, "wheelchairCapacity": { "type": [ "integer", "null" ], "minimum": 0 }, "childSeatCapacity": { "type": [ "integer", "null" ], "minimum": 0 }, "isAccessible": { "type": "boolean", "default": false }, "active": { "type": "boolean", "default": true }, "notes": { "type": [ "string", "null" ] } } } } } }, "responses": { "200": { "description": "The updated ground vehicle", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "resourceId": { "type": "string" }, "operatorId": { "type": [ "string", "null" ] }, "category": { "type": "string", "enum": [ "car", "sedan", "suv", "van", "minibus", "bus", "boat", "train", "other" ] }, "vehicleClass": { "type": "string", "enum": [ "economy", "standard", "premium", "luxury", "accessible", "other" ] }, "passengerCapacity": { "type": [ "integer", "null" ] }, "checkedBagCapacity": { "type": [ "integer", "null" ] }, "carryOnCapacity": { "type": [ "integer", "null" ] }, "wheelchairCapacity": { "type": [ "integer", "null" ] }, "childSeatCapacity": { "type": [ "integer", "null" ] }, "isAccessible": { "type": "boolean" }, "active": { "type": "boolean" }, "notes": { "type": [ "string", "null" ] }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "resourceId", "operatorId", "category", "vehicleClass", "passengerCapacity", "checkedBagCapacity", "carryOnCapacity", "wheelchairCapacity", "childSeatCapacity", "isAccessible", "active", "notes", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Ground vehicle not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "patchAdminOperationsVehiclesById", "summary": "PATCH /v1/admin/operations/vehicles/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "delete": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "Ground vehicle deleted", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] } }, "required": [ "success" ] } } } }, "404": { "description": "Ground vehicle not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "deleteAdminOperationsVehiclesById", "summary": "DELETE /v1/admin/operations/vehicles/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/drivers": { "get": { "parameters": [ { "schema": { "type": "integer", "minimum": 1, "maximum": 200, "default": 50 }, "required": false, "name": "limit", "in": "query" }, { "schema": { "type": [ "integer", "null" ], "minimum": 0, "default": 0 }, "required": false, "name": "offset", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "resourceId", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "operatorId", "in": "query" }, { "schema": { "type": "string", "enum": [ "0", "1", "true", "false" ] }, "required": false, "name": "active", "in": "query" } ], "responses": { "200": { "description": "Paginated ground drivers", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "resourceId": { "type": "string" }, "operatorId": { "type": [ "string", "null" ] }, "licenseNumber": { "type": [ "string", "null" ] }, "spokenLanguages": { "type": "array", "items": { "type": "string" } }, "isGuide": { "type": "boolean" }, "isMeetAndGreetCapable": { "type": "boolean" }, "active": { "type": "boolean" }, "notes": { "type": [ "string", "null" ] }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "resourceId", "operatorId", "licenseNumber", "spokenLanguages", "isGuide", "isMeetAndGreetCapable", "active", "notes", "createdAt", "updatedAt" ] } }, "total": { "type": "integer" }, "limit": { "type": "integer" }, "offset": { "type": "integer" } }, "required": [ "data", "total", "limit", "offset" ] } } } } }, "operationId": "getAdminOperationsDrivers", "summary": "GET /v1/admin/operations/drivers", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "post": { "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "resourceId": { "type": "string" }, "operatorId": { "type": [ "string", "null" ] }, "licenseNumber": { "type": [ "string", "null" ], "maxLength": 100 }, "spokenLanguages": { "type": "array", "items": { "type": "string", "minLength": 2, "maxLength": 35 }, "default": [] }, "isGuide": { "type": "boolean", "default": false }, "isMeetAndGreetCapable": { "type": "boolean", "default": false }, "active": { "type": "boolean", "default": true }, "notes": { "type": [ "string", "null" ] } }, "required": [ "resourceId" ] } } } }, "responses": { "201": { "description": "The created ground driver", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "resourceId": { "type": "string" }, "operatorId": { "type": [ "string", "null" ] }, "licenseNumber": { "type": [ "string", "null" ] }, "spokenLanguages": { "type": "array", "items": { "type": "string" } }, "isGuide": { "type": "boolean" }, "isMeetAndGreetCapable": { "type": "boolean" }, "active": { "type": "boolean" }, "notes": { "type": [ "string", "null" ] }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "resourceId", "operatorId", "licenseNumber", "spokenLanguages", "isGuide", "isMeetAndGreetCapable", "active", "notes", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "postAdminOperationsDrivers", "summary": "POST /v1/admin/operations/drivers", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/drivers/{id}": { "get": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "A ground driver by id", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "resourceId": { "type": "string" }, "operatorId": { "type": [ "string", "null" ] }, "licenseNumber": { "type": [ "string", "null" ] }, "spokenLanguages": { "type": "array", "items": { "type": "string" } }, "isGuide": { "type": "boolean" }, "isMeetAndGreetCapable": { "type": "boolean" }, "active": { "type": "boolean" }, "notes": { "type": [ "string", "null" ] }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "resourceId", "operatorId", "licenseNumber", "spokenLanguages", "isGuide", "isMeetAndGreetCapable", "active", "notes", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "404": { "description": "Ground driver not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "getAdminOperationsDriversById", "summary": "GET /v1/admin/operations/drivers/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "patch": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "resourceId": { "type": "string" }, "operatorId": { "type": [ "string", "null" ] }, "licenseNumber": { "type": [ "string", "null" ], "maxLength": 100 }, "spokenLanguages": { "type": "array", "items": { "type": "string", "minLength": 2, "maxLength": 35 }, "default": [] }, "isGuide": { "type": "boolean", "default": false }, "isMeetAndGreetCapable": { "type": "boolean", "default": false }, "active": { "type": "boolean", "default": true }, "notes": { "type": [ "string", "null" ] } } } } } }, "responses": { "200": { "description": "The updated ground driver", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "resourceId": { "type": "string" }, "operatorId": { "type": [ "string", "null" ] }, "licenseNumber": { "type": [ "string", "null" ] }, "spokenLanguages": { "type": "array", "items": { "type": "string" } }, "isGuide": { "type": "boolean" }, "isMeetAndGreetCapable": { "type": "boolean" }, "active": { "type": "boolean" }, "notes": { "type": [ "string", "null" ] }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "resourceId", "operatorId", "licenseNumber", "spokenLanguages", "isGuide", "isMeetAndGreetCapable", "active", "notes", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Ground driver not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "patchAdminOperationsDriversById", "summary": "PATCH /v1/admin/operations/drivers/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "delete": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "Ground driver deleted", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] } }, "required": [ "success" ] } } } }, "404": { "description": "Ground driver not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "deleteAdminOperationsDriversById", "summary": "DELETE /v1/admin/operations/drivers/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/transfer-preferences": { "get": { "parameters": [ { "schema": { "type": "integer", "minimum": 1, "maximum": 200, "default": 50 }, "required": false, "name": "limit", "in": "query" }, { "schema": { "type": [ "integer", "null" ], "minimum": 0, "default": 0 }, "required": false, "name": "offset", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "bookingId", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "bookingItemId", "in": "query" }, { "schema": { "type": "string", "enum": [ "private", "shared", "vip", "shuttle", "other" ] }, "required": false, "name": "serviceLevel", "in": "query" } ], "responses": { "200": { "description": "Paginated ground transfer preferences", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "bookingId": { "type": "string" }, "bookingItemId": { "type": [ "string", "null" ] }, "pickupFacilityId": { "type": [ "string", "null" ] }, "dropoffFacilityId": { "type": [ "string", "null" ] }, "pickupAddressId": { "type": [ "string", "null" ] }, "dropoffAddressId": { "type": [ "string", "null" ] }, "requestedVehicleCategory": { "type": [ "string", "null" ], "enum": [ "car", "sedan", "suv", "van", "minibus", "bus", "boat", "train", "other", null ] }, "requestedVehicleClass": { "type": [ "string", "null" ], "enum": [ "economy", "standard", "premium", "luxury", "accessible", "other", null ] }, "serviceLevel": { "type": "string", "enum": [ "private", "shared", "vip", "shuttle", "other" ] }, "passengerCount": { "type": [ "integer", "null" ] }, "checkedBags": { "type": [ "integer", "null" ] }, "carryOnBags": { "type": [ "integer", "null" ] }, "wheelchairCount": { "type": [ "integer", "null" ] }, "childSeatCount": { "type": [ "integer", "null" ] }, "driverLanguage": { "type": [ "string", "null" ] }, "meetAndGreet": { "type": "boolean" }, "accessibilityNotes": { "type": [ "string", "null" ] }, "pickupNotes": { "type": [ "string", "null" ] }, "dropoffNotes": { "type": [ "string", "null" ] }, "notes": { "type": [ "string", "null" ] }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "bookingId", "bookingItemId", "pickupFacilityId", "dropoffFacilityId", "pickupAddressId", "dropoffAddressId", "requestedVehicleCategory", "requestedVehicleClass", "serviceLevel", "passengerCount", "checkedBags", "carryOnBags", "wheelchairCount", "childSeatCount", "driverLanguage", "meetAndGreet", "accessibilityNotes", "pickupNotes", "dropoffNotes", "notes", "createdAt", "updatedAt" ] } }, "total": { "type": "integer" }, "limit": { "type": "integer" }, "offset": { "type": "integer" } }, "required": [ "data", "total", "limit", "offset" ] } } } } }, "operationId": "getAdminOperationsTransferPreferences", "summary": "GET /v1/admin/operations/transfer-preferences", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "post": { "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "bookingId": { "type": "string" }, "bookingItemId": { "type": [ "string", "null" ] }, "pickupFacilityId": { "type": [ "string", "null" ] }, "dropoffFacilityId": { "type": [ "string", "null" ] }, "pickupAddressId": { "type": [ "string", "null" ] }, "dropoffAddressId": { "type": [ "string", "null" ] }, "requestedVehicleCategory": { "type": [ "string", "null" ], "enum": [ "car", "sedan", "suv", "van", "minibus", "bus", "boat", "train", "other", null ] }, "requestedVehicleClass": { "type": [ "string", "null" ], "enum": [ "economy", "standard", "premium", "luxury", "accessible", "other", null ] }, "serviceLevel": { "type": "string", "enum": [ "private", "shared", "vip", "shuttle", "other" ], "default": "private" }, "passengerCount": { "type": [ "integer", "null" ], "minimum": 0 }, "checkedBags": { "type": [ "integer", "null" ], "minimum": 0 }, "carryOnBags": { "type": [ "integer", "null" ], "minimum": 0 }, "wheelchairCount": { "type": [ "integer", "null" ], "minimum": 0 }, "childSeatCount": { "type": [ "integer", "null" ], "minimum": 0 }, "driverLanguage": { "type": [ "string", "null" ], "maxLength": 35 }, "meetAndGreet": { "type": "boolean", "default": false }, "accessibilityNotes": { "type": [ "string", "null" ] }, "pickupNotes": { "type": [ "string", "null" ] }, "dropoffNotes": { "type": [ "string", "null" ] }, "notes": { "type": [ "string", "null" ] } }, "required": [ "bookingId" ] } } } }, "responses": { "201": { "description": "The created ground transfer preference", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "bookingId": { "type": "string" }, "bookingItemId": { "type": [ "string", "null" ] }, "pickupFacilityId": { "type": [ "string", "null" ] }, "dropoffFacilityId": { "type": [ "string", "null" ] }, "pickupAddressId": { "type": [ "string", "null" ] }, "dropoffAddressId": { "type": [ "string", "null" ] }, "requestedVehicleCategory": { "type": [ "string", "null" ], "enum": [ "car", "sedan", "suv", "van", "minibus", "bus", "boat", "train", "other", null ] }, "requestedVehicleClass": { "type": [ "string", "null" ], "enum": [ "economy", "standard", "premium", "luxury", "accessible", "other", null ] }, "serviceLevel": { "type": "string", "enum": [ "private", "shared", "vip", "shuttle", "other" ] }, "passengerCount": { "type": [ "integer", "null" ] }, "checkedBags": { "type": [ "integer", "null" ] }, "carryOnBags": { "type": [ "integer", "null" ] }, "wheelchairCount": { "type": [ "integer", "null" ] }, "childSeatCount": { "type": [ "integer", "null" ] }, "driverLanguage": { "type": [ "string", "null" ] }, "meetAndGreet": { "type": "boolean" }, "accessibilityNotes": { "type": [ "string", "null" ] }, "pickupNotes": { "type": [ "string", "null" ] }, "dropoffNotes": { "type": [ "string", "null" ] }, "notes": { "type": [ "string", "null" ] }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "bookingId", "bookingItemId", "pickupFacilityId", "dropoffFacilityId", "pickupAddressId", "dropoffAddressId", "requestedVehicleCategory", "requestedVehicleClass", "serviceLevel", "passengerCount", "checkedBags", "carryOnBags", "wheelchairCount", "childSeatCount", "driverLanguage", "meetAndGreet", "accessibilityNotes", "pickupNotes", "dropoffNotes", "notes", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "postAdminOperationsTransferPreferences", "summary": "POST /v1/admin/operations/transfer-preferences", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/transfer-preferences/{id}": { "get": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "A ground transfer preference by id", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "bookingId": { "type": "string" }, "bookingItemId": { "type": [ "string", "null" ] }, "pickupFacilityId": { "type": [ "string", "null" ] }, "dropoffFacilityId": { "type": [ "string", "null" ] }, "pickupAddressId": { "type": [ "string", "null" ] }, "dropoffAddressId": { "type": [ "string", "null" ] }, "requestedVehicleCategory": { "type": [ "string", "null" ], "enum": [ "car", "sedan", "suv", "van", "minibus", "bus", "boat", "train", "other", null ] }, "requestedVehicleClass": { "type": [ "string", "null" ], "enum": [ "economy", "standard", "premium", "luxury", "accessible", "other", null ] }, "serviceLevel": { "type": "string", "enum": [ "private", "shared", "vip", "shuttle", "other" ] }, "passengerCount": { "type": [ "integer", "null" ] }, "checkedBags": { "type": [ "integer", "null" ] }, "carryOnBags": { "type": [ "integer", "null" ] }, "wheelchairCount": { "type": [ "integer", "null" ] }, "childSeatCount": { "type": [ "integer", "null" ] }, "driverLanguage": { "type": [ "string", "null" ] }, "meetAndGreet": { "type": "boolean" }, "accessibilityNotes": { "type": [ "string", "null" ] }, "pickupNotes": { "type": [ "string", "null" ] }, "dropoffNotes": { "type": [ "string", "null" ] }, "notes": { "type": [ "string", "null" ] }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "bookingId", "bookingItemId", "pickupFacilityId", "dropoffFacilityId", "pickupAddressId", "dropoffAddressId", "requestedVehicleCategory", "requestedVehicleClass", "serviceLevel", "passengerCount", "checkedBags", "carryOnBags", "wheelchairCount", "childSeatCount", "driverLanguage", "meetAndGreet", "accessibilityNotes", "pickupNotes", "dropoffNotes", "notes", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "404": { "description": "Ground transfer preference not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "getAdminOperationsTransferPreferencesById", "summary": "GET /v1/admin/operations/transfer-preferences/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "patch": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "bookingId": { "type": "string" }, "bookingItemId": { "type": [ "string", "null" ] }, "pickupFacilityId": { "type": [ "string", "null" ] }, "dropoffFacilityId": { "type": [ "string", "null" ] }, "pickupAddressId": { "type": [ "string", "null" ] }, "dropoffAddressId": { "type": [ "string", "null" ] }, "requestedVehicleCategory": { "type": [ "string", "null" ], "enum": [ "car", "sedan", "suv", "van", "minibus", "bus", "boat", "train", "other", null ] }, "requestedVehicleClass": { "type": [ "string", "null" ], "enum": [ "economy", "standard", "premium", "luxury", "accessible", "other", null ] }, "serviceLevel": { "type": "string", "enum": [ "private", "shared", "vip", "shuttle", "other" ], "default": "private" }, "passengerCount": { "type": [ "integer", "null" ], "minimum": 0 }, "checkedBags": { "type": [ "integer", "null" ], "minimum": 0 }, "carryOnBags": { "type": [ "integer", "null" ], "minimum": 0 }, "wheelchairCount": { "type": [ "integer", "null" ], "minimum": 0 }, "childSeatCount": { "type": [ "integer", "null" ], "minimum": 0 }, "driverLanguage": { "type": [ "string", "null" ], "maxLength": 35 }, "meetAndGreet": { "type": "boolean", "default": false }, "accessibilityNotes": { "type": [ "string", "null" ] }, "pickupNotes": { "type": [ "string", "null" ] }, "dropoffNotes": { "type": [ "string", "null" ] }, "notes": { "type": [ "string", "null" ] } } } } } }, "responses": { "200": { "description": "The updated ground transfer preference", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "bookingId": { "type": "string" }, "bookingItemId": { "type": [ "string", "null" ] }, "pickupFacilityId": { "type": [ "string", "null" ] }, "dropoffFacilityId": { "type": [ "string", "null" ] }, "pickupAddressId": { "type": [ "string", "null" ] }, "dropoffAddressId": { "type": [ "string", "null" ] }, "requestedVehicleCategory": { "type": [ "string", "null" ], "enum": [ "car", "sedan", "suv", "van", "minibus", "bus", "boat", "train", "other", null ] }, "requestedVehicleClass": { "type": [ "string", "null" ], "enum": [ "economy", "standard", "premium", "luxury", "accessible", "other", null ] }, "serviceLevel": { "type": "string", "enum": [ "private", "shared", "vip", "shuttle", "other" ] }, "passengerCount": { "type": [ "integer", "null" ] }, "checkedBags": { "type": [ "integer", "null" ] }, "carryOnBags": { "type": [ "integer", "null" ] }, "wheelchairCount": { "type": [ "integer", "null" ] }, "childSeatCount": { "type": [ "integer", "null" ] }, "driverLanguage": { "type": [ "string", "null" ] }, "meetAndGreet": { "type": "boolean" }, "accessibilityNotes": { "type": [ "string", "null" ] }, "pickupNotes": { "type": [ "string", "null" ] }, "dropoffNotes": { "type": [ "string", "null" ] }, "notes": { "type": [ "string", "null" ] }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "bookingId", "bookingItemId", "pickupFacilityId", "dropoffFacilityId", "pickupAddressId", "dropoffAddressId", "requestedVehicleCategory", "requestedVehicleClass", "serviceLevel", "passengerCount", "checkedBags", "carryOnBags", "wheelchairCount", "childSeatCount", "driverLanguage", "meetAndGreet", "accessibilityNotes", "pickupNotes", "dropoffNotes", "notes", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Ground transfer preference not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "patchAdminOperationsTransferPreferencesById", "summary": "PATCH /v1/admin/operations/transfer-preferences/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "delete": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "Ground transfer preference deleted", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] } }, "required": [ "success" ] } } } }, "404": { "description": "Ground transfer preference not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "deleteAdminOperationsTransferPreferencesById", "summary": "DELETE /v1/admin/operations/transfer-preferences/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/dispatches": { "get": { "parameters": [ { "schema": { "type": "integer", "minimum": 1, "maximum": 200, "default": 50 }, "required": false, "name": "limit", "in": "query" }, { "schema": { "type": [ "integer", "null" ], "minimum": 0, "default": 0 }, "required": false, "name": "offset", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "transferPreferenceId", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "bookingId", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "bookingItemId", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "operatorId", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "vehicleId", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "driverId", "in": "query" }, { "schema": { "type": "string", "enum": [ "draft", "scheduled", "assigned", "en_route", "arrived", "picked_up", "completed", "cancelled", "no_show" ] }, "required": false, "name": "status", "in": "query" }, { "schema": { "type": "string", "format": "date" }, "required": false, "name": "serviceDate", "in": "query" } ], "responses": { "200": { "description": "Paginated ground dispatches", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "transferPreferenceId": { "type": "string" }, "bookingId": { "type": "string" }, "bookingItemId": { "type": [ "string", "null" ] }, "operatorId": { "type": [ "string", "null" ] }, "vehicleId": { "type": [ "string", "null" ] }, "driverId": { "type": [ "string", "null" ] }, "serviceDate": { "type": [ "string", "null" ] }, "scheduledPickupAt": { "type": [ "string", "null" ] }, "scheduledDropoffAt": { "type": [ "string", "null" ] }, "actualPickupAt": { "type": [ "string", "null" ] }, "actualDropoffAt": { "type": [ "string", "null" ] }, "status": { "type": "string", "enum": [ "draft", "scheduled", "assigned", "en_route", "arrived", "picked_up", "completed", "cancelled", "no_show" ] }, "passengerCount": { "type": [ "integer", "null" ] }, "checkedBags": { "type": [ "integer", "null" ] }, "carryOnBags": { "type": [ "integer", "null" ] }, "notes": { "type": [ "string", "null" ] }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "transferPreferenceId", "bookingId", "bookingItemId", "operatorId", "vehicleId", "driverId", "serviceDate", "scheduledPickupAt", "scheduledDropoffAt", "actualPickupAt", "actualDropoffAt", "status", "passengerCount", "checkedBags", "carryOnBags", "notes", "createdAt", "updatedAt" ] } }, "total": { "type": "integer" }, "limit": { "type": "integer" }, "offset": { "type": "integer" } }, "required": [ "data", "total", "limit", "offset" ] } } } } }, "operationId": "getAdminOperationsDispatches", "summary": "GET /v1/admin/operations/dispatches", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "post": { "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "transferPreferenceId": { "type": "string" }, "bookingId": { "type": "string" }, "bookingItemId": { "type": [ "string", "null" ] }, "operatorId": { "type": [ "string", "null" ] }, "vehicleId": { "type": [ "string", "null" ] }, "driverId": { "type": [ "string", "null" ] }, "serviceDate": { "type": [ "string", "null" ], "format": "date" }, "scheduledPickupAt": { "type": [ "string", "null" ], "format": "date-time" }, "scheduledDropoffAt": { "type": [ "string", "null" ], "format": "date-time" }, "actualPickupAt": { "type": [ "string", "null" ], "format": "date-time" }, "actualDropoffAt": { "type": [ "string", "null" ], "format": "date-time" }, "status": { "type": "string", "enum": [ "draft", "scheduled", "assigned", "en_route", "arrived", "picked_up", "completed", "cancelled", "no_show" ], "default": "draft" }, "passengerCount": { "type": [ "integer", "null" ], "minimum": 0 }, "checkedBags": { "type": [ "integer", "null" ], "minimum": 0 }, "carryOnBags": { "type": [ "integer", "null" ], "minimum": 0 }, "notes": { "type": [ "string", "null" ] } }, "required": [ "transferPreferenceId", "bookingId" ] } } } }, "responses": { "201": { "description": "The created ground dispatch", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "transferPreferenceId": { "type": "string" }, "bookingId": { "type": "string" }, "bookingItemId": { "type": [ "string", "null" ] }, "operatorId": { "type": [ "string", "null" ] }, "vehicleId": { "type": [ "string", "null" ] }, "driverId": { "type": [ "string", "null" ] }, "serviceDate": { "type": [ "string", "null" ] }, "scheduledPickupAt": { "type": [ "string", "null" ] }, "scheduledDropoffAt": { "type": [ "string", "null" ] }, "actualPickupAt": { "type": [ "string", "null" ] }, "actualDropoffAt": { "type": [ "string", "null" ] }, "status": { "type": "string", "enum": [ "draft", "scheduled", "assigned", "en_route", "arrived", "picked_up", "completed", "cancelled", "no_show" ] }, "passengerCount": { "type": [ "integer", "null" ] }, "checkedBags": { "type": [ "integer", "null" ] }, "carryOnBags": { "type": [ "integer", "null" ] }, "notes": { "type": [ "string", "null" ] }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "transferPreferenceId", "bookingId", "bookingItemId", "operatorId", "vehicleId", "driverId", "serviceDate", "scheduledPickupAt", "scheduledDropoffAt", "actualPickupAt", "actualDropoffAt", "status", "passengerCount", "checkedBags", "carryOnBags", "notes", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "postAdminOperationsDispatches", "summary": "POST /v1/admin/operations/dispatches", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/dispatches/{id}": { "get": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "A ground dispatch by id", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "transferPreferenceId": { "type": "string" }, "bookingId": { "type": "string" }, "bookingItemId": { "type": [ "string", "null" ] }, "operatorId": { "type": [ "string", "null" ] }, "vehicleId": { "type": [ "string", "null" ] }, "driverId": { "type": [ "string", "null" ] }, "serviceDate": { "type": [ "string", "null" ] }, "scheduledPickupAt": { "type": [ "string", "null" ] }, "scheduledDropoffAt": { "type": [ "string", "null" ] }, "actualPickupAt": { "type": [ "string", "null" ] }, "actualDropoffAt": { "type": [ "string", "null" ] }, "status": { "type": "string", "enum": [ "draft", "scheduled", "assigned", "en_route", "arrived", "picked_up", "completed", "cancelled", "no_show" ] }, "passengerCount": { "type": [ "integer", "null" ] }, "checkedBags": { "type": [ "integer", "null" ] }, "carryOnBags": { "type": [ "integer", "null" ] }, "notes": { "type": [ "string", "null" ] }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "transferPreferenceId", "bookingId", "bookingItemId", "operatorId", "vehicleId", "driverId", "serviceDate", "scheduledPickupAt", "scheduledDropoffAt", "actualPickupAt", "actualDropoffAt", "status", "passengerCount", "checkedBags", "carryOnBags", "notes", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "404": { "description": "Ground dispatch not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "getAdminOperationsDispatchesById", "summary": "GET /v1/admin/operations/dispatches/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "patch": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "transferPreferenceId": { "type": "string" }, "bookingId": { "type": "string" }, "bookingItemId": { "type": [ "string", "null" ] }, "operatorId": { "type": [ "string", "null" ] }, "vehicleId": { "type": [ "string", "null" ] }, "driverId": { "type": [ "string", "null" ] }, "serviceDate": { "type": [ "string", "null" ], "format": "date" }, "scheduledPickupAt": { "type": [ "string", "null" ], "format": "date-time" }, "scheduledDropoffAt": { "type": [ "string", "null" ], "format": "date-time" }, "actualPickupAt": { "type": [ "string", "null" ], "format": "date-time" }, "actualDropoffAt": { "type": [ "string", "null" ], "format": "date-time" }, "status": { "type": "string", "enum": [ "draft", "scheduled", "assigned", "en_route", "arrived", "picked_up", "completed", "cancelled", "no_show" ], "default": "draft" }, "passengerCount": { "type": [ "integer", "null" ], "minimum": 0 }, "checkedBags": { "type": [ "integer", "null" ], "minimum": 0 }, "carryOnBags": { "type": [ "integer", "null" ], "minimum": 0 }, "notes": { "type": [ "string", "null" ] } } } } } }, "responses": { "200": { "description": "The updated ground dispatch", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "transferPreferenceId": { "type": "string" }, "bookingId": { "type": "string" }, "bookingItemId": { "type": [ "string", "null" ] }, "operatorId": { "type": [ "string", "null" ] }, "vehicleId": { "type": [ "string", "null" ] }, "driverId": { "type": [ "string", "null" ] }, "serviceDate": { "type": [ "string", "null" ] }, "scheduledPickupAt": { "type": [ "string", "null" ] }, "scheduledDropoffAt": { "type": [ "string", "null" ] }, "actualPickupAt": { "type": [ "string", "null" ] }, "actualDropoffAt": { "type": [ "string", "null" ] }, "status": { "type": "string", "enum": [ "draft", "scheduled", "assigned", "en_route", "arrived", "picked_up", "completed", "cancelled", "no_show" ] }, "passengerCount": { "type": [ "integer", "null" ] }, "checkedBags": { "type": [ "integer", "null" ] }, "carryOnBags": { "type": [ "integer", "null" ] }, "notes": { "type": [ "string", "null" ] }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "transferPreferenceId", "bookingId", "bookingItemId", "operatorId", "vehicleId", "driverId", "serviceDate", "scheduledPickupAt", "scheduledDropoffAt", "actualPickupAt", "actualDropoffAt", "status", "passengerCount", "checkedBags", "carryOnBags", "notes", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Ground dispatch not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "patchAdminOperationsDispatchesById", "summary": "PATCH /v1/admin/operations/dispatches/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "delete": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "Ground dispatch deleted", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] } }, "required": [ "success" ] } } } }, "404": { "description": "Ground dispatch not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "deleteAdminOperationsDispatchesById", "summary": "DELETE /v1/admin/operations/dispatches/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/execution-events": { "get": { "parameters": [ { "schema": { "type": "integer", "minimum": 1, "maximum": 200, "default": 50 }, "required": false, "name": "limit", "in": "query" }, { "schema": { "type": [ "integer", "null" ], "minimum": 0, "default": 0 }, "required": false, "name": "offset", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "dispatchId", "in": "query" }, { "schema": { "type": "string", "enum": [ "scheduled", "assigned", "driver_en_route", "driver_arrived", "pickup_completed", "dropoff_completed", "cancelled", "issue", "note" ] }, "required": false, "name": "eventType", "in": "query" } ], "responses": { "200": { "description": "Paginated ground execution events", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "dispatchId": { "type": "string" }, "eventType": { "type": "string", "enum": [ "scheduled", "assigned", "driver_en_route", "driver_arrived", "pickup_completed", "dropoff_completed", "cancelled", "issue", "note" ] }, "occurredAt": { "type": "string" }, "facilityId": { "type": [ "string", "null" ] }, "addressId": { "type": [ "string", "null" ] }, "notes": { "type": [ "string", "null" ] }, "metadata": { "type": [ "object", "null" ], "additionalProperties": {} }, "createdAt": { "type": "string" } }, "required": [ "id", "dispatchId", "eventType", "occurredAt", "facilityId", "addressId", "notes", "metadata", "createdAt" ] } }, "total": { "type": "integer" }, "limit": { "type": "integer" }, "offset": { "type": "integer" } }, "required": [ "data", "total", "limit", "offset" ] } } } } }, "operationId": "getAdminOperationsExecutionEvents", "summary": "GET /v1/admin/operations/execution-events", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "post": { "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "dispatchId": { "type": "string" }, "eventType": { "type": "string", "enum": [ "scheduled", "assigned", "driver_en_route", "driver_arrived", "pickup_completed", "dropoff_completed", "cancelled", "issue", "note" ], "default": "note" }, "occurredAt": { "type": [ "string", "null" ], "format": "date-time" }, "facilityId": { "type": [ "string", "null" ] }, "addressId": { "type": [ "string", "null" ] }, "notes": { "type": [ "string", "null" ] }, "metadata": { "type": [ "object", "null" ], "additionalProperties": {} } }, "required": [ "dispatchId" ] } } } }, "responses": { "201": { "description": "The created ground execution event", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "dispatchId": { "type": "string" }, "eventType": { "type": "string", "enum": [ "scheduled", "assigned", "driver_en_route", "driver_arrived", "pickup_completed", "dropoff_completed", "cancelled", "issue", "note" ] }, "occurredAt": { "type": "string" }, "facilityId": { "type": [ "string", "null" ] }, "addressId": { "type": [ "string", "null" ] }, "notes": { "type": [ "string", "null" ] }, "metadata": { "type": [ "object", "null" ], "additionalProperties": {} }, "createdAt": { "type": "string" } }, "required": [ "id", "dispatchId", "eventType", "occurredAt", "facilityId", "addressId", "notes", "metadata", "createdAt" ] } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "postAdminOperationsExecutionEvents", "summary": "POST /v1/admin/operations/execution-events", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/execution-events/{id}": { "get": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "A ground execution event by id", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "dispatchId": { "type": "string" }, "eventType": { "type": "string", "enum": [ "scheduled", "assigned", "driver_en_route", "driver_arrived", "pickup_completed", "dropoff_completed", "cancelled", "issue", "note" ] }, "occurredAt": { "type": "string" }, "facilityId": { "type": [ "string", "null" ] }, "addressId": { "type": [ "string", "null" ] }, "notes": { "type": [ "string", "null" ] }, "metadata": { "type": [ "object", "null" ], "additionalProperties": {} }, "createdAt": { "type": "string" } }, "required": [ "id", "dispatchId", "eventType", "occurredAt", "facilityId", "addressId", "notes", "metadata", "createdAt" ] } }, "required": [ "data" ] } } } }, "404": { "description": "Ground execution event not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "getAdminOperationsExecutionEventsById", "summary": "GET /v1/admin/operations/execution-events/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "patch": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "dispatchId": { "type": "string" }, "eventType": { "type": "string", "enum": [ "scheduled", "assigned", "driver_en_route", "driver_arrived", "pickup_completed", "dropoff_completed", "cancelled", "issue", "note" ], "default": "note" }, "occurredAt": { "type": [ "string", "null" ], "format": "date-time" }, "facilityId": { "type": [ "string", "null" ] }, "addressId": { "type": [ "string", "null" ] }, "notes": { "type": [ "string", "null" ] }, "metadata": { "type": [ "object", "null" ], "additionalProperties": {} } } } } } }, "responses": { "200": { "description": "The updated ground execution event", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "dispatchId": { "type": "string" }, "eventType": { "type": "string", "enum": [ "scheduled", "assigned", "driver_en_route", "driver_arrived", "pickup_completed", "dropoff_completed", "cancelled", "issue", "note" ] }, "occurredAt": { "type": "string" }, "facilityId": { "type": [ "string", "null" ] }, "addressId": { "type": [ "string", "null" ] }, "notes": { "type": [ "string", "null" ] }, "metadata": { "type": [ "object", "null" ], "additionalProperties": {} }, "createdAt": { "type": "string" } }, "required": [ "id", "dispatchId", "eventType", "occurredAt", "facilityId", "addressId", "notes", "metadata", "createdAt" ] } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Ground execution event not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "patchAdminOperationsExecutionEventsById", "summary": "PATCH /v1/admin/operations/execution-events/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "delete": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "Ground execution event deleted", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] } }, "required": [ "success" ] } } } }, "404": { "description": "Ground execution event not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "deleteAdminOperationsExecutionEventsById", "summary": "DELETE /v1/admin/operations/execution-events/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/dispatch-assignments": { "get": { "parameters": [ { "schema": { "type": "integer", "minimum": 1, "maximum": 200, "default": 50 }, "required": false, "name": "limit", "in": "query" }, { "schema": { "type": [ "integer", "null" ], "minimum": 0, "default": 0 }, "required": false, "name": "offset", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "dispatchId", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "operatorId", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "vehicleId", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "driverId", "in": "query" }, { "schema": { "type": "string", "enum": [ "manual", "suggested", "auto" ] }, "required": false, "name": "assignmentSource", "in": "query" } ], "responses": { "200": { "description": "Paginated ground dispatch assignments", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "dispatchId": { "type": "string" }, "operatorId": { "type": [ "string", "null" ] }, "vehicleId": { "type": [ "string", "null" ] }, "driverId": { "type": [ "string", "null" ] }, "assignmentSource": { "type": "string", "enum": [ "manual", "suggested", "auto" ] }, "assignedAt": { "type": "string" }, "acceptedAt": { "type": [ "string", "null" ] }, "notes": { "type": [ "string", "null" ] }, "metadata": { "type": [ "object", "null" ], "additionalProperties": {} }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "dispatchId", "operatorId", "vehicleId", "driverId", "assignmentSource", "assignedAt", "acceptedAt", "notes", "metadata", "createdAt", "updatedAt" ] } }, "total": { "type": "integer" }, "limit": { "type": "integer" }, "offset": { "type": "integer" } }, "required": [ "data", "total", "limit", "offset" ] } } } } }, "operationId": "getAdminOperationsDispatchAssignments", "summary": "GET /v1/admin/operations/dispatch-assignments", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "post": { "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "dispatchId": { "type": "string" }, "operatorId": { "type": [ "string", "null" ] }, "vehicleId": { "type": [ "string", "null" ] }, "driverId": { "type": [ "string", "null" ] }, "assignmentSource": { "type": "string", "enum": [ "manual", "suggested", "auto" ], "default": "manual" }, "assignedAt": { "type": [ "string", "null" ], "format": "date-time" }, "acceptedAt": { "type": [ "string", "null" ], "format": "date-time" }, "notes": { "type": [ "string", "null" ] }, "metadata": { "type": [ "object", "null" ], "additionalProperties": {} } }, "required": [ "dispatchId" ] } } } }, "responses": { "201": { "description": "The created ground dispatch assignment", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "dispatchId": { "type": "string" }, "operatorId": { "type": [ "string", "null" ] }, "vehicleId": { "type": [ "string", "null" ] }, "driverId": { "type": [ "string", "null" ] }, "assignmentSource": { "type": "string", "enum": [ "manual", "suggested", "auto" ] }, "assignedAt": { "type": "string" }, "acceptedAt": { "type": [ "string", "null" ] }, "notes": { "type": [ "string", "null" ] }, "metadata": { "type": [ "object", "null" ], "additionalProperties": {} }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "dispatchId", "operatorId", "vehicleId", "driverId", "assignmentSource", "assignedAt", "acceptedAt", "notes", "metadata", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "postAdminOperationsDispatchAssignments", "summary": "POST /v1/admin/operations/dispatch-assignments", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/dispatch-assignments/{id}": { "get": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "A ground dispatch assignment by id", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "dispatchId": { "type": "string" }, "operatorId": { "type": [ "string", "null" ] }, "vehicleId": { "type": [ "string", "null" ] }, "driverId": { "type": [ "string", "null" ] }, "assignmentSource": { "type": "string", "enum": [ "manual", "suggested", "auto" ] }, "assignedAt": { "type": "string" }, "acceptedAt": { "type": [ "string", "null" ] }, "notes": { "type": [ "string", "null" ] }, "metadata": { "type": [ "object", "null" ], "additionalProperties": {} }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "dispatchId", "operatorId", "vehicleId", "driverId", "assignmentSource", "assignedAt", "acceptedAt", "notes", "metadata", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "404": { "description": "Ground dispatch assignment not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "getAdminOperationsDispatchAssignmentsById", "summary": "GET /v1/admin/operations/dispatch-assignments/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "patch": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "dispatchId": { "type": "string" }, "operatorId": { "type": [ "string", "null" ] }, "vehicleId": { "type": [ "string", "null" ] }, "driverId": { "type": [ "string", "null" ] }, "assignmentSource": { "type": "string", "enum": [ "manual", "suggested", "auto" ], "default": "manual" }, "assignedAt": { "type": [ "string", "null" ], "format": "date-time" }, "acceptedAt": { "type": [ "string", "null" ], "format": "date-time" }, "notes": { "type": [ "string", "null" ] }, "metadata": { "type": [ "object", "null" ], "additionalProperties": {} } } } } } }, "responses": { "200": { "description": "The updated ground dispatch assignment", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "dispatchId": { "type": "string" }, "operatorId": { "type": [ "string", "null" ] }, "vehicleId": { "type": [ "string", "null" ] }, "driverId": { "type": [ "string", "null" ] }, "assignmentSource": { "type": "string", "enum": [ "manual", "suggested", "auto" ] }, "assignedAt": { "type": "string" }, "acceptedAt": { "type": [ "string", "null" ] }, "notes": { "type": [ "string", "null" ] }, "metadata": { "type": [ "object", "null" ], "additionalProperties": {} }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "dispatchId", "operatorId", "vehicleId", "driverId", "assignmentSource", "assignedAt", "acceptedAt", "notes", "metadata", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Ground dispatch assignment not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "patchAdminOperationsDispatchAssignmentsById", "summary": "PATCH /v1/admin/operations/dispatch-assignments/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "delete": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "Ground dispatch assignment deleted", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] } }, "required": [ "success" ] } } } }, "404": { "description": "Ground dispatch assignment not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "deleteAdminOperationsDispatchAssignmentsById", "summary": "DELETE /v1/admin/operations/dispatch-assignments/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/dispatch-legs": { "get": { "parameters": [ { "schema": { "type": "integer", "minimum": 1, "maximum": 200, "default": 50 }, "required": false, "name": "limit", "in": "query" }, { "schema": { "type": [ "integer", "null" ], "minimum": 0, "default": 0 }, "required": false, "name": "offset", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "dispatchId", "in": "query" }, { "schema": { "type": "string", "enum": [ "pickup", "stop", "dropoff", "deadhead" ] }, "required": false, "name": "legType", "in": "query" } ], "responses": { "200": { "description": "Paginated ground dispatch legs", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "dispatchId": { "type": "string" }, "sequence": { "type": "integer" }, "legType": { "type": "string", "enum": [ "pickup", "stop", "dropoff", "deadhead" ] }, "facilityId": { "type": [ "string", "null" ] }, "addressId": { "type": [ "string", "null" ] }, "scheduledAt": { "type": [ "string", "null" ] }, "actualAt": { "type": [ "string", "null" ] }, "notes": { "type": [ "string", "null" ] }, "metadata": { "type": [ "object", "null" ], "additionalProperties": {} }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "dispatchId", "sequence", "legType", "facilityId", "addressId", "scheduledAt", "actualAt", "notes", "metadata", "createdAt", "updatedAt" ] } }, "total": { "type": "integer" }, "limit": { "type": "integer" }, "offset": { "type": "integer" } }, "required": [ "data", "total", "limit", "offset" ] } } } } }, "operationId": "getAdminOperationsDispatchLegs", "summary": "GET /v1/admin/operations/dispatch-legs", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "post": { "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "dispatchId": { "type": "string" }, "sequence": { "type": "integer", "minimum": 0, "default": 0 }, "legType": { "type": "string", "enum": [ "pickup", "stop", "dropoff", "deadhead" ], "default": "pickup" }, "facilityId": { "type": [ "string", "null" ] }, "addressId": { "type": [ "string", "null" ] }, "scheduledAt": { "type": [ "string", "null" ], "format": "date-time" }, "actualAt": { "type": [ "string", "null" ], "format": "date-time" }, "notes": { "type": [ "string", "null" ] }, "metadata": { "type": [ "object", "null" ], "additionalProperties": {} } }, "required": [ "dispatchId" ] } } } }, "responses": { "201": { "description": "The created ground dispatch leg", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "dispatchId": { "type": "string" }, "sequence": { "type": "integer" }, "legType": { "type": "string", "enum": [ "pickup", "stop", "dropoff", "deadhead" ] }, "facilityId": { "type": [ "string", "null" ] }, "addressId": { "type": [ "string", "null" ] }, "scheduledAt": { "type": [ "string", "null" ] }, "actualAt": { "type": [ "string", "null" ] }, "notes": { "type": [ "string", "null" ] }, "metadata": { "type": [ "object", "null" ], "additionalProperties": {} }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "dispatchId", "sequence", "legType", "facilityId", "addressId", "scheduledAt", "actualAt", "notes", "metadata", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "postAdminOperationsDispatchLegs", "summary": "POST /v1/admin/operations/dispatch-legs", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/dispatch-legs/{id}": { "get": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "A ground dispatch leg by id", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "dispatchId": { "type": "string" }, "sequence": { "type": "integer" }, "legType": { "type": "string", "enum": [ "pickup", "stop", "dropoff", "deadhead" ] }, "facilityId": { "type": [ "string", "null" ] }, "addressId": { "type": [ "string", "null" ] }, "scheduledAt": { "type": [ "string", "null" ] }, "actualAt": { "type": [ "string", "null" ] }, "notes": { "type": [ "string", "null" ] }, "metadata": { "type": [ "object", "null" ], "additionalProperties": {} }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "dispatchId", "sequence", "legType", "facilityId", "addressId", "scheduledAt", "actualAt", "notes", "metadata", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "404": { "description": "Ground dispatch leg not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "getAdminOperationsDispatchLegsById", "summary": "GET /v1/admin/operations/dispatch-legs/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "patch": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "dispatchId": { "type": "string" }, "sequence": { "type": "integer", "minimum": 0, "default": 0 }, "legType": { "type": "string", "enum": [ "pickup", "stop", "dropoff", "deadhead" ], "default": "pickup" }, "facilityId": { "type": [ "string", "null" ] }, "addressId": { "type": [ "string", "null" ] }, "scheduledAt": { "type": [ "string", "null" ], "format": "date-time" }, "actualAt": { "type": [ "string", "null" ], "format": "date-time" }, "notes": { "type": [ "string", "null" ] }, "metadata": { "type": [ "object", "null" ], "additionalProperties": {} } } } } } }, "responses": { "200": { "description": "The updated ground dispatch leg", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "dispatchId": { "type": "string" }, "sequence": { "type": "integer" }, "legType": { "type": "string", "enum": [ "pickup", "stop", "dropoff", "deadhead" ] }, "facilityId": { "type": [ "string", "null" ] }, "addressId": { "type": [ "string", "null" ] }, "scheduledAt": { "type": [ "string", "null" ] }, "actualAt": { "type": [ "string", "null" ] }, "notes": { "type": [ "string", "null" ] }, "metadata": { "type": [ "object", "null" ], "additionalProperties": {} }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "dispatchId", "sequence", "legType", "facilityId", "addressId", "scheduledAt", "actualAt", "notes", "metadata", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Ground dispatch leg not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "patchAdminOperationsDispatchLegsById", "summary": "PATCH /v1/admin/operations/dispatch-legs/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "delete": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "Ground dispatch leg deleted", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] } }, "required": [ "success" ] } } } }, "404": { "description": "Ground dispatch leg not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "deleteAdminOperationsDispatchLegsById", "summary": "DELETE /v1/admin/operations/dispatch-legs/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/dispatch-passengers": { "get": { "parameters": [ { "schema": { "type": "integer", "minimum": 1, "maximum": 200, "default": 50 }, "required": false, "name": "limit", "in": "query" }, { "schema": { "type": [ "integer", "null" ], "minimum": 0, "default": 0 }, "required": false, "name": "offset", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "dispatchId", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "participantId", "in": "query" } ], "responses": { "200": { "description": "Paginated ground dispatch passengers", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "dispatchId": { "type": "string" }, "participantId": { "type": [ "string", "null" ] }, "displayName": { "type": [ "string", "null" ] }, "seatLabel": { "type": [ "string", "null" ] }, "notes": { "type": [ "string", "null" ] }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "dispatchId", "participantId", "displayName", "seatLabel", "notes", "createdAt", "updatedAt" ] } }, "total": { "type": "integer" }, "limit": { "type": "integer" }, "offset": { "type": "integer" } }, "required": [ "data", "total", "limit", "offset" ] } } } } }, "operationId": "getAdminOperationsDispatchPassengers", "summary": "GET /v1/admin/operations/dispatch-passengers", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "post": { "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "dispatchId": { "type": "string" }, "participantId": { "type": [ "string", "null" ] }, "displayName": { "type": [ "string", "null" ] }, "seatLabel": { "type": [ "string", "null" ] }, "notes": { "type": [ "string", "null" ] } }, "required": [ "dispatchId" ] } } } }, "responses": { "201": { "description": "The created ground dispatch passenger", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "dispatchId": { "type": "string" }, "participantId": { "type": [ "string", "null" ] }, "displayName": { "type": [ "string", "null" ] }, "seatLabel": { "type": [ "string", "null" ] }, "notes": { "type": [ "string", "null" ] }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "dispatchId", "participantId", "displayName", "seatLabel", "notes", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "postAdminOperationsDispatchPassengers", "summary": "POST /v1/admin/operations/dispatch-passengers", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/dispatch-passengers/{id}": { "get": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "A ground dispatch passenger by id", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "dispatchId": { "type": "string" }, "participantId": { "type": [ "string", "null" ] }, "displayName": { "type": [ "string", "null" ] }, "seatLabel": { "type": [ "string", "null" ] }, "notes": { "type": [ "string", "null" ] }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "dispatchId", "participantId", "displayName", "seatLabel", "notes", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "404": { "description": "Ground dispatch passenger not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "getAdminOperationsDispatchPassengersById", "summary": "GET /v1/admin/operations/dispatch-passengers/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "patch": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "dispatchId": { "type": "string" }, "participantId": { "type": [ "string", "null" ] }, "displayName": { "type": [ "string", "null" ] }, "seatLabel": { "type": [ "string", "null" ] }, "notes": { "type": [ "string", "null" ] } } } } } }, "responses": { "200": { "description": "The updated ground dispatch passenger", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "dispatchId": { "type": "string" }, "participantId": { "type": [ "string", "null" ] }, "displayName": { "type": [ "string", "null" ] }, "seatLabel": { "type": [ "string", "null" ] }, "notes": { "type": [ "string", "null" ] }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "dispatchId", "participantId", "displayName", "seatLabel", "notes", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Ground dispatch passenger not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "patchAdminOperationsDispatchPassengersById", "summary": "PATCH /v1/admin/operations/dispatch-passengers/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "delete": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "Ground dispatch passenger deleted", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] } }, "required": [ "success" ] } } } }, "404": { "description": "Ground dispatch passenger not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "deleteAdminOperationsDispatchPassengersById", "summary": "DELETE /v1/admin/operations/dispatch-passengers/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/driver-shifts": { "get": { "parameters": [ { "schema": { "type": "integer", "minimum": 1, "maximum": 200, "default": 50 }, "required": false, "name": "limit", "in": "query" }, { "schema": { "type": [ "integer", "null" ], "minimum": 0, "default": 0 }, "required": false, "name": "offset", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "driverId", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "operatorId", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "facilityId", "in": "query" }, { "schema": { "type": "string", "enum": [ "scheduled", "available", "on_duty", "completed", "cancelled" ] }, "required": false, "name": "status", "in": "query" } ], "responses": { "200": { "description": "Paginated ground driver shifts", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "driverId": { "type": "string" }, "operatorId": { "type": [ "string", "null" ] }, "facilityId": { "type": [ "string", "null" ] }, "startsAt": { "type": "string" }, "endsAt": { "type": "string" }, "status": { "type": "string", "enum": [ "scheduled", "available", "on_duty", "completed", "cancelled" ] }, "notes": { "type": [ "string", "null" ] }, "metadata": { "type": [ "object", "null" ], "additionalProperties": {} }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "driverId", "operatorId", "facilityId", "startsAt", "endsAt", "status", "notes", "metadata", "createdAt", "updatedAt" ] } }, "total": { "type": "integer" }, "limit": { "type": "integer" }, "offset": { "type": "integer" } }, "required": [ "data", "total", "limit", "offset" ] } } } } }, "operationId": "getAdminOperationsDriverShifts", "summary": "GET /v1/admin/operations/driver-shifts", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "post": { "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "driverId": { "type": "string" }, "operatorId": { "type": [ "string", "null" ] }, "facilityId": { "type": [ "string", "null" ] }, "startsAt": { "type": "string", "format": "date-time" }, "endsAt": { "type": "string", "format": "date-time" }, "status": { "type": "string", "enum": [ "scheduled", "available", "on_duty", "completed", "cancelled" ], "default": "scheduled" }, "notes": { "type": [ "string", "null" ] }, "metadata": { "type": [ "object", "null" ], "additionalProperties": {} } }, "required": [ "driverId", "startsAt", "endsAt" ] } } } }, "responses": { "201": { "description": "The created ground driver shift", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "driverId": { "type": "string" }, "operatorId": { "type": [ "string", "null" ] }, "facilityId": { "type": [ "string", "null" ] }, "startsAt": { "type": "string" }, "endsAt": { "type": "string" }, "status": { "type": "string", "enum": [ "scheduled", "available", "on_duty", "completed", "cancelled" ] }, "notes": { "type": [ "string", "null" ] }, "metadata": { "type": [ "object", "null" ], "additionalProperties": {} }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "driverId", "operatorId", "facilityId", "startsAt", "endsAt", "status", "notes", "metadata", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "postAdminOperationsDriverShifts", "summary": "POST /v1/admin/operations/driver-shifts", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/driver-shifts/{id}": { "get": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "A ground driver shift by id", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "driverId": { "type": "string" }, "operatorId": { "type": [ "string", "null" ] }, "facilityId": { "type": [ "string", "null" ] }, "startsAt": { "type": "string" }, "endsAt": { "type": "string" }, "status": { "type": "string", "enum": [ "scheduled", "available", "on_duty", "completed", "cancelled" ] }, "notes": { "type": [ "string", "null" ] }, "metadata": { "type": [ "object", "null" ], "additionalProperties": {} }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "driverId", "operatorId", "facilityId", "startsAt", "endsAt", "status", "notes", "metadata", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "404": { "description": "Ground driver shift not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "getAdminOperationsDriverShiftsById", "summary": "GET /v1/admin/operations/driver-shifts/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "patch": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "driverId": { "type": "string" }, "operatorId": { "type": [ "string", "null" ] }, "facilityId": { "type": [ "string", "null" ] }, "startsAt": { "type": "string", "format": "date-time" }, "endsAt": { "type": "string", "format": "date-time" }, "status": { "type": "string", "enum": [ "scheduled", "available", "on_duty", "completed", "cancelled" ], "default": "scheduled" }, "notes": { "type": [ "string", "null" ] }, "metadata": { "type": [ "object", "null" ], "additionalProperties": {} } } } } } }, "responses": { "200": { "description": "The updated ground driver shift", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "driverId": { "type": "string" }, "operatorId": { "type": [ "string", "null" ] }, "facilityId": { "type": [ "string", "null" ] }, "startsAt": { "type": "string" }, "endsAt": { "type": "string" }, "status": { "type": "string", "enum": [ "scheduled", "available", "on_duty", "completed", "cancelled" ] }, "notes": { "type": [ "string", "null" ] }, "metadata": { "type": [ "object", "null" ], "additionalProperties": {} }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "driverId", "operatorId", "facilityId", "startsAt", "endsAt", "status", "notes", "metadata", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Ground driver shift not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "patchAdminOperationsDriverShiftsById", "summary": "PATCH /v1/admin/operations/driver-shifts/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "delete": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "Ground driver shift deleted", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] } }, "required": [ "success" ] } } } }, "404": { "description": "Ground driver shift not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "deleteAdminOperationsDriverShiftsById", "summary": "DELETE /v1/admin/operations/driver-shifts/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/service-incidents": { "get": { "parameters": [ { "schema": { "type": "integer", "minimum": 1, "maximum": 200, "default": 50 }, "required": false, "name": "limit", "in": "query" }, { "schema": { "type": [ "integer", "null" ], "minimum": 0, "default": 0 }, "required": false, "name": "offset", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "dispatchId", "in": "query" }, { "schema": { "type": "string", "enum": [ "info", "warning", "critical" ] }, "required": false, "name": "severity", "in": "query" }, { "schema": { "type": "string", "enum": [ "open", "mitigated", "resolved", "cancelled" ] }, "required": false, "name": "resolutionStatus", "in": "query" } ], "responses": { "200": { "description": "Paginated ground service incidents", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "dispatchId": { "type": "string" }, "severity": { "type": "string", "enum": [ "info", "warning", "critical" ] }, "incidentType": { "type": "string" }, "resolutionStatus": { "type": "string", "enum": [ "open", "mitigated", "resolved", "cancelled" ] }, "openedAt": { "type": "string" }, "resolvedAt": { "type": [ "string", "null" ] }, "notes": { "type": [ "string", "null" ] }, "metadata": { "type": [ "object", "null" ], "additionalProperties": {} }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "dispatchId", "severity", "incidentType", "resolutionStatus", "openedAt", "resolvedAt", "notes", "metadata", "createdAt", "updatedAt" ] } }, "total": { "type": "integer" }, "limit": { "type": "integer" }, "offset": { "type": "integer" } }, "required": [ "data", "total", "limit", "offset" ] } } } } }, "operationId": "getAdminOperationsServiceIncidents", "summary": "GET /v1/admin/operations/service-incidents", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "post": { "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "dispatchId": { "type": "string" }, "severity": { "type": "string", "enum": [ "info", "warning", "critical" ], "default": "warning" }, "incidentType": { "type": "string", "minLength": 1 }, "resolutionStatus": { "type": "string", "enum": [ "open", "mitigated", "resolved", "cancelled" ], "default": "open" }, "openedAt": { "type": [ "string", "null" ], "format": "date-time" }, "resolvedAt": { "type": [ "string", "null" ], "format": "date-time" }, "notes": { "type": [ "string", "null" ] }, "metadata": { "type": [ "object", "null" ], "additionalProperties": {} } }, "required": [ "dispatchId", "incidentType" ] } } } }, "responses": { "201": { "description": "The created ground service incident", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "dispatchId": { "type": "string" }, "severity": { "type": "string", "enum": [ "info", "warning", "critical" ] }, "incidentType": { "type": "string" }, "resolutionStatus": { "type": "string", "enum": [ "open", "mitigated", "resolved", "cancelled" ] }, "openedAt": { "type": "string" }, "resolvedAt": { "type": [ "string", "null" ] }, "notes": { "type": [ "string", "null" ] }, "metadata": { "type": [ "object", "null" ], "additionalProperties": {} }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "dispatchId", "severity", "incidentType", "resolutionStatus", "openedAt", "resolvedAt", "notes", "metadata", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "postAdminOperationsServiceIncidents", "summary": "POST /v1/admin/operations/service-incidents", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/service-incidents/{id}": { "get": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "A ground service incident by id", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "dispatchId": { "type": "string" }, "severity": { "type": "string", "enum": [ "info", "warning", "critical" ] }, "incidentType": { "type": "string" }, "resolutionStatus": { "type": "string", "enum": [ "open", "mitigated", "resolved", "cancelled" ] }, "openedAt": { "type": "string" }, "resolvedAt": { "type": [ "string", "null" ] }, "notes": { "type": [ "string", "null" ] }, "metadata": { "type": [ "object", "null" ], "additionalProperties": {} }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "dispatchId", "severity", "incidentType", "resolutionStatus", "openedAt", "resolvedAt", "notes", "metadata", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "404": { "description": "Ground service incident not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "getAdminOperationsServiceIncidentsById", "summary": "GET /v1/admin/operations/service-incidents/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "patch": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "dispatchId": { "type": "string" }, "severity": { "type": "string", "enum": [ "info", "warning", "critical" ], "default": "warning" }, "incidentType": { "type": "string", "minLength": 1 }, "resolutionStatus": { "type": "string", "enum": [ "open", "mitigated", "resolved", "cancelled" ], "default": "open" }, "openedAt": { "type": [ "string", "null" ], "format": "date-time" }, "resolvedAt": { "type": [ "string", "null" ], "format": "date-time" }, "notes": { "type": [ "string", "null" ] }, "metadata": { "type": [ "object", "null" ], "additionalProperties": {} } } } } } }, "responses": { "200": { "description": "The updated ground service incident", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "dispatchId": { "type": "string" }, "severity": { "type": "string", "enum": [ "info", "warning", "critical" ] }, "incidentType": { "type": "string" }, "resolutionStatus": { "type": "string", "enum": [ "open", "mitigated", "resolved", "cancelled" ] }, "openedAt": { "type": "string" }, "resolvedAt": { "type": [ "string", "null" ] }, "notes": { "type": [ "string", "null" ] }, "metadata": { "type": [ "object", "null" ], "additionalProperties": {} }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "dispatchId", "severity", "incidentType", "resolutionStatus", "openedAt", "resolvedAt", "notes", "metadata", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Ground service incident not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "patchAdminOperationsServiceIncidentsById", "summary": "PATCH /v1/admin/operations/service-incidents/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "delete": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "Ground service incident deleted", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] } }, "required": [ "success" ] } } } }, "404": { "description": "Ground service incident not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "deleteAdminOperationsServiceIncidentsById", "summary": "DELETE /v1/admin/operations/service-incidents/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/dispatch-checkpoints": { "get": { "parameters": [ { "schema": { "type": "integer", "minimum": 1, "maximum": 200, "default": 50 }, "required": false, "name": "limit", "in": "query" }, { "schema": { "type": [ "integer", "null" ], "minimum": 0, "default": 0 }, "required": false, "name": "offset", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "dispatchId", "in": "query" }, { "schema": { "type": "string", "enum": [ "pending", "reached", "missed", "cancelled" ] }, "required": false, "name": "status", "in": "query" } ], "responses": { "200": { "description": "Paginated ground dispatch checkpoints", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "dispatchId": { "type": "string" }, "sequence": { "type": "integer" }, "checkpointType": { "type": "string" }, "status": { "type": "string", "enum": [ "pending", "reached", "missed", "cancelled" ] }, "plannedAt": { "type": [ "string", "null" ] }, "actualAt": { "type": [ "string", "null" ] }, "facilityId": { "type": [ "string", "null" ] }, "addressId": { "type": [ "string", "null" ] }, "notes": { "type": [ "string", "null" ] }, "metadata": { "type": [ "object", "null" ], "additionalProperties": {} }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "dispatchId", "sequence", "checkpointType", "status", "plannedAt", "actualAt", "facilityId", "addressId", "notes", "metadata", "createdAt", "updatedAt" ] } }, "total": { "type": "integer" }, "limit": { "type": "integer" }, "offset": { "type": "integer" } }, "required": [ "data", "total", "limit", "offset" ] } } } } }, "operationId": "getAdminOperationsDispatchCheckpoints", "summary": "GET /v1/admin/operations/dispatch-checkpoints", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "post": { "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "dispatchId": { "type": "string" }, "sequence": { "type": "integer", "minimum": 0, "default": 0 }, "checkpointType": { "type": "string", "minLength": 1 }, "status": { "type": "string", "enum": [ "pending", "reached", "missed", "cancelled" ], "default": "pending" }, "plannedAt": { "type": [ "string", "null" ], "format": "date-time" }, "actualAt": { "type": [ "string", "null" ], "format": "date-time" }, "facilityId": { "type": [ "string", "null" ] }, "addressId": { "type": [ "string", "null" ] }, "notes": { "type": [ "string", "null" ] }, "metadata": { "type": [ "object", "null" ], "additionalProperties": {} } }, "required": [ "dispatchId", "checkpointType" ] } } } }, "responses": { "201": { "description": "The created ground dispatch checkpoint", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "dispatchId": { "type": "string" }, "sequence": { "type": "integer" }, "checkpointType": { "type": "string" }, "status": { "type": "string", "enum": [ "pending", "reached", "missed", "cancelled" ] }, "plannedAt": { "type": [ "string", "null" ] }, "actualAt": { "type": [ "string", "null" ] }, "facilityId": { "type": [ "string", "null" ] }, "addressId": { "type": [ "string", "null" ] }, "notes": { "type": [ "string", "null" ] }, "metadata": { "type": [ "object", "null" ], "additionalProperties": {} }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "dispatchId", "sequence", "checkpointType", "status", "plannedAt", "actualAt", "facilityId", "addressId", "notes", "metadata", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "postAdminOperationsDispatchCheckpoints", "summary": "POST /v1/admin/operations/dispatch-checkpoints", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/dispatch-checkpoints/{id}": { "get": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "A ground dispatch checkpoint by id", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "dispatchId": { "type": "string" }, "sequence": { "type": "integer" }, "checkpointType": { "type": "string" }, "status": { "type": "string", "enum": [ "pending", "reached", "missed", "cancelled" ] }, "plannedAt": { "type": [ "string", "null" ] }, "actualAt": { "type": [ "string", "null" ] }, "facilityId": { "type": [ "string", "null" ] }, "addressId": { "type": [ "string", "null" ] }, "notes": { "type": [ "string", "null" ] }, "metadata": { "type": [ "object", "null" ], "additionalProperties": {} }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "dispatchId", "sequence", "checkpointType", "status", "plannedAt", "actualAt", "facilityId", "addressId", "notes", "metadata", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "404": { "description": "Ground dispatch checkpoint not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "getAdminOperationsDispatchCheckpointsById", "summary": "GET /v1/admin/operations/dispatch-checkpoints/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "patch": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "dispatchId": { "type": "string" }, "sequence": { "type": "integer", "minimum": 0, "default": 0 }, "checkpointType": { "type": "string", "minLength": 1 }, "status": { "type": "string", "enum": [ "pending", "reached", "missed", "cancelled" ], "default": "pending" }, "plannedAt": { "type": [ "string", "null" ], "format": "date-time" }, "actualAt": { "type": [ "string", "null" ], "format": "date-time" }, "facilityId": { "type": [ "string", "null" ] }, "addressId": { "type": [ "string", "null" ] }, "notes": { "type": [ "string", "null" ] }, "metadata": { "type": [ "object", "null" ], "additionalProperties": {} } } } } } }, "responses": { "200": { "description": "The updated ground dispatch checkpoint", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "dispatchId": { "type": "string" }, "sequence": { "type": "integer" }, "checkpointType": { "type": "string" }, "status": { "type": "string", "enum": [ "pending", "reached", "missed", "cancelled" ] }, "plannedAt": { "type": [ "string", "null" ] }, "actualAt": { "type": [ "string", "null" ] }, "facilityId": { "type": [ "string", "null" ] }, "addressId": { "type": [ "string", "null" ] }, "notes": { "type": [ "string", "null" ] }, "metadata": { "type": [ "object", "null" ], "additionalProperties": {} }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "dispatchId", "sequence", "checkpointType", "status", "plannedAt", "actualAt", "facilityId", "addressId", "notes", "metadata", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Ground dispatch checkpoint not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "patchAdminOperationsDispatchCheckpointsById", "summary": "PATCH /v1/admin/operations/dispatch-checkpoints/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "delete": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "Ground dispatch checkpoint deleted", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] } }, "required": [ "success" ] } } } }, "404": { "description": "Ground dispatch checkpoint not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "deleteAdminOperationsDispatchCheckpointsById", "summary": "DELETE /v1/admin/operations/dispatch-checkpoints/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/facilities": { "get": { "parameters": [ { "schema": { "type": "integer", "minimum": 1, "maximum": 200, "default": 50 }, "required": false, "name": "limit", "in": "query" }, { "schema": { "type": [ "integer", "null" ], "minimum": 0, "default": 0 }, "required": false, "name": "offset", "in": "query" }, { "schema": { "type": "string", "enum": [ "property", "hotel", "resort", "venue", "meeting_point", "transfer_hub", "airport", "station", "marina", "camp", "lodge", "office", "attraction", "restaurant", "other" ] }, "required": false, "name": "kind", "in": "query" }, { "schema": { "type": "string", "enum": [ "active", "inactive", "archived" ] }, "required": false, "name": "status", "in": "query" }, { "schema": { "type": "string", "enum": [ "supplier", "organization", "internal", "other" ] }, "required": false, "name": "ownerType", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "ownerId", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "parentFacilityId", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "country", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "search", "in": "query" } ], "responses": { "200": { "description": "Paginated facilities", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "parentFacilityId": { "type": [ "string", "null" ] }, "ownerType": { "type": [ "string", "null" ], "enum": [ "supplier", "organization", "internal", "other", null ] }, "ownerId": { "type": [ "string", "null" ] }, "kind": { "type": "string", "enum": [ "property", "hotel", "resort", "venue", "meeting_point", "transfer_hub", "airport", "station", "marina", "camp", "lodge", "office", "attraction", "restaurant", "other" ] }, "status": { "type": "string", "enum": [ "active", "inactive", "archived" ] }, "name": { "type": "string" }, "code": { "type": [ "string", "null" ] }, "description": { "type": [ "string", "null" ] }, "timezone": { "type": [ "string", "null" ] }, "tags": { "type": "array", "items": { "type": "string" } }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" }, "addressLine1": { "type": [ "string", "null" ] }, "addressLine2": { "type": [ "string", "null" ] }, "city": { "type": [ "string", "null" ] }, "region": { "type": [ "string", "null" ] }, "country": { "type": [ "string", "null" ] }, "postalCode": { "type": [ "string", "null" ] }, "latitude": { "type": [ "number", "null" ] }, "longitude": { "type": [ "number", "null" ] }, "address": { "type": [ "string", "null" ] } }, "required": [ "id", "parentFacilityId", "ownerType", "ownerId", "kind", "status", "name", "code", "description", "timezone", "tags", "createdAt", "updatedAt", "addressLine1", "addressLine2", "city", "region", "country", "postalCode", "latitude", "longitude", "address" ] } }, "total": { "type": "integer" }, "limit": { "type": "integer" }, "offset": { "type": "integer" } }, "required": [ "data", "total", "limit", "offset" ] } } } } }, "operationId": "getAdminOperationsFacilities", "summary": "GET /v1/admin/operations/facilities", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "post": { "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "parentFacilityId": { "type": [ "string", "null" ] }, "ownerType": { "type": [ "string", "null" ], "enum": [ "supplier", "organization", "internal", "other", null ] }, "ownerId": { "type": [ "string", "null" ] }, "kind": { "type": "string", "enum": [ "property", "hotel", "resort", "venue", "meeting_point", "transfer_hub", "airport", "station", "marina", "camp", "lodge", "office", "attraction", "restaurant", "other" ] }, "status": { "type": "string", "enum": [ "active", "inactive", "archived" ], "default": "active" }, "name": { "type": "string", "minLength": 1, "maxLength": 255 }, "code": { "type": [ "string", "null" ], "maxLength": 100 }, "description": { "type": [ "string", "null" ] }, "timezone": { "type": [ "string", "null" ], "maxLength": 100 }, "addressLine1": { "type": [ "string", "null" ] }, "addressLine2": { "type": [ "string", "null" ] }, "city": { "type": [ "string", "null" ] }, "region": { "type": [ "string", "null" ] }, "country": { "type": [ "string", "null" ] }, "postalCode": { "type": [ "string", "null" ] }, "latitude": { "type": [ "number", "null" ] }, "longitude": { "type": [ "number", "null" ] }, "tags": { "type": "array", "items": { "type": "string" }, "default": [] } }, "required": [ "kind", "name" ] } } } }, "responses": { "201": { "description": "The created facility", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "parentFacilityId": { "type": [ "string", "null" ] }, "ownerType": { "type": [ "string", "null" ], "enum": [ "supplier", "organization", "internal", "other", null ] }, "ownerId": { "type": [ "string", "null" ] }, "kind": { "type": "string", "enum": [ "property", "hotel", "resort", "venue", "meeting_point", "transfer_hub", "airport", "station", "marina", "camp", "lodge", "office", "attraction", "restaurant", "other" ] }, "status": { "type": "string", "enum": [ "active", "inactive", "archived" ] }, "name": { "type": "string" }, "code": { "type": [ "string", "null" ] }, "description": { "type": [ "string", "null" ] }, "timezone": { "type": [ "string", "null" ] }, "tags": { "type": "array", "items": { "type": "string" } }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" }, "addressLine1": { "type": [ "string", "null" ] }, "addressLine2": { "type": [ "string", "null" ] }, "city": { "type": [ "string", "null" ] }, "region": { "type": [ "string", "null" ] }, "country": { "type": [ "string", "null" ] }, "postalCode": { "type": [ "string", "null" ] }, "latitude": { "type": [ "number", "null" ] }, "longitude": { "type": [ "number", "null" ] }, "address": { "type": [ "string", "null" ] } }, "required": [ "id", "parentFacilityId", "ownerType", "ownerId", "kind", "status", "name", "code", "description", "timezone", "tags", "createdAt", "updatedAt", "addressLine1", "addressLine2", "city", "region", "country", "postalCode", "latitude", "longitude", "address" ] } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "postAdminOperationsFacilities", "summary": "POST /v1/admin/operations/facilities", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/facilities/{id}": { "get": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "A facility by id", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "parentFacilityId": { "type": [ "string", "null" ] }, "ownerType": { "type": [ "string", "null" ], "enum": [ "supplier", "organization", "internal", "other", null ] }, "ownerId": { "type": [ "string", "null" ] }, "kind": { "type": "string", "enum": [ "property", "hotel", "resort", "venue", "meeting_point", "transfer_hub", "airport", "station", "marina", "camp", "lodge", "office", "attraction", "restaurant", "other" ] }, "status": { "type": "string", "enum": [ "active", "inactive", "archived" ] }, "name": { "type": "string" }, "code": { "type": [ "string", "null" ] }, "description": { "type": [ "string", "null" ] }, "timezone": { "type": [ "string", "null" ] }, "tags": { "type": "array", "items": { "type": "string" } }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" }, "addressLine1": { "type": [ "string", "null" ] }, "addressLine2": { "type": [ "string", "null" ] }, "city": { "type": [ "string", "null" ] }, "region": { "type": [ "string", "null" ] }, "country": { "type": [ "string", "null" ] }, "postalCode": { "type": [ "string", "null" ] }, "latitude": { "type": [ "number", "null" ] }, "longitude": { "type": [ "number", "null" ] }, "address": { "type": [ "string", "null" ] } }, "required": [ "id", "parentFacilityId", "ownerType", "ownerId", "kind", "status", "name", "code", "description", "timezone", "tags", "createdAt", "updatedAt", "addressLine1", "addressLine2", "city", "region", "country", "postalCode", "latitude", "longitude", "address" ] } }, "required": [ "data" ] } } } }, "404": { "description": "Facility not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "getAdminOperationsFacilitiesById", "summary": "GET /v1/admin/operations/facilities/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "patch": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "parentFacilityId": { "type": [ "string", "null" ] }, "ownerType": { "type": [ "string", "null" ], "enum": [ "supplier", "organization", "internal", "other", null ] }, "ownerId": { "type": [ "string", "null" ] }, "kind": { "type": "string", "enum": [ "property", "hotel", "resort", "venue", "meeting_point", "transfer_hub", "airport", "station", "marina", "camp", "lodge", "office", "attraction", "restaurant", "other" ] }, "status": { "type": "string", "enum": [ "active", "inactive", "archived" ], "default": "active" }, "name": { "type": "string", "minLength": 1, "maxLength": 255 }, "code": { "type": [ "string", "null" ], "maxLength": 100 }, "description": { "type": [ "string", "null" ] }, "timezone": { "type": [ "string", "null" ], "maxLength": 100 }, "addressLine1": { "type": [ "string", "null" ] }, "addressLine2": { "type": [ "string", "null" ] }, "city": { "type": [ "string", "null" ] }, "region": { "type": [ "string", "null" ] }, "country": { "type": [ "string", "null" ] }, "postalCode": { "type": [ "string", "null" ] }, "latitude": { "type": [ "number", "null" ] }, "longitude": { "type": [ "number", "null" ] }, "tags": { "type": "array", "items": { "type": "string" }, "default": [] } } } } } }, "responses": { "200": { "description": "The updated facility", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "parentFacilityId": { "type": [ "string", "null" ] }, "ownerType": { "type": [ "string", "null" ], "enum": [ "supplier", "organization", "internal", "other", null ] }, "ownerId": { "type": [ "string", "null" ] }, "kind": { "type": "string", "enum": [ "property", "hotel", "resort", "venue", "meeting_point", "transfer_hub", "airport", "station", "marina", "camp", "lodge", "office", "attraction", "restaurant", "other" ] }, "status": { "type": "string", "enum": [ "active", "inactive", "archived" ] }, "name": { "type": "string" }, "code": { "type": [ "string", "null" ] }, "description": { "type": [ "string", "null" ] }, "timezone": { "type": [ "string", "null" ] }, "tags": { "type": "array", "items": { "type": "string" } }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" }, "addressLine1": { "type": [ "string", "null" ] }, "addressLine2": { "type": [ "string", "null" ] }, "city": { "type": [ "string", "null" ] }, "region": { "type": [ "string", "null" ] }, "country": { "type": [ "string", "null" ] }, "postalCode": { "type": [ "string", "null" ] }, "latitude": { "type": [ "number", "null" ] }, "longitude": { "type": [ "number", "null" ] }, "address": { "type": [ "string", "null" ] } }, "required": [ "id", "parentFacilityId", "ownerType", "ownerId", "kind", "status", "name", "code", "description", "timezone", "tags", "createdAt", "updatedAt", "addressLine1", "addressLine2", "city", "region", "country", "postalCode", "latitude", "longitude", "address" ] } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Facility not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "patchAdminOperationsFacilitiesById", "summary": "PATCH /v1/admin/operations/facilities/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "delete": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "Facility deleted", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] } }, "required": [ "success" ] } } } }, "404": { "description": "Facility not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "deleteAdminOperationsFacilitiesById", "summary": "DELETE /v1/admin/operations/facilities/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/facilities/{id}/contact-points": { "get": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "Contact points for a facility", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "entityType": { "type": "string" }, "entityId": { "type": "string" }, "kind": { "type": "string", "enum": [ "email", "phone", "mobile", "whatsapp", "website", "sms", "fax", "social", "other" ] }, "label": { "type": [ "string", "null" ] }, "value": { "type": "string" }, "normalizedValue": { "type": [ "string", "null" ] }, "isPrimary": { "type": "boolean" }, "notes": { "type": [ "string", "null" ] }, "metadata": { "type": [ "object", "null" ], "additionalProperties": {} }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "entityType", "entityId", "kind", "label", "value", "normalizedValue", "isPrimary", "notes", "metadata", "createdAt", "updatedAt" ] } } }, "required": [ "data" ] } } } } }, "operationId": "getAdminOperationsFacilitiesByIdContactPoints", "summary": "GET /v1/admin/operations/facilities/{id}/contact-points", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "post": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "email", "phone", "mobile", "whatsapp", "website", "sms", "fax", "social", "other" ] }, "label": { "type": [ "string", "null" ], "maxLength": 100 }, "value": { "type": "string", "minLength": 1, "maxLength": 500 }, "normalizedValue": { "type": [ "string", "null" ], "maxLength": 500 }, "isPrimary": { "type": "boolean", "default": false }, "notes": { "type": [ "string", "null" ] }, "metadata": { "type": [ "object", "null" ], "additionalProperties": {} } }, "required": [ "kind", "value" ] } } } }, "responses": { "201": { "description": "The created contact point", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "entityType": { "type": "string" }, "entityId": { "type": "string" }, "kind": { "type": "string", "enum": [ "email", "phone", "mobile", "whatsapp", "website", "sms", "fax", "social", "other" ] }, "label": { "type": [ "string", "null" ] }, "value": { "type": "string" }, "normalizedValue": { "type": [ "string", "null" ] }, "isPrimary": { "type": "boolean" }, "notes": { "type": [ "string", "null" ] }, "metadata": { "type": [ "object", "null" ], "additionalProperties": {} }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "entityType", "entityId", "kind", "label", "value", "normalizedValue", "isPrimary", "notes", "metadata", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Facility not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "postAdminOperationsFacilitiesByIdContactPoints", "summary": "POST /v1/admin/operations/facilities/{id}/contact-points", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/contact-points/{id}": { "patch": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "entityType": { "type": "string", "minLength": 1, "maxLength": 100 }, "entityId": { "type": "string", "minLength": 1, "maxLength": 100 }, "kind": { "type": "string", "enum": [ "email", "phone", "mobile", "whatsapp", "website", "sms", "fax", "social", "other" ] }, "label": { "type": [ "string", "null" ], "maxLength": 100 }, "value": { "type": "string", "minLength": 1, "maxLength": 500 }, "normalizedValue": { "type": [ "string", "null" ], "maxLength": 500 }, "isPrimary": { "type": "boolean", "default": false }, "notes": { "type": [ "string", "null" ] }, "metadata": { "type": [ "object", "null" ], "additionalProperties": {} } } } } } }, "responses": { "200": { "description": "The updated contact point", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "entityType": { "type": "string" }, "entityId": { "type": "string" }, "kind": { "type": "string", "enum": [ "email", "phone", "mobile", "whatsapp", "website", "sms", "fax", "social", "other" ] }, "label": { "type": [ "string", "null" ] }, "value": { "type": "string" }, "normalizedValue": { "type": [ "string", "null" ] }, "isPrimary": { "type": "boolean" }, "notes": { "type": [ "string", "null" ] }, "metadata": { "type": [ "object", "null" ], "additionalProperties": {} }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "entityType", "entityId", "kind", "label", "value", "normalizedValue", "isPrimary", "notes", "metadata", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Contact point not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "patchAdminOperationsContactPointsById", "summary": "PATCH /v1/admin/operations/contact-points/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "delete": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "Contact point deleted", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] } }, "required": [ "success" ] } } } }, "404": { "description": "Contact point not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "deleteAdminOperationsContactPointsById", "summary": "DELETE /v1/admin/operations/contact-points/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/facilities/{id}/addresses": { "get": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "Addresses for a facility", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "entityType": { "type": "string" }, "entityId": { "type": "string" }, "label": { "type": "string", "enum": [ "primary", "billing", "shipping", "mailing", "meeting", "service", "legal", "other" ] }, "fullText": { "type": [ "string", "null" ] }, "line1": { "type": [ "string", "null" ] }, "line2": { "type": [ "string", "null" ] }, "city": { "type": [ "string", "null" ] }, "region": { "type": [ "string", "null" ] }, "postalCode": { "type": [ "string", "null" ] }, "country": { "type": [ "string", "null" ] }, "latitude": { "type": [ "number", "null" ] }, "longitude": { "type": [ "number", "null" ] }, "timezone": { "type": [ "string", "null" ] }, "isPrimary": { "type": "boolean" }, "notes": { "type": [ "string", "null" ] }, "metadata": { "type": [ "object", "null" ], "additionalProperties": {} }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "entityType", "entityId", "label", "fullText", "line1", "line2", "city", "region", "postalCode", "country", "latitude", "longitude", "timezone", "isPrimary", "notes", "metadata", "createdAt", "updatedAt" ] } } }, "required": [ "data" ] } } } } }, "operationId": "getAdminOperationsFacilitiesByIdAddresses", "summary": "GET /v1/admin/operations/facilities/{id}/addresses", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "post": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "label": { "type": "string", "enum": [ "primary", "billing", "shipping", "mailing", "meeting", "service", "legal", "other" ], "default": "other" }, "fullText": { "type": [ "string", "null" ] }, "line1": { "type": [ "string", "null" ] }, "line2": { "type": [ "string", "null" ] }, "city": { "type": [ "string", "null" ] }, "region": { "type": [ "string", "null" ] }, "postalCode": { "type": [ "string", "null" ] }, "country": { "type": [ "string", "null" ] }, "latitude": { "type": [ "number", "null" ] }, "longitude": { "type": [ "number", "null" ] }, "timezone": { "type": [ "string", "null" ], "maxLength": 100 }, "isPrimary": { "type": "boolean", "default": false }, "notes": { "type": [ "string", "null" ] }, "metadata": { "type": [ "object", "null" ], "additionalProperties": {} } } } } } }, "responses": { "201": { "description": "The created address", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "entityType": { "type": "string" }, "entityId": { "type": "string" }, "label": { "type": "string", "enum": [ "primary", "billing", "shipping", "mailing", "meeting", "service", "legal", "other" ] }, "fullText": { "type": [ "string", "null" ] }, "line1": { "type": [ "string", "null" ] }, "line2": { "type": [ "string", "null" ] }, "city": { "type": [ "string", "null" ] }, "region": { "type": [ "string", "null" ] }, "postalCode": { "type": [ "string", "null" ] }, "country": { "type": [ "string", "null" ] }, "latitude": { "type": [ "number", "null" ] }, "longitude": { "type": [ "number", "null" ] }, "timezone": { "type": [ "string", "null" ] }, "isPrimary": { "type": "boolean" }, "notes": { "type": [ "string", "null" ] }, "metadata": { "type": [ "object", "null" ], "additionalProperties": {} }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "entityType", "entityId", "label", "fullText", "line1", "line2", "city", "region", "postalCode", "country", "latitude", "longitude", "timezone", "isPrimary", "notes", "metadata", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Facility not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "postAdminOperationsFacilitiesByIdAddresses", "summary": "POST /v1/admin/operations/facilities/{id}/addresses", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/addresses/{id}": { "patch": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "entityType": { "type": "string", "minLength": 1, "maxLength": 100 }, "entityId": { "type": "string", "minLength": 1, "maxLength": 100 }, "label": { "type": "string", "enum": [ "primary", "billing", "shipping", "mailing", "meeting", "service", "legal", "other" ], "default": "other" }, "fullText": { "type": [ "string", "null" ] }, "line1": { "type": [ "string", "null" ] }, "line2": { "type": [ "string", "null" ] }, "city": { "type": [ "string", "null" ] }, "region": { "type": [ "string", "null" ] }, "postalCode": { "type": [ "string", "null" ] }, "country": { "type": [ "string", "null" ] }, "latitude": { "type": [ "number", "null" ] }, "longitude": { "type": [ "number", "null" ] }, "timezone": { "type": [ "string", "null" ], "maxLength": 100 }, "isPrimary": { "type": "boolean", "default": false }, "notes": { "type": [ "string", "null" ] }, "metadata": { "type": [ "object", "null" ], "additionalProperties": {} } } } } } }, "responses": { "200": { "description": "The updated address", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "entityType": { "type": "string" }, "entityId": { "type": "string" }, "label": { "type": "string", "enum": [ "primary", "billing", "shipping", "mailing", "meeting", "service", "legal", "other" ] }, "fullText": { "type": [ "string", "null" ] }, "line1": { "type": [ "string", "null" ] }, "line2": { "type": [ "string", "null" ] }, "city": { "type": [ "string", "null" ] }, "region": { "type": [ "string", "null" ] }, "postalCode": { "type": [ "string", "null" ] }, "country": { "type": [ "string", "null" ] }, "latitude": { "type": [ "number", "null" ] }, "longitude": { "type": [ "number", "null" ] }, "timezone": { "type": [ "string", "null" ] }, "isPrimary": { "type": "boolean" }, "notes": { "type": [ "string", "null" ] }, "metadata": { "type": [ "object", "null" ], "additionalProperties": {} }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "entityType", "entityId", "label", "fullText", "line1", "line2", "city", "region", "postalCode", "country", "latitude", "longitude", "timezone", "isPrimary", "notes", "metadata", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Address not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "patchAdminOperationsAddressesById", "summary": "PATCH /v1/admin/operations/addresses/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "delete": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "Address deleted", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] } }, "required": [ "success" ] } } } }, "404": { "description": "Address not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "deleteAdminOperationsAddressesById", "summary": "DELETE /v1/admin/operations/addresses/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/facility-contacts": { "get": { "parameters": [ { "schema": { "type": "integer", "minimum": 1, "maximum": 200, "default": 50 }, "required": false, "name": "limit", "in": "query" }, { "schema": { "type": [ "integer", "null" ], "minimum": 0, "default": 0 }, "required": false, "name": "offset", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "facilityId", "in": "query" }, { "schema": { "type": "string", "enum": [ "general", "reservations", "operations", "front_desk", "sales", "emergency", "other" ] }, "required": false, "name": "role", "in": "query" } ], "responses": { "200": { "description": "Paginated facility contacts", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "entityType": { "type": "string" }, "entityId": { "type": "string" }, "role": { "type": "string", "enum": [ "general", "primary", "reservations", "operations", "front_desk", "sales", "emergency", "accounting", "legal", "other" ] }, "name": { "type": "string" }, "title": { "type": [ "string", "null" ] }, "email": { "type": [ "string", "null" ] }, "phone": { "type": [ "string", "null" ] }, "isPrimary": { "type": "boolean" }, "notes": { "type": [ "string", "null" ] }, "metadata": { "type": [ "object", "null" ], "additionalProperties": {} }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "entityType", "entityId", "role", "name", "title", "email", "phone", "isPrimary", "notes", "metadata", "createdAt", "updatedAt" ] } }, "total": { "type": "integer" }, "limit": { "type": "integer" }, "offset": { "type": "integer" } }, "required": [ "data", "total", "limit", "offset" ] } } } } }, "operationId": "getAdminOperationsFacilityContacts", "summary": "GET /v1/admin/operations/facility-contacts", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/facilities/{id}/contacts": { "post": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "role": { "type": "string", "enum": [ "general", "reservations", "operations", "front_desk", "sales", "emergency", "other" ], "default": "general" }, "name": { "type": "string", "minLength": 1, "maxLength": 255 }, "email": { "type": [ "string", "null" ], "format": "email" }, "phone": { "type": [ "string", "null" ], "maxLength": 50 }, "notes": { "type": [ "string", "null" ] }, "isPrimary": { "type": "boolean", "default": false } }, "required": [ "name" ] } } } }, "responses": { "201": { "description": "The created facility contact", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "entityType": { "type": "string" }, "entityId": { "type": "string" }, "role": { "type": "string", "enum": [ "general", "primary", "reservations", "operations", "front_desk", "sales", "emergency", "accounting", "legal", "other" ] }, "name": { "type": "string" }, "title": { "type": [ "string", "null" ] }, "email": { "type": [ "string", "null" ] }, "phone": { "type": [ "string", "null" ] }, "isPrimary": { "type": "boolean" }, "notes": { "type": [ "string", "null" ] }, "metadata": { "type": [ "object", "null" ], "additionalProperties": {} }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "entityType", "entityId", "role", "name", "title", "email", "phone", "isPrimary", "notes", "metadata", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Facility not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "postAdminOperationsFacilitiesByIdContacts", "summary": "POST /v1/admin/operations/facilities/{id}/contacts", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/facility-contacts/{id}": { "patch": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "role": { "type": "string", "enum": [ "general", "reservations", "operations", "front_desk", "sales", "emergency", "other" ], "default": "general" }, "name": { "type": "string", "minLength": 1, "maxLength": 255 }, "email": { "type": [ "string", "null" ], "format": "email" }, "phone": { "type": [ "string", "null" ], "maxLength": 50 }, "notes": { "type": [ "string", "null" ] }, "isPrimary": { "type": "boolean", "default": false } } } } } }, "responses": { "200": { "description": "The updated facility contact", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "entityType": { "type": "string" }, "entityId": { "type": "string" }, "role": { "type": "string", "enum": [ "general", "primary", "reservations", "operations", "front_desk", "sales", "emergency", "accounting", "legal", "other" ] }, "name": { "type": "string" }, "title": { "type": [ "string", "null" ] }, "email": { "type": [ "string", "null" ] }, "phone": { "type": [ "string", "null" ] }, "isPrimary": { "type": "boolean" }, "notes": { "type": [ "string", "null" ] }, "metadata": { "type": [ "object", "null" ], "additionalProperties": {} }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "entityType", "entityId", "role", "name", "title", "email", "phone", "isPrimary", "notes", "metadata", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Facility contact not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "patchAdminOperationsFacilityContactsById", "summary": "PATCH /v1/admin/operations/facility-contacts/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "delete": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "Facility contact deleted", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] } }, "required": [ "success" ] } } } }, "404": { "description": "Facility contact not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "deleteAdminOperationsFacilityContactsById", "summary": "DELETE /v1/admin/operations/facility-contacts/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/facility-features": { "get": { "parameters": [ { "schema": { "type": "integer", "minimum": 1, "maximum": 200, "default": 50 }, "required": false, "name": "limit", "in": "query" }, { "schema": { "type": [ "integer", "null" ], "minimum": 0, "default": 0 }, "required": false, "name": "offset", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "facilityId", "in": "query" }, { "schema": { "type": "string", "enum": [ "amenity", "accessibility", "security", "service", "policy", "other" ] }, "required": false, "name": "category", "in": "query" } ], "responses": { "200": { "description": "Paginated facility features", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "facilityId": { "type": "string" }, "category": { "type": "string", "enum": [ "amenity", "accessibility", "security", "service", "policy", "other" ] }, "code": { "type": [ "string", "null" ] }, "name": { "type": "string" }, "description": { "type": [ "string", "null" ] }, "valueText": { "type": [ "string", "null" ] }, "highlighted": { "type": "boolean" }, "sortOrder": { "type": "integer" }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "facilityId", "category", "code", "name", "description", "valueText", "highlighted", "sortOrder", "createdAt", "updatedAt" ] } }, "total": { "type": "integer" }, "limit": { "type": "integer" }, "offset": { "type": "integer" } }, "required": [ "data", "total", "limit", "offset" ] } } } } }, "operationId": "getAdminOperationsFacilityFeatures", "summary": "GET /v1/admin/operations/facility-features", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/facilities/{id}/features": { "post": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "category": { "type": "string", "enum": [ "amenity", "accessibility", "security", "service", "policy", "other" ], "default": "amenity" }, "code": { "type": [ "string", "null" ], "maxLength": 100 }, "name": { "type": "string", "minLength": 1, "maxLength": 255 }, "description": { "type": [ "string", "null" ] }, "valueText": { "type": [ "string", "null" ] }, "highlighted": { "type": "boolean", "default": false }, "sortOrder": { "type": "integer", "default": 0 } }, "required": [ "name" ] } } } }, "responses": { "201": { "description": "The created facility feature", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "facilityId": { "type": "string" }, "category": { "type": "string", "enum": [ "amenity", "accessibility", "security", "service", "policy", "other" ] }, "code": { "type": [ "string", "null" ] }, "name": { "type": "string" }, "description": { "type": [ "string", "null" ] }, "valueText": { "type": [ "string", "null" ] }, "highlighted": { "type": "boolean" }, "sortOrder": { "type": "integer" }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "facilityId", "category", "code", "name", "description", "valueText", "highlighted", "sortOrder", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Facility not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "postAdminOperationsFacilitiesByIdFeatures", "summary": "POST /v1/admin/operations/facilities/{id}/features", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/facility-features/{id}": { "patch": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "category": { "type": "string", "enum": [ "amenity", "accessibility", "security", "service", "policy", "other" ], "default": "amenity" }, "code": { "type": [ "string", "null" ], "maxLength": 100 }, "name": { "type": "string", "minLength": 1, "maxLength": 255 }, "description": { "type": [ "string", "null" ] }, "valueText": { "type": [ "string", "null" ] }, "highlighted": { "type": "boolean", "default": false }, "sortOrder": { "type": "integer", "default": 0 } } } } } }, "responses": { "200": { "description": "The updated facility feature", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "facilityId": { "type": "string" }, "category": { "type": "string", "enum": [ "amenity", "accessibility", "security", "service", "policy", "other" ] }, "code": { "type": [ "string", "null" ] }, "name": { "type": "string" }, "description": { "type": [ "string", "null" ] }, "valueText": { "type": [ "string", "null" ] }, "highlighted": { "type": "boolean" }, "sortOrder": { "type": "integer" }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "facilityId", "category", "code", "name", "description", "valueText", "highlighted", "sortOrder", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Facility feature not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "patchAdminOperationsFacilityFeaturesById", "summary": "PATCH /v1/admin/operations/facility-features/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "delete": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "Facility feature deleted", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] } }, "required": [ "success" ] } } } }, "404": { "description": "Facility feature not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "deleteAdminOperationsFacilityFeaturesById", "summary": "DELETE /v1/admin/operations/facility-features/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/facility-operation-schedules": { "get": { "parameters": [ { "schema": { "type": "integer", "minimum": 1, "maximum": 200, "default": 50 }, "required": false, "name": "limit", "in": "query" }, { "schema": { "type": [ "integer", "null" ], "minimum": 0, "default": 0 }, "required": false, "name": "offset", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "facilityId", "in": "query" }, { "schema": { "type": "string", "enum": [ "monday", "tuesday", "wednesday", "thursday", "friday", "saturday", "sunday" ] }, "required": false, "name": "dayOfWeek", "in": "query" } ], "responses": { "200": { "description": "Paginated facility operation schedules", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "facilityId": { "type": "string" }, "dayOfWeek": { "type": [ "string", "null" ], "enum": [ "monday", "tuesday", "wednesday", "thursday", "friday", "saturday", "sunday", null ] }, "validFrom": { "type": [ "string", "null" ] }, "validTo": { "type": [ "string", "null" ] }, "opensAt": { "type": [ "string", "null" ] }, "closesAt": { "type": [ "string", "null" ] }, "closed": { "type": "boolean" }, "notes": { "type": [ "string", "null" ] }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "facilityId", "dayOfWeek", "validFrom", "validTo", "opensAt", "closesAt", "closed", "notes", "createdAt", "updatedAt" ] } }, "total": { "type": "integer" }, "limit": { "type": "integer" }, "offset": { "type": "integer" } }, "required": [ "data", "total", "limit", "offset" ] } } } } }, "operationId": "getAdminOperationsFacilityOperationSchedules", "summary": "GET /v1/admin/operations/facility-operation-schedules", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/facilities/{id}/operation-schedules": { "post": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "dayOfWeek": { "type": [ "string", "null" ], "enum": [ "monday", "tuesday", "wednesday", "thursday", "friday", "saturday", "sunday", null ] }, "validFrom": { "type": [ "string", "null" ], "format": "date" }, "validTo": { "type": [ "string", "null" ], "format": "date" }, "opensAt": { "type": [ "string", "null" ] }, "closesAt": { "type": [ "string", "null" ] }, "closed": { "type": "boolean", "default": false }, "notes": { "type": [ "string", "null" ] } } } } } }, "responses": { "201": { "description": "The created facility operation schedule", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "facilityId": { "type": "string" }, "dayOfWeek": { "type": [ "string", "null" ], "enum": [ "monday", "tuesday", "wednesday", "thursday", "friday", "saturday", "sunday", null ] }, "validFrom": { "type": [ "string", "null" ] }, "validTo": { "type": [ "string", "null" ] }, "opensAt": { "type": [ "string", "null" ] }, "closesAt": { "type": [ "string", "null" ] }, "closed": { "type": "boolean" }, "notes": { "type": [ "string", "null" ] }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "facilityId", "dayOfWeek", "validFrom", "validTo", "opensAt", "closesAt", "closed", "notes", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Facility not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "postAdminOperationsFacilitiesByIdOperationSchedules", "summary": "POST /v1/admin/operations/facilities/{id}/operation-schedules", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/facility-operation-schedules/{id}": { "patch": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "dayOfWeek": { "type": [ "string", "null" ], "enum": [ "monday", "tuesday", "wednesday", "thursday", "friday", "saturday", "sunday", null ] }, "validFrom": { "type": [ "string", "null" ], "format": "date" }, "validTo": { "type": [ "string", "null" ], "format": "date" }, "opensAt": { "type": [ "string", "null" ] }, "closesAt": { "type": [ "string", "null" ] }, "closed": { "type": "boolean", "default": false }, "notes": { "type": [ "string", "null" ] } } } } } }, "responses": { "200": { "description": "The updated facility operation schedule", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "facilityId": { "type": "string" }, "dayOfWeek": { "type": [ "string", "null" ], "enum": [ "monday", "tuesday", "wednesday", "thursday", "friday", "saturday", "sunday", null ] }, "validFrom": { "type": [ "string", "null" ] }, "validTo": { "type": [ "string", "null" ] }, "opensAt": { "type": [ "string", "null" ] }, "closesAt": { "type": [ "string", "null" ] }, "closed": { "type": "boolean" }, "notes": { "type": [ "string", "null" ] }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "facilityId", "dayOfWeek", "validFrom", "validTo", "opensAt", "closesAt", "closed", "notes", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Facility operation schedule not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "patchAdminOperationsFacilityOperationSchedulesById", "summary": "PATCH /v1/admin/operations/facility-operation-schedules/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "delete": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "Facility operation schedule deleted", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] } }, "required": [ "success" ] } } } }, "404": { "description": "Facility operation schedule not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "deleteAdminOperationsFacilityOperationSchedulesById", "summary": "DELETE /v1/admin/operations/facility-operation-schedules/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/properties": { "get": { "parameters": [ { "schema": { "type": "integer", "minimum": 1, "maximum": 200, "default": 50 }, "required": false, "name": "limit", "in": "query" }, { "schema": { "type": [ "integer", "null" ], "minimum": 0, "default": 0 }, "required": false, "name": "offset", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "facilityId", "in": "query" }, { "schema": { "type": "string", "enum": [ "hotel", "resort", "villa", "apartment", "hostel", "lodge", "camp", "other" ] }, "required": false, "name": "propertyType", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "groupName", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "search", "in": "query" } ], "responses": { "200": { "description": "Paginated properties", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "facilityId": { "type": "string" }, "propertyType": { "type": "string", "enum": [ "hotel", "resort", "villa", "apartment", "hostel", "lodge", "camp", "other" ] }, "brandName": { "type": [ "string", "null" ] }, "groupName": { "type": [ "string", "null" ] }, "rating": { "type": [ "integer", "null" ] }, "ratingScale": { "type": [ "integer", "null" ] }, "checkInTime": { "type": [ "string", "null" ] }, "checkOutTime": { "type": [ "string", "null" ] }, "policyNotes": { "type": [ "string", "null" ] }, "amenityNotes": { "type": [ "string", "null" ] }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "facilityId", "propertyType", "brandName", "groupName", "rating", "ratingScale", "checkInTime", "checkOutTime", "policyNotes", "amenityNotes", "createdAt", "updatedAt" ] } }, "total": { "type": "integer" }, "limit": { "type": "integer" }, "offset": { "type": "integer" } }, "required": [ "data", "total", "limit", "offset" ] } } } } }, "operationId": "getAdminOperationsProperties", "summary": "GET /v1/admin/operations/properties", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "post": { "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "facilityId": { "type": "string" }, "propertyType": { "type": "string", "enum": [ "hotel", "resort", "villa", "apartment", "hostel", "lodge", "camp", "other" ], "default": "hotel" }, "brandName": { "type": [ "string", "null" ] }, "groupName": { "type": [ "string", "null" ] }, "rating": { "type": [ "integer", "null" ], "minimum": 0, "maximum": 10 }, "ratingScale": { "type": [ "integer", "null" ], "minimum": 1, "maximum": 10 }, "checkInTime": { "type": [ "string", "null" ] }, "checkOutTime": { "type": [ "string", "null" ] }, "policyNotes": { "type": [ "string", "null" ] }, "amenityNotes": { "type": [ "string", "null" ] } }, "required": [ "facilityId" ] } } } }, "responses": { "201": { "description": "The created property", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "facilityId": { "type": "string" }, "propertyType": { "type": "string", "enum": [ "hotel", "resort", "villa", "apartment", "hostel", "lodge", "camp", "other" ] }, "brandName": { "type": [ "string", "null" ] }, "groupName": { "type": [ "string", "null" ] }, "rating": { "type": [ "integer", "null" ] }, "ratingScale": { "type": [ "integer", "null" ] }, "checkInTime": { "type": [ "string", "null" ] }, "checkOutTime": { "type": [ "string", "null" ] }, "policyNotes": { "type": [ "string", "null" ] }, "amenityNotes": { "type": [ "string", "null" ] }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "facilityId", "propertyType", "brandName", "groupName", "rating", "ratingScale", "checkInTime", "checkOutTime", "policyNotes", "amenityNotes", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Facility not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "postAdminOperationsProperties", "summary": "POST /v1/admin/operations/properties", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/properties/{id}": { "get": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "A property by id", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "facilityId": { "type": "string" }, "propertyType": { "type": "string", "enum": [ "hotel", "resort", "villa", "apartment", "hostel", "lodge", "camp", "other" ] }, "brandName": { "type": [ "string", "null" ] }, "groupName": { "type": [ "string", "null" ] }, "rating": { "type": [ "integer", "null" ] }, "ratingScale": { "type": [ "integer", "null" ] }, "checkInTime": { "type": [ "string", "null" ] }, "checkOutTime": { "type": [ "string", "null" ] }, "policyNotes": { "type": [ "string", "null" ] }, "amenityNotes": { "type": [ "string", "null" ] }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "facilityId", "propertyType", "brandName", "groupName", "rating", "ratingScale", "checkInTime", "checkOutTime", "policyNotes", "amenityNotes", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "404": { "description": "Property not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "getAdminOperationsPropertiesById", "summary": "GET /v1/admin/operations/properties/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "patch": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "facilityId": { "type": "string" }, "propertyType": { "type": "string", "enum": [ "hotel", "resort", "villa", "apartment", "hostel", "lodge", "camp", "other" ], "default": "hotel" }, "brandName": { "type": [ "string", "null" ] }, "groupName": { "type": [ "string", "null" ] }, "rating": { "type": [ "integer", "null" ], "minimum": 0, "maximum": 10 }, "ratingScale": { "type": [ "integer", "null" ], "minimum": 1, "maximum": 10 }, "checkInTime": { "type": [ "string", "null" ] }, "checkOutTime": { "type": [ "string", "null" ] }, "policyNotes": { "type": [ "string", "null" ] }, "amenityNotes": { "type": [ "string", "null" ] } } } } } }, "responses": { "200": { "description": "The updated property", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "facilityId": { "type": "string" }, "propertyType": { "type": "string", "enum": [ "hotel", "resort", "villa", "apartment", "hostel", "lodge", "camp", "other" ] }, "brandName": { "type": [ "string", "null" ] }, "groupName": { "type": [ "string", "null" ] }, "rating": { "type": [ "integer", "null" ] }, "ratingScale": { "type": [ "integer", "null" ] }, "checkInTime": { "type": [ "string", "null" ] }, "checkOutTime": { "type": [ "string", "null" ] }, "policyNotes": { "type": [ "string", "null" ] }, "amenityNotes": { "type": [ "string", "null" ] }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "facilityId", "propertyType", "brandName", "groupName", "rating", "ratingScale", "checkInTime", "checkOutTime", "policyNotes", "amenityNotes", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Property not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "patchAdminOperationsPropertiesById", "summary": "PATCH /v1/admin/operations/properties/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "delete": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "Property deleted", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] } }, "required": [ "success" ] } } } }, "404": { "description": "Property not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "deleteAdminOperationsPropertiesById", "summary": "DELETE /v1/admin/operations/properties/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/property-groups": { "get": { "parameters": [ { "schema": { "type": "integer", "minimum": 1, "maximum": 200, "default": 50 }, "required": false, "name": "limit", "in": "query" }, { "schema": { "type": [ "integer", "null" ], "minimum": 0, "default": 0 }, "required": false, "name": "offset", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "parentGroupId", "in": "query" }, { "schema": { "type": "string", "enum": [ "chain", "brand", "management_company", "collection", "portfolio", "cluster", "other" ] }, "required": false, "name": "groupType", "in": "query" }, { "schema": { "type": "string", "enum": [ "active", "inactive", "archived" ] }, "required": false, "name": "status", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "search", "in": "query" } ], "responses": { "200": { "description": "Paginated property groups", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "parentGroupId": { "type": [ "string", "null" ] }, "groupType": { "type": "string", "enum": [ "chain", "brand", "management_company", "collection", "portfolio", "cluster", "other" ] }, "status": { "type": "string", "enum": [ "active", "inactive", "archived" ] }, "name": { "type": "string" }, "code": { "type": [ "string", "null" ] }, "brandName": { "type": [ "string", "null" ] }, "legalName": { "type": [ "string", "null" ] }, "website": { "type": [ "string", "null" ] }, "notes": { "type": [ "string", "null" ] }, "metadata": { "type": [ "object", "null" ], "additionalProperties": {} }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "parentGroupId", "groupType", "status", "name", "code", "brandName", "legalName", "website", "notes", "metadata", "createdAt", "updatedAt" ] } }, "total": { "type": "integer" }, "limit": { "type": "integer" }, "offset": { "type": "integer" } }, "required": [ "data", "total", "limit", "offset" ] } } } } }, "operationId": "getAdminOperationsPropertyGroups", "summary": "GET /v1/admin/operations/property-groups", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "post": { "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "parentGroupId": { "type": [ "string", "null" ] }, "groupType": { "type": "string", "enum": [ "chain", "brand", "management_company", "collection", "portfolio", "cluster", "other" ], "default": "chain" }, "status": { "type": "string", "enum": [ "active", "inactive", "archived" ], "default": "active" }, "name": { "type": "string", "minLength": 1, "maxLength": 255 }, "code": { "type": [ "string", "null" ], "maxLength": 100 }, "brandName": { "type": [ "string", "null" ] }, "legalName": { "type": [ "string", "null" ] }, "website": { "type": [ "string", "null" ], "format": "uri" }, "notes": { "type": [ "string", "null" ] }, "metadata": { "type": [ "object", "null" ], "additionalProperties": {} } }, "required": [ "name" ] } } } }, "responses": { "201": { "description": "The created property group", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "parentGroupId": { "type": [ "string", "null" ] }, "groupType": { "type": "string", "enum": [ "chain", "brand", "management_company", "collection", "portfolio", "cluster", "other" ] }, "status": { "type": "string", "enum": [ "active", "inactive", "archived" ] }, "name": { "type": "string" }, "code": { "type": [ "string", "null" ] }, "brandName": { "type": [ "string", "null" ] }, "legalName": { "type": [ "string", "null" ] }, "website": { "type": [ "string", "null" ] }, "notes": { "type": [ "string", "null" ] }, "metadata": { "type": [ "object", "null" ], "additionalProperties": {} }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "parentGroupId", "groupType", "status", "name", "code", "brandName", "legalName", "website", "notes", "metadata", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "postAdminOperationsPropertyGroups", "summary": "POST /v1/admin/operations/property-groups", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/property-groups/{id}": { "get": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "A property group by id", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "parentGroupId": { "type": [ "string", "null" ] }, "groupType": { "type": "string", "enum": [ "chain", "brand", "management_company", "collection", "portfolio", "cluster", "other" ] }, "status": { "type": "string", "enum": [ "active", "inactive", "archived" ] }, "name": { "type": "string" }, "code": { "type": [ "string", "null" ] }, "brandName": { "type": [ "string", "null" ] }, "legalName": { "type": [ "string", "null" ] }, "website": { "type": [ "string", "null" ] }, "notes": { "type": [ "string", "null" ] }, "metadata": { "type": [ "object", "null" ], "additionalProperties": {} }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "parentGroupId", "groupType", "status", "name", "code", "brandName", "legalName", "website", "notes", "metadata", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "404": { "description": "Property group not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "getAdminOperationsPropertyGroupsById", "summary": "GET /v1/admin/operations/property-groups/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "patch": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "parentGroupId": { "type": [ "string", "null" ] }, "groupType": { "type": "string", "enum": [ "chain", "brand", "management_company", "collection", "portfolio", "cluster", "other" ], "default": "chain" }, "status": { "type": "string", "enum": [ "active", "inactive", "archived" ], "default": "active" }, "name": { "type": "string", "minLength": 1, "maxLength": 255 }, "code": { "type": [ "string", "null" ], "maxLength": 100 }, "brandName": { "type": [ "string", "null" ] }, "legalName": { "type": [ "string", "null" ] }, "website": { "type": [ "string", "null" ], "format": "uri" }, "notes": { "type": [ "string", "null" ] }, "metadata": { "type": [ "object", "null" ], "additionalProperties": {} } } } } } }, "responses": { "200": { "description": "The updated property group", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "parentGroupId": { "type": [ "string", "null" ] }, "groupType": { "type": "string", "enum": [ "chain", "brand", "management_company", "collection", "portfolio", "cluster", "other" ] }, "status": { "type": "string", "enum": [ "active", "inactive", "archived" ] }, "name": { "type": "string" }, "code": { "type": [ "string", "null" ] }, "brandName": { "type": [ "string", "null" ] }, "legalName": { "type": [ "string", "null" ] }, "website": { "type": [ "string", "null" ] }, "notes": { "type": [ "string", "null" ] }, "metadata": { "type": [ "object", "null" ], "additionalProperties": {} }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "parentGroupId", "groupType", "status", "name", "code", "brandName", "legalName", "website", "notes", "metadata", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Property group not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "patchAdminOperationsPropertyGroupsById", "summary": "PATCH /v1/admin/operations/property-groups/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "delete": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "Property group deleted", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] } }, "required": [ "success" ] } } } }, "404": { "description": "Property group not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "deleteAdminOperationsPropertyGroupsById", "summary": "DELETE /v1/admin/operations/property-groups/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/property-group-members": { "get": { "parameters": [ { "schema": { "type": "integer", "minimum": 1, "maximum": 200, "default": 50 }, "required": false, "name": "limit", "in": "query" }, { "schema": { "type": [ "integer", "null" ], "minimum": 0, "default": 0 }, "required": false, "name": "offset", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "groupId", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "propertyId", "in": "query" }, { "schema": { "type": "string", "enum": [ "member", "flagship", "managed", "franchise", "other" ] }, "required": false, "name": "membershipRole", "in": "query" } ], "responses": { "200": { "description": "Paginated property group members", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "groupId": { "type": "string" }, "propertyId": { "type": "string" }, "membershipRole": { "type": "string", "enum": [ "member", "flagship", "managed", "franchise", "other" ] }, "isPrimary": { "type": "boolean" }, "validFrom": { "type": [ "string", "null" ] }, "validTo": { "type": [ "string", "null" ] }, "notes": { "type": [ "string", "null" ] }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "groupId", "propertyId", "membershipRole", "isPrimary", "validFrom", "validTo", "notes", "createdAt", "updatedAt" ] } }, "total": { "type": "integer" }, "limit": { "type": "integer" }, "offset": { "type": "integer" } }, "required": [ "data", "total", "limit", "offset" ] } } } } }, "operationId": "getAdminOperationsPropertyGroupMembers", "summary": "GET /v1/admin/operations/property-group-members", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "post": { "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "groupId": { "type": "string" }, "propertyId": { "type": "string" }, "membershipRole": { "type": "string", "enum": [ "member", "flagship", "managed", "franchise", "other" ], "default": "member" }, "isPrimary": { "type": "boolean", "default": false }, "validFrom": { "type": [ "string", "null" ], "format": "date" }, "validTo": { "type": [ "string", "null" ], "format": "date" }, "notes": { "type": [ "string", "null" ] } }, "required": [ "groupId", "propertyId" ] } } } }, "responses": { "201": { "description": "The created property group member", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "groupId": { "type": "string" }, "propertyId": { "type": "string" }, "membershipRole": { "type": "string", "enum": [ "member", "flagship", "managed", "franchise", "other" ] }, "isPrimary": { "type": "boolean" }, "validFrom": { "type": [ "string", "null" ] }, "validTo": { "type": [ "string", "null" ] }, "notes": { "type": [ "string", "null" ] }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "groupId", "propertyId", "membershipRole", "isPrimary", "validFrom", "validTo", "notes", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Property group or property not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "postAdminOperationsPropertyGroupMembers", "summary": "POST /v1/admin/operations/property-group-members", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/property-group-members/{id}": { "get": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "A property group member by id", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "groupId": { "type": "string" }, "propertyId": { "type": "string" }, "membershipRole": { "type": "string", "enum": [ "member", "flagship", "managed", "franchise", "other" ] }, "isPrimary": { "type": "boolean" }, "validFrom": { "type": [ "string", "null" ] }, "validTo": { "type": [ "string", "null" ] }, "notes": { "type": [ "string", "null" ] }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "groupId", "propertyId", "membershipRole", "isPrimary", "validFrom", "validTo", "notes", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "404": { "description": "Property group member not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "getAdminOperationsPropertyGroupMembersById", "summary": "GET /v1/admin/operations/property-group-members/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "patch": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "groupId": { "type": "string" }, "propertyId": { "type": "string" }, "membershipRole": { "type": "string", "enum": [ "member", "flagship", "managed", "franchise", "other" ], "default": "member" }, "isPrimary": { "type": "boolean", "default": false }, "validFrom": { "type": [ "string", "null" ], "format": "date" }, "validTo": { "type": [ "string", "null" ], "format": "date" }, "notes": { "type": [ "string", "null" ] } } } } } }, "responses": { "200": { "description": "The updated property group member", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "groupId": { "type": "string" }, "propertyId": { "type": "string" }, "membershipRole": { "type": "string", "enum": [ "member", "flagship", "managed", "franchise", "other" ] }, "isPrimary": { "type": "boolean" }, "validFrom": { "type": [ "string", "null" ] }, "validTo": { "type": [ "string", "null" ] }, "notes": { "type": [ "string", "null" ] }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "groupId", "propertyId", "membershipRole", "isPrimary", "validFrom", "validTo", "notes", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Property group member not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "patchAdminOperationsPropertyGroupMembersById", "summary": "PATCH /v1/admin/operations/property-group-members/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "delete": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "Property group member deleted", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ] } }, "required": [ "success" ] } } } }, "404": { "description": "Property group member not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "deleteAdminOperationsPropertyGroupMembersById", "summary": "DELETE /v1/admin/operations/property-group-members/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/function-spaces": { "get": { "parameters": [ { "schema": { "type": "string", "minLength": 1 }, "required": false, "name": "facilityId", "in": "query" }, { "schema": { "type": "string", "minLength": 1 }, "required": false, "name": "parentSpaceId", "in": "query" }, { "schema": { "type": "integer", "minimum": 1, "maximum": 200, "default": 50 }, "required": false, "name": "limit", "in": "query" }, { "schema": { "type": [ "integer", "null" ], "minimum": 0, "default": 0 }, "required": false, "name": "offset", "in": "query" } ], "responses": { "200": { "description": "Function spaces (offset-paginated; no total)", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "facilityId": { "type": "string" }, "parentSpaceId": { "type": [ "string", "null" ] }, "name": { "type": "string" }, "code": { "type": [ "string", "null" ] }, "description": { "type": [ "string", "null" ] }, "areaSqm": { "type": [ "number", "null" ] }, "divisible": { "type": "boolean" }, "defaultLayout": { "type": [ "string", "null" ], "enum": [ "theater", "classroom", "banquet", "cabaret", "boardroom", "u_shape", "reception", "hollow_square", null ] }, "active": { "type": "boolean" }, "sortOrder": { "type": "integer" }, "metadata": { "type": [ "object", "null" ], "additionalProperties": {} }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "facilityId", "parentSpaceId", "name", "code", "description", "areaSqm", "divisible", "defaultLayout", "active", "sortOrder", "metadata", "createdAt", "updatedAt" ] } }, "limit": { "type": "integer" }, "offset": { "type": "integer" } }, "required": [ "data", "limit", "offset" ] } } } } }, "operationId": "getAdminOperationsFunctionSpaces", "summary": "GET /v1/admin/operations/function-spaces", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "post": { "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "facilityId": { "type": "string", "minLength": 1 }, "name": { "type": "string", "minLength": 1 }, "parentSpaceId": { "type": "string", "minLength": 1 }, "code": { "type": "string" }, "description": { "type": "string" }, "areaSqm": { "type": "number", "exclusiveMinimum": 0 }, "divisible": { "type": "boolean" }, "defaultLayout": { "type": "string", "enum": [ "theater", "classroom", "banquet", "cabaret", "boardroom", "u_shape", "reception", "hollow_square" ] }, "sortOrder": { "type": "integer", "minimum": 0 } }, "required": [ "facilityId", "name" ] } } } }, "responses": { "201": { "description": "The created function space", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "facilityId": { "type": "string" }, "parentSpaceId": { "type": [ "string", "null" ] }, "name": { "type": "string" }, "code": { "type": [ "string", "null" ] }, "description": { "type": [ "string", "null" ] }, "areaSqm": { "type": [ "number", "null" ] }, "divisible": { "type": "boolean" }, "defaultLayout": { "type": [ "string", "null" ], "enum": [ "theater", "classroom", "banquet", "cabaret", "boardroom", "u_shape", "reception", "hollow_square", null ] }, "active": { "type": "boolean" }, "sortOrder": { "type": "integer" }, "metadata": { "type": [ "object", "null" ], "additionalProperties": {} }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "facilityId", "parentSpaceId", "name", "code", "description", "areaSqm", "divisible", "defaultLayout", "active", "sortOrder", "metadata", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Facility or parent space not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "postAdminOperationsFunctionSpaces", "summary": "POST /v1/admin/operations/function-spaces", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/function-spaces/{id}": { "get": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "A function space with its capacity matrix", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "facilityId": { "type": "string" }, "parentSpaceId": { "type": [ "string", "null" ] }, "name": { "type": "string" }, "code": { "type": [ "string", "null" ] }, "description": { "type": [ "string", "null" ] }, "areaSqm": { "type": [ "number", "null" ] }, "divisible": { "type": "boolean" }, "defaultLayout": { "type": [ "string", "null" ], "enum": [ "theater", "classroom", "banquet", "cabaret", "boardroom", "u_shape", "reception", "hollow_square", null ] }, "active": { "type": "boolean" }, "sortOrder": { "type": "integer" }, "metadata": { "type": [ "object", "null" ], "additionalProperties": {} }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" }, "capacities": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "spaceId": { "type": "string" }, "layout": { "type": "string", "enum": [ "theater", "classroom", "banquet", "cabaret", "boardroom", "u_shape", "reception", "hollow_square" ] }, "capacity": { "type": "integer" } }, "required": [ "id", "spaceId", "layout", "capacity" ] } } }, "required": [ "id", "facilityId", "parentSpaceId", "name", "code", "description", "areaSqm", "divisible", "defaultLayout", "active", "sortOrder", "metadata", "createdAt", "updatedAt", "capacities" ] } }, "required": [ "data" ] } } } }, "404": { "description": "Function space not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "getAdminOperationsFunctionSpacesById", "summary": "GET /v1/admin/operations/function-spaces/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" }, "patch": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "facilityId": { "type": "string", "minLength": 1 }, "name": { "type": "string", "minLength": 1 }, "parentSpaceId": { "type": "string", "minLength": 1 }, "code": { "type": "string" }, "description": { "type": "string" }, "areaSqm": { "type": "number", "exclusiveMinimum": 0 }, "divisible": { "type": "boolean" }, "defaultLayout": { "type": "string", "enum": [ "theater", "classroom", "banquet", "cabaret", "boardroom", "u_shape", "reception", "hollow_square" ] }, "sortOrder": { "type": "integer", "minimum": 0 }, "active": { "type": "boolean" } } } } } }, "responses": { "200": { "description": "The updated function space", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "facilityId": { "type": "string" }, "parentSpaceId": { "type": [ "string", "null" ] }, "name": { "type": "string" }, "code": { "type": [ "string", "null" ] }, "description": { "type": [ "string", "null" ] }, "areaSqm": { "type": [ "number", "null" ] }, "divisible": { "type": "boolean" }, "defaultLayout": { "type": [ "string", "null" ], "enum": [ "theater", "classroom", "banquet", "cabaret", "boardroom", "u_shape", "reception", "hollow_square", null ] }, "active": { "type": "boolean" }, "sortOrder": { "type": "integer" }, "metadata": { "type": [ "object", "null" ], "additionalProperties": {} }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "facilityId", "parentSpaceId", "name", "code", "description", "areaSqm", "divisible", "defaultLayout", "active", "sortOrder", "metadata", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Function space not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "patchAdminOperationsFunctionSpacesById", "summary": "PATCH /v1/admin/operations/function-spaces/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/function-spaces/{id}/capacities": { "put": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "capacities": { "type": "array", "items": { "type": "object", "properties": { "layout": { "type": "string", "enum": [ "theater", "classroom", "banquet", "cabaret", "boardroom", "u_shape", "reception", "hollow_square" ] }, "capacity": { "type": "integer", "minimum": 0 } }, "required": [ "layout", "capacity" ] } } }, "required": [ "capacities" ] } } } }, "responses": { "200": { "description": "The replaced capacity matrix", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "spaceId": { "type": "string" }, "layout": { "type": "string", "enum": [ "theater", "classroom", "banquet", "cabaret", "boardroom", "u_shape", "reception", "hollow_square" ] }, "capacity": { "type": "integer" } }, "required": [ "id", "spaceId", "layout", "capacity" ] } } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Function space not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "putAdminOperationsFunctionSpacesByIdCapacities", "summary": "PUT /v1/admin/operations/function-spaces/{id}/capacities", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/space-blocks": { "post": { "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "functionSpaceId": { "type": "string", "minLength": 1 }, "name": { "type": "string", "minLength": 1 }, "programId": { "type": "string", "minLength": 1 }, "supplierId": { "type": "string", "minLength": 1 }, "currency": { "type": "string" }, "netRateCents": { "type": "integer", "minimum": 0 }, "sellRateCents": { "type": "integer", "minimum": 0 }, "holdStartTime": { "type": "string", "pattern": "^\\d{2}:\\d{2}$" }, "holdEndTime": { "type": "string", "pattern": "^\\d{2}:\\d{2}$" }, "optionDate": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, "cutoffDate": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, "notes": { "type": "string" } }, "required": [ "functionSpaceId", "name" ] } } } }, "responses": { "201": { "description": "The created space block", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "functionSpaceId": { "type": "string" }, "programId": { "type": [ "string", "null" ] }, "supplierId": { "type": [ "string", "null" ] }, "name": { "type": "string" }, "status": { "type": "string" }, "currency": { "type": [ "string", "null" ] }, "netRateCents": { "type": [ "integer", "null" ] }, "sellRateCents": { "type": [ "integer", "null" ] }, "holdStartTime": { "type": [ "string", "null" ] }, "holdEndTime": { "type": [ "string", "null" ] }, "optionDate": { "type": [ "string", "null" ] }, "cutoffDate": { "type": [ "string", "null" ] }, "attritionTerms": { "type": [ "object", "null" ], "additionalProperties": {} }, "notes": { "type": [ "string", "null" ] }, "metadata": { "type": [ "object", "null" ], "additionalProperties": {} }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "functionSpaceId", "programId", "supplierId", "name", "status", "currency", "netRateCents", "sellRateCents", "holdStartTime", "holdEndTime", "optionDate", "cutoffDate", "attritionTerms", "notes", "metadata", "createdAt", "updatedAt" ] } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Function space not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "postAdminOperationsSpaceBlocks", "summary": "POST /v1/admin/operations/space-blocks", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/space-blocks/{id}": { "get": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "A space block with its allotment summary", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "block": { "type": "object", "properties": { "id": { "type": "string" }, "functionSpaceId": { "type": "string" }, "programId": { "type": [ "string", "null" ] }, "supplierId": { "type": [ "string", "null" ] }, "name": { "type": "string" }, "status": { "type": "string" }, "currency": { "type": [ "string", "null" ] }, "netRateCents": { "type": [ "integer", "null" ] }, "sellRateCents": { "type": [ "integer", "null" ] }, "holdStartTime": { "type": [ "string", "null" ] }, "holdEndTime": { "type": [ "string", "null" ] }, "optionDate": { "type": [ "string", "null" ] }, "cutoffDate": { "type": [ "string", "null" ] }, "attritionTerms": { "type": [ "object", "null" ], "additionalProperties": {} }, "notes": { "type": [ "string", "null" ] }, "metadata": { "type": [ "object", "null" ], "additionalProperties": {} }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "functionSpaceId", "programId", "supplierId", "name", "status", "currency", "netRateCents", "sellRateCents", "holdStartTime", "holdEndTime", "optionDate", "cutoffDate", "attritionTerms", "notes", "metadata", "createdAt", "updatedAt" ] }, "summary": { "type": [ "object", "null" ], "properties": { "blockId": { "type": "string" }, "status": { "type": "string" }, "totalHeld": { "type": "integer" }, "totalPickedUp": { "type": "integer" }, "totalReleased": { "type": "integer" }, "totalRemaining": { "type": "integer" }, "pickupProgress": { "type": "string", "enum": [ "none", "partial", "full" ] } }, "required": [ "blockId", "status", "totalHeld", "totalPickedUp", "totalReleased", "totalRemaining", "pickupProgress" ] } }, "required": [ "block", "summary" ] } }, "required": [ "data" ] } } } }, "404": { "description": "Space block not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "getAdminOperationsSpaceBlocksById", "summary": "GET /v1/admin/operations/space-blocks/{id}", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/space-blocks/{id}/slots": { "put": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "slots": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, "unitsHeld": { "type": "integer", "minimum": 0 }, "netRateCentsOverride": { "type": "integer", "minimum": 0 }, "sellRateCentsOverride": { "type": "integer", "minimum": 0 } }, "required": [ "date", "unitsHeld" ] }, "minItems": 1 } }, "required": [ "slots" ] } } } }, "responses": { "200": { "description": "The recomputed allotment summary after setting slots", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": [ "object", "null" ], "properties": { "blockId": { "type": "string" }, "status": { "type": "string" }, "totalHeld": { "type": "integer" }, "totalPickedUp": { "type": "integer" }, "totalReleased": { "type": "integer" }, "totalRemaining": { "type": "integer" }, "pickupProgress": { "type": "string", "enum": [ "none", "partial", "full" ] } }, "required": [ "blockId", "status", "totalHeld", "totalPickedUp", "totalReleased", "totalRemaining", "pickupProgress" ] } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Space block not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "putAdminOperationsSpaceBlocksByIdSlots", "summary": "PUT /v1/admin/operations/space-blocks/{id}/slots", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/space-blocks/{id}/pickups": { "post": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "bookingId": { "type": "string", "minLength": 1 }, "sessionId": { "type": "string", "minLength": 1 }, "startDate": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, "endDate": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, "units": { "type": "integer", "minimum": 1, "default": 1 } }, "required": [ "startDate", "endDate" ] } } } }, "responses": { "200": { "description": "An idempotent no-op replay of an existing active pickup", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "blockId": { "type": "string" }, "bookingId": { "type": [ "string", "null" ] }, "sessionId": { "type": [ "string", "null" ] }, "startDate": { "type": "string" }, "endDate": { "type": "string" }, "units": { "type": "integer" }, "status": { "type": "string" }, "pickedUpAt": { "type": "string" }, "reversedAt": { "type": [ "string", "null" ] } }, "required": [ "id", "blockId", "bookingId", "sessionId", "startDate", "endDate", "units", "status", "pickedUpAt", "reversedAt" ] } }, "required": [ "data" ] } } } }, "201": { "description": "The created space-block pickup", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "blockId": { "type": "string" }, "bookingId": { "type": [ "string", "null" ] }, "sessionId": { "type": [ "string", "null" ] }, "startDate": { "type": "string" }, "endDate": { "type": "string" }, "units": { "type": "integer" }, "status": { "type": "string" }, "pickedUpAt": { "type": "string" }, "reversedAt": { "type": [ "string", "null" ] } }, "required": [ "id", "blockId", "bookingId", "sessionId", "startDate", "endDate", "units", "status", "pickedUpAt", "reversedAt" ] } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request or invalid start/end range", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Space block not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } }, "409": { "description": "Block no longer accepting pickups, session conflict, or insufficient inventory", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "detail": { "type": "object", "properties": { "date": { "type": "string" }, "remaining": { "type": "integer" }, "needed": { "type": "integer" } }, "required": [ "date", "remaining", "needed" ] } }, "required": [ "error" ] } } } } }, "operationId": "postAdminOperationsSpaceBlocksByIdPickups", "summary": "POST /v1/admin/operations/space-blocks/{id}/pickups", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/space-blocks/{id}/pickups/reverse": { "post": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "pickupId": { "type": "string", "minLength": 1 }, "sessionId": { "type": "string", "minLength": 1 } } } } } }, "responses": { "200": { "description": "The reversed space-block pickup", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "blockId": { "type": "string" }, "bookingId": { "type": [ "string", "null" ] }, "sessionId": { "type": [ "string", "null" ] }, "startDate": { "type": "string" }, "endDate": { "type": "string" }, "units": { "type": "integer" }, "status": { "type": "string" }, "pickedUpAt": { "type": "string" }, "reversedAt": { "type": [ "string", "null" ] } }, "required": [ "id", "blockId", "bookingId", "sessionId", "startDate", "endDate", "units", "status", "pickedUpAt", "reversedAt" ] } }, "required": [ "data" ] } } } }, "400": { "description": "invalid_request: request body failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } }, "404": { "description": "Active pickup not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "postAdminOperationsSpaceBlocksByIdPickupsReverse", "summary": "POST /v1/admin/operations/space-blocks/{id}/pickups/reverse", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } }, "/v1/admin/operations/space-blocks/{id}/release": { "post": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "The released units and updated space block", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "releasedUnits": { "type": "integer" }, "block": { "type": "object", "properties": { "id": { "type": "string" }, "functionSpaceId": { "type": "string" }, "programId": { "type": [ "string", "null" ] }, "supplierId": { "type": [ "string", "null" ] }, "name": { "type": "string" }, "status": { "type": "string" }, "currency": { "type": [ "string", "null" ] }, "netRateCents": { "type": [ "integer", "null" ] }, "sellRateCents": { "type": [ "integer", "null" ] }, "holdStartTime": { "type": [ "string", "null" ] }, "holdEndTime": { "type": [ "string", "null" ] }, "optionDate": { "type": [ "string", "null" ] }, "cutoffDate": { "type": [ "string", "null" ] }, "attritionTerms": { "type": [ "object", "null" ], "additionalProperties": {} }, "notes": { "type": [ "string", "null" ] }, "metadata": { "type": [ "object", "null" ], "additionalProperties": {} }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "functionSpaceId", "programId", "supplierId", "name", "status", "currency", "netRateCents", "sellRateCents", "holdStartTime", "holdEndTime", "optionDate", "cutoffDate", "attritionTerms", "notes", "metadata", "createdAt", "updatedAt" ] } }, "required": [ "releasedUnits", "block" ] } }, "required": [ "data" ] } } } }, "404": { "description": "Space block not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ] } } } } }, "operationId": "postAdminOperationsSpaceBlocksByIdRelease", "summary": "POST /v1/admin/operations/space-blocks/{id}/release", "tags": [ "operations" ], "x-voyant-module": "operations", "x-voyant-surface": "admin", "x-voyant-api-id": "@voyant-travel/operations#api.admin" } } }, "webhooks": {} }