{ "openapi": "3.1.0", "info": { "title": "Adventures Together API", "version": "1.0.0", "description": "Agent-first API contract for Adventures Together." }, "servers": [ { "url": "/api/v1", "description": "Primary API server" } ], "security": [ { "bearerAuth": [] } ], "components": { "securitySchemes": { "bearerAuth": { "type": "http", "scheme": "bearer", "bearerFormat": "API Key" } }, "parameters": { "IdempotencyKey": { "name": "Idempotency-Key", "in": "header", "required": false, "description": "Replay-safe key for non-idempotent writes. Scoped to API key + method + path + request body.", "schema": { "type": "string", "maxLength": 128 } }, "RequestId": { "name": "x-request-id", "in": "header", "required": false, "description": "Optional correlation ID. If omitted, server generates one.", "schema": { "type": "string" } } }, "schemas": { "SuccessEnvelope": { "type": "object", "required": [ "ok", "requestId", "data" ], "properties": { "ok": { "type": "boolean", "const": true }, "requestId": { "type": "string" }, "data": {}, "meta": { "type": "object", "additionalProperties": true } }, "additionalProperties": false }, "ErrorEnvelope": { "type": "object", "required": [ "ok", "error" ], "properties": { "ok": { "type": "boolean", "const": false }, "error": { "type": "object", "required": [ "code", "message", "details", "requestId" ], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "details": {}, "requestId": { "type": "string" } }, "additionalProperties": false } }, "additionalProperties": false } }, "responses": { "Success": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SuccessEnvelope" } } } }, "Error": { "description": "Error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } } } }, "paths": { "/": { "get": { "operationId": "getApiDiscovery", "summary": "API self-discovery", "security": [], "parameters": [ { "$ref": "#/components/parameters/RequestId" } ], "responses": { "200": { "$ref": "#/components/responses/Success" } } } }, "/access-matrix": { "get": { "operationId": "getApiAccessMatrix", "summary": "Get effective API access matrix and doctor guidance", "parameters": [ { "$ref": "#/components/parameters/RequestId" } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "401": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } } } }, "/activities/projects": { "post": { "operationId": "createActivityProject", "summary": "Create an activity project", "parameters": [ { "$ref": "#/components/parameters/IdempotencyKey" } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" } } }, "get": { "operationId": "getActivitiesProjects", "summary": "List projects for a partnership", "description": "List projects for a partnership", "tags": [ "activities" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "name": "partnershipId", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "401": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true } }, "/activities/projects/{id}": { "get": { "operationId": "getActivitiesProjectsById", "summary": "Get project with tasks/updates for a partnership", "description": "Get project with tasks/updates for a partnership", "tags": [ "activities" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "partnershipId", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true }, "patch": { "operationId": "patchActivitiesProjectsById", "summary": "Update project (requires partnershipId in request body)", "description": "Update project (requires partnershipId in request body)", "tags": [ "activities" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } }, "delete": { "operationId": "deleteActivitiesProjectsById", "summary": "Remove project", "description": "Remove project", "tags": [ "activities" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "partnershipId", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true } }, "/activities/stats": { "get": { "operationId": "getActivitiesStats", "summary": "Project stats for a partnership", "description": "Project stats for a partnership", "tags": [ "activities" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "name": "partnershipId", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "401": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true } }, "/activities/tasks": { "post": { "operationId": "createActivityTask", "summary": "Create an activity task", "parameters": [ { "$ref": "#/components/parameters/IdempotencyKey" } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" } } } }, "/activities/tasks/{id}": { "patch": { "operationId": "patchActivitiesTasksById", "summary": "Update task (requires partnershipId in request body)", "description": "Update task (requires partnershipId in request body)", "tags": [ "activities" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } }, "delete": { "operationId": "deleteActivitiesTasksById", "summary": "Remove task", "description": "Remove task", "tags": [ "activities" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "partnershipId", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true } }, "/activities/templates": { "get": { "operationId": "getActivitiesTemplates", "summary": "List project templates with partnership-scoped vote state when partnershipId is provided", "description": "List project templates with partnership-scoped vote state when partnershipId is provided", "tags": [ "activities" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "name": "partnershipId", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "401": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true } }, "/activities/templates/{id}/add": { "post": { "operationId": "postActivitiesTemplatesByIdAdd", "summary": "Add template to projects (requires partnershipId in request body)", "description": "Add template to projects (requires partnershipId in request body)", "tags": [ "activities" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } } }, "/activities/templates/categories": { "get": { "operationId": "getActivitiesTemplatesCategories", "summary": "Project template categories with partnership-scoped voted counts", "description": "Project template categories with partnership-scoped voted counts", "tags": [ "activities" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "name": "partnershipId", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "401": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true } }, "/activities/templates/matches": { "get": { "operationId": "getActivitiesTemplatesMatches", "summary": "Matched templates for the active partnership", "description": "Matched templates for the active partnership", "tags": [ "activities" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "name": "partnershipId", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "401": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true } }, "/activities/templates/vote": { "post": { "operationId": "postActivitiesTemplatesVote", "summary": "Vote on a template (requires partnershipId in request body)", "description": "Vote on a template (requires partnershipId in request body)", "tags": [ "activities" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } } }, "/activities/updates": { "post": { "operationId": "createActivityUpdate", "summary": "Create an activity update", "parameters": [ { "$ref": "#/components/parameters/IdempotencyKey" } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" } } } }, "/activities/updates/{id}": { "patch": { "operationId": "patchActivitiesUpdatesById", "summary": "Update project update (requires partnershipId in request body)", "description": "Update project update (requires partnershipId in request body)", "tags": [ "activities" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } }, "delete": { "operationId": "deleteActivitiesUpdatesById", "summary": "Remove project update", "description": "Remove project update", "tags": [ "activities" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "partnershipId", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true } }, "/admin/access-requests": { "get": { "operationId": "adminListAccessRequests", "summary": "Admin: list API access escalation requests", "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "name": "status", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } } } }, "/admin/access-requests/{id}": { "patch": { "operationId": "adminReviewAccessRequest", "summary": "Admin: approve or deny API access escalation request", "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } } } }, "/admin/ai-research/packets": { "get": { "operationId": "getAdminAiResearchPackets", "summary": "List replayable AI research packets", "description": "List replayable AI research packets", "tags": [ "admin" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "name": "status", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "idea", "ready", "in_progress", "converted", "archived" ] } }, { "name": "targetSection", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "explore", "activities", "watch", "read", "listen", "play", "talk", "see" ] } }, { "name": "includeArchived", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "search", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 500 } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true }, "post": { "operationId": "postAdminAiResearchPackets", "summary": "Store a replayable AI research packet when research cannot be applied immediately", "description": "Store a replayable AI research packet when research cannot be applied immediately", "tags": [ "admin" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "required": [ "title" ], "additionalProperties": false, "properties": { "title": { "type": "string", "description": "Rough admin-only bucket-list idea title." }, "description": { "type": "string", "description": "Optional short description of the list idea." }, "targetSection": { "type": "string", "enum": [ "explore", "activities", "watch", "read", "listen", "play", "talk", "see" ], "description": "Optional Together page this idea probably belongs to." }, "category": { "type": "string", "description": "Optional broad category." }, "subcategory": { "type": "string", "description": "Optional subcategory when the idea has a clear scope." }, "intendedItemCount": { "type": "integer", "minimum": 1, "description": "Optional expected final item count." }, "priority": { "type": "integer", "description": "Optional admin priority boost." }, "notes": { "type": "string", "description": "Optional internal scope notes, source ideas, exclusions, or rationale." } } } } } } } }, "/admin/ai-research/packets/{id}": { "get": { "operationId": "getAdminAiResearchPacketsById", "summary": "Read one replayable AI research packet", "description": "Read one replayable AI research packet", "tags": [ "admin" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true } }, "/admin/ai-research/packets/{id}/replay": { "post": { "operationId": "postAdminAiResearchPacketsByIdReplay", "summary": "Replay a packet into candidate workspace rows before starting new research", "description": "Replay a packet into candidate workspace rows before starting new research", "tags": [ "admin" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "title": { "type": "string" }, "description": { "type": "string" }, "targetSection": { "type": "string", "enum": [ "explore", "activities", "watch", "read", "listen", "play", "talk", "see" ] }, "category": { "type": "string" }, "subcategory": { "type": "string" }, "intendedItemCount": { "type": "integer", "minimum": 1 }, "status": { "type": "string", "enum": [ "idea", "ready", "in_progress", "converted", "archived" ] }, "priority": { "type": "integer" }, "notes": { "type": "string" }, "convertedTemplateId": { "type": "string" } } } } } } } }, "/admin/ai-research/tasks": { "get": { "operationId": "getAdminAiResearchTasks", "summary": "admin operator endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "description": "admin operator endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "tags": [ "admin" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "x-routeInventory": { "file": "src/app/api/v1/admin/ai-research/tasks/route.ts", "audience": "admin_operator", "authMode": "admin_session_or_admin_key", "minTier": "admin", "operationClass": "read", "idempotencySupport": "not_applicable", "tierChecked": true, "ownershipOrScopeChecked": true, "writeAuditFindings": [] } } }, "/admin/ai-research/tasks/{id}/block": { "post": { "operationId": "postAdminAiResearchTasksByIdBlock", "summary": "Block an AI research task with a reason, optional packet, and next eligible time", "description": "Block an AI research task with a reason, optional packet, and next eligible time", "tags": [ "admin" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } } }, "/admin/ai-research/tasks/{id}/claim": { "post": { "operationId": "postAdminAiResearchTasksByIdClaim", "summary": "Claim an AI research task with a TTL", "description": "Claim an AI research task with a TTL", "tags": [ "admin" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } } }, "/admin/ai-research/tasks/{id}/complete": { "post": { "operationId": "postAdminAiResearchTasksByIdComplete", "summary": "Complete an AI research task and record the result", "description": "Complete an AI research task and record the result", "tags": [ "admin" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } } }, "/admin/ai-research/tasks/{id}/heartbeat": { "post": { "operationId": "postAdminAiResearchTasksByIdHeartbeat", "summary": "Extend an AI research task claim", "description": "Extend an AI research task claim", "tags": [ "admin" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } } }, "/admin/ai-research/tasks/{id}/requeue": { "post": { "operationId": "postAdminAiResearchTasksByIdRequeue", "summary": "admin operator endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "description": "admin operator endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "tags": [ "admin" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "x-routeInventory": { "file": "src/app/api/v1/admin/ai-research/tasks/[id]/requeue/route.ts", "audience": "admin_operator", "authMode": "admin_session_or_admin_key", "minTier": "admin", "operationClass": "write", "idempotencySupport": "admin_review", "tierChecked": true, "ownershipOrScopeChecked": true, "writeAuditFindings": [] } } }, "/admin/ai-research/tasks/next": { "get": { "operationId": "getAdminAiResearchTasksNext", "summary": "Generate and fetch the next AI research task by priority", "description": "Generate and fetch the next AI research task by priority", "tags": [ "admin" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true } }, "/admin/api-keys": { "get": { "operationId": "adminListApiKeys", "summary": "Admin: list API keys with usage", "responses": { "200": { "$ref": "#/components/responses/Success" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" } } } }, "/admin/api-keys/{id}": { "patch": { "operationId": "adminUpdateApiKeyTier", "summary": "Admin: update API key tier", "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" } } }, "delete": { "operationId": "adminRevokeOrDeleteApiKey", "summary": "Admin: revoke key (mode=revoke) or soft-delete key (mode=delete)", "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "name": "mode", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "revoke", "delete" ] } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" } } } }, "/admin/api-keys/{id}/force-rotate": { "post": { "operationId": "adminForceRotateApiKey", "summary": "Admin: force-rotate API key", "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" } } } }, "/admin/api-keys/qa-cleanup": { "post": { "operationId": "postAdminApiKeysQaCleanup", "summary": "admin operator endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "description": "admin operator endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "tags": [ "admin" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "x-routeInventory": { "file": "src/app/api/v1/admin/api-keys/qa-cleanup/route.ts", "audience": "admin_operator", "authMode": "admin_session_or_admin_key", "minTier": "admin", "operationClass": "write", "idempotencySupport": "admin_review", "tierChecked": true, "ownershipOrScopeChecked": true, "writeAuditFindings": [] } } }, "/admin/audit-logs": { "get": { "operationId": "adminListAuditLogs", "summary": "Admin: query API activity logs", "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" } } } }, "/admin/automation-health": { "get": { "operationId": "getAdminAutomationHealth", "summary": "admin operator endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "description": "admin operator endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "tags": [ "admin" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "x-routeInventory": { "file": "src/app/api/v1/admin/automation-health/route.ts", "audience": "admin_operator", "authMode": "admin_session_or_admin_key", "minTier": "admin", "operationClass": "read", "idempotencySupport": "not_applicable", "tierChecked": true, "ownershipOrScopeChecked": true, "writeAuditFindings": [] } } }, "/admin/bucket-list-ideas": { "get": { "operationId": "getAdminBucketListIdeas", "summary": "List admin-only rough bucket-list ideas before they become public templates", "description": "List admin-only rough bucket-list ideas before they become public templates", "tags": [ "admin" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true }, "post": { "operationId": "postAdminBucketListIdeas", "summary": "Create an admin-only rough bucket-list idea", "description": "Create an admin-only rough bucket-list idea", "tags": [ "admin" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } } }, "/admin/bucket-list-ideas/{id}": { "patch": { "operationId": "patchAdminBucketListIdeasById", "summary": "Update an admin-only bucket-list idea status or metadata", "description": "Update an admin-only bucket-list idea status or metadata", "tags": [ "admin" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } }, "delete": { "operationId": "deleteAdminBucketListIdeasById", "summary": "Archive an admin-only bucket-list idea", "description": "Archive an admin-only bucket-list idea", "tags": [ "admin" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true } }, "/admin/bucket-list-ideas/{id}/promote": { "post": { "operationId": "postAdminBucketListIdeasByIdPromote", "summary": "Promote an admin-only bucket-list idea into a hidden draft template", "description": "Promote an admin-only bucket-list idea into a hidden draft template", "tags": [ "admin" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true } }, "/admin/bucket-list-research": { "get": { "operationId": "getAdminBucketListResearch", "summary": "admin operator endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "description": "admin operator endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "tags": [ "admin" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "x-routeInventory": { "file": "src/app/api/v1/admin/bucket-list-research/route.ts", "audience": "admin_operator", "authMode": "admin_session_or_admin_key", "minTier": "admin", "operationClass": "read", "idempotencySupport": "not_applicable", "tierChecked": true, "ownershipOrScopeChecked": true, "writeAuditFindings": [] } }, "post": { "operationId": "postAdminBucketListResearch", "summary": "admin operator endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "description": "admin operator endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "tags": [ "admin" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "x-routeInventory": { "file": "src/app/api/v1/admin/bucket-list-research/route.ts", "audience": "admin_operator", "authMode": "admin_session_or_admin_key", "minTier": "admin", "operationClass": "write", "idempotencySupport": "admin_review", "tierChecked": true, "ownershipOrScopeChecked": true, "writeAuditFindings": [] } } }, "/admin/bucket-list-research/{id}": { "delete": { "operationId": "deleteAdminBucketListResearchById", "summary": "admin operator endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "description": "admin operator endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "tags": [ "admin" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "x-routeInventory": { "file": "src/app/api/v1/admin/bucket-list-research/[id]/route.ts", "audience": "admin_operator", "authMode": "admin_session_or_admin_key", "minTier": "admin", "operationClass": "destructive_write", "idempotencySupport": "admin_review", "tierChecked": true, "ownershipOrScopeChecked": true, "writeAuditFindings": [] } }, "get": { "operationId": "getAdminBucketListResearchById", "summary": "admin operator endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "description": "admin operator endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "tags": [ "admin" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "x-routeInventory": { "file": "src/app/api/v1/admin/bucket-list-research/[id]/route.ts", "audience": "admin_operator", "authMode": "admin_session_or_admin_key", "minTier": "admin", "operationClass": "read", "idempotencySupport": "not_applicable", "tierChecked": true, "ownershipOrScopeChecked": true, "writeAuditFindings": [] } }, "patch": { "operationId": "patchAdminBucketListResearchById", "summary": "admin operator endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "description": "admin operator endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "tags": [ "admin" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "x-routeInventory": { "file": "src/app/api/v1/admin/bucket-list-research/[id]/route.ts", "audience": "admin_operator", "authMode": "admin_session_or_admin_key", "minTier": "admin", "operationClass": "write", "idempotencySupport": "admin_review", "tierChecked": true, "ownershipOrScopeChecked": true, "writeAuditFindings": [] } } }, "/admin/bucket-list-research/{id}/history": { "get": { "operationId": "getAdminBucketListResearchByIdHistory", "summary": "List public bucket-list template change history", "description": "List public bucket-list template change history", "tags": [ "admin" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true }, "post": { "operationId": "postAdminBucketListResearchByIdHistory", "summary": "Record public bucket-list template change history", "description": "Record public bucket-list template change history", "tags": [ "admin" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } } }, "/admin/bucket-list-research/{id}/items": { "put": { "operationId": "putAdminBucketListResearchByIdItems", "summary": "Replace public bucket-list template items with canonical catalog-linked rows; accepts creatorNote and whyIncluded", "description": "Replace public bucket-list template items with canonical catalog-linked rows; accepts creatorNote and whyIncluded", "tags": [ "admin" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } }, "post": { "operationId": "postAdminBucketListResearchByIdItems", "summary": "admin operator endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "description": "admin operator endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "tags": [ "admin" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "x-routeInventory": { "file": "src/app/api/v1/admin/bucket-list-research/[id]/items/route.ts", "audience": "admin_operator", "authMode": "admin_session_or_admin_key", "minTier": "admin", "operationClass": "write", "idempotencySupport": "admin_review", "tierChecked": true, "ownershipOrScopeChecked": true, "writeAuditFindings": [] } } }, "/admin/bucket-list-research/{id}/items/append": { "post": { "operationId": "postAdminBucketListResearchByIdItemsAppend", "summary": "Append canonical catalog-linked rows to a public bucket-list template; accepts creatorNote and whyIncluded", "description": "Append canonical catalog-linked rows to a public bucket-list template; accepts creatorNote and whyIncluded", "tags": [ "admin" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } } }, "/admin/bucket-list-research/{id}/workspace": { "get": { "operationId": "getAdminBucketListResearchByIdWorkspace", "summary": "List public template candidate workspace rows", "description": "List public template candidate workspace rows", "tags": [ "admin" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true }, "post": { "operationId": "postAdminBucketListResearchByIdWorkspace", "summary": "Import public template candidate workspace rows from pasted/CSV/markdown source text", "description": "Import public template candidate workspace rows from pasted/CSV/markdown source text", "tags": [ "admin" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } } }, "/admin/bucket-list-research/{id}/workspace/{candidateId}": { "patch": { "operationId": "patchAdminBucketListResearchByIdWorkspaceByCandidateid", "summary": "Update a public template candidate workspace row, including creatorNote, whyIncluded, sources, and match status", "description": "Update a public template candidate workspace row, including creatorNote, whyIncluded, sources, and match status", "tags": [ "admin" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "candidateId", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } } }, "/admin/bucket-list-research/{id}/workspace/{candidateId}/resolve": { "post": { "operationId": "postAdminBucketListResearchByIdWorkspaceByCandidateidResolve", "summary": "Resolve one public template candidate row", "description": "Resolve one public template candidate row", "tags": [ "admin" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "candidateId", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } } }, "/admin/bucket-list-research/{id}/workspace/resolve": { "post": { "operationId": "postAdminBucketListResearchByIdWorkspaceResolve", "summary": "Resolve public template candidate rows in bulk: exact match, append linked, mark needs create, reject, reset, or full pass", "description": "Resolve public template candidate rows in bulk: exact match, append linked, mark needs create, reject, reset, or full pass", "tags": [ "admin" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } } }, "/admin/bucket-list-research/approve-legacy": { "post": { "operationId": "postAdminBucketListResearchApproveLegacy", "summary": "admin operator endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "description": "admin operator endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "tags": [ "admin" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "x-routeInventory": { "file": "src/app/api/v1/admin/bucket-list-research/approve-legacy/route.ts", "audience": "admin_operator", "authMode": "admin_session_or_admin_key", "minTier": "admin", "operationClass": "write", "idempotencySupport": "admin_review", "tierChecked": true, "ownershipOrScopeChecked": true, "writeAuditFindings": [] } } }, "/admin/bucket-list-research/findings": { "get": { "operationId": "getAdminBucketListResearchFindings", "summary": "admin operator endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "description": "admin operator endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "tags": [ "admin" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "x-routeInventory": { "file": "src/app/api/v1/admin/bucket-list-research/findings/route.ts", "audience": "admin_operator", "authMode": "admin_session_or_admin_key", "minTier": "admin", "operationClass": "read", "idempotencySupport": "not_applicable", "tierChecked": true, "ownershipOrScopeChecked": true, "writeAuditFindings": [] } }, "patch": { "operationId": "patchAdminBucketListResearchFindings", "summary": "admin operator endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "description": "admin operator endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "tags": [ "admin" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "x-routeInventory": { "file": "src/app/api/v1/admin/bucket-list-research/findings/route.ts", "audience": "admin_operator", "authMode": "admin_session_or_admin_key", "minTier": "admin", "operationClass": "write", "idempotencySupport": "admin_review", "tierChecked": true, "ownershipOrScopeChecked": true, "writeAuditFindings": [] } } }, "/admin/bucket-list-research/findings/{id}": { "patch": { "operationId": "patchAdminBucketListResearchFindingsById", "summary": "admin operator endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "description": "admin operator endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "tags": [ "admin" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "x-routeInventory": { "file": "src/app/api/v1/admin/bucket-list-research/findings/[id]/route.ts", "audience": "admin_operator", "authMode": "admin_session_or_admin_key", "minTier": "admin", "operationClass": "write", "idempotencySupport": "admin_review", "tierChecked": true, "ownershipOrScopeChecked": true, "writeAuditFindings": [] } } }, "/admin/bucket-list-research/production-queue": { "get": { "operationId": "getAdminBucketListResearchProductionQueue", "summary": "Summarize bucket-list production stages from proposed ideas through candidate matching, catalog creation, image/source audit, legacy audit, and release readiness", "description": "Summarize bucket-list production stages from proposed ideas through candidate matching, catalog creation, image/source audit, legacy audit, and release readiness", "tags": [ "admin" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true } }, "/admin/bucket-list-research/run": { "post": { "operationId": "postAdminBucketListResearchRun", "summary": "admin operator endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "description": "admin operator endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "tags": [ "admin" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "x-routeInventory": { "file": "src/app/api/v1/admin/bucket-list-research/run/route.ts", "audience": "admin_operator", "authMode": "admin_session_or_admin_key", "minTier": "admin", "operationClass": "write", "idempotencySupport": "admin_review", "tierChecked": true, "ownershipOrScopeChecked": true, "writeAuditFindings": [] } } }, "/admin/bucket-list-research/source-preview": { "get": { "operationId": "getAdminBucketListResearchSourcePreview", "summary": "admin operator endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "description": "admin operator endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "tags": [ "admin" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "x-routeInventory": { "file": "src/app/api/v1/admin/bucket-list-research/source-preview/route.ts", "audience": "admin_operator", "authMode": "admin_session_or_admin_key", "minTier": "admin", "operationClass": "read", "idempotencySupport": "not_applicable", "tierChecked": true, "ownershipOrScopeChecked": true, "writeAuditFindings": [] } } }, "/admin/catalog-quality/autopilot/run": { "post": { "operationId": "postAdminCatalogQualityAutopilotRun", "summary": "admin operator endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "description": "admin operator endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "tags": [ "admin" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "x-routeInventory": { "file": "src/app/api/v1/admin/catalog-quality/autopilot/run/route.ts", "audience": "admin_operator", "authMode": "admin_session_or_admin_key", "minTier": "admin", "operationClass": "read", "idempotencySupport": "not_applicable", "tierChecked": true, "ownershipOrScopeChecked": true, "writeAuditFindings": [] } } }, "/admin/catalog-quality/batch-runs": { "get": { "operationId": "getAdminCatalogQualityBatchRuns", "summary": "admin operator endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "description": "admin operator endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "tags": [ "admin" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "x-routeInventory": { "file": "src/app/api/v1/admin/catalog-quality/batch-runs/route.ts", "audience": "admin_operator", "authMode": "admin_session_or_admin_key", "minTier": "admin", "operationClass": "read", "idempotencySupport": "not_applicable", "tierChecked": true, "ownershipOrScopeChecked": true, "writeAuditFindings": [] } }, "post": { "operationId": "postAdminCatalogQualityBatchRuns", "summary": "admin operator endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "description": "admin operator endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "tags": [ "admin" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "x-routeInventory": { "file": "src/app/api/v1/admin/catalog-quality/batch-runs/route.ts", "audience": "admin_operator", "authMode": "admin_session_or_admin_key", "minTier": "admin", "operationClass": "write", "idempotencySupport": "admin_review", "tierChecked": true, "ownershipOrScopeChecked": true, "writeAuditFindings": [] } } }, "/admin/catalog-quality/batch-runs/{id}": { "get": { "operationId": "getAdminCatalogQualityBatchRunsById", "summary": "admin operator endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "description": "admin operator endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "tags": [ "admin" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "x-routeInventory": { "file": "src/app/api/v1/admin/catalog-quality/batch-runs/[id]/route.ts", "audience": "admin_operator", "authMode": "admin_session_or_admin_key", "minTier": "admin", "operationClass": "read", "idempotencySupport": "not_applicable", "tierChecked": true, "ownershipOrScopeChecked": true, "writeAuditFindings": [] } } }, "/admin/catalog-quality/batch-runs/{id}/abandon": { "post": { "operationId": "postAdminCatalogQualityBatchRunsByIdAbandon", "summary": "admin operator endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "description": "admin operator endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "tags": [ "admin" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "x-routeInventory": { "file": "src/app/api/v1/admin/catalog-quality/batch-runs/[id]/abandon/route.ts", "audience": "admin_operator", "authMode": "admin_session_or_admin_key", "minTier": "admin", "operationClass": "write", "idempotencySupport": "admin_review", "tierChecked": true, "ownershipOrScopeChecked": true, "writeAuditFindings": [] } } }, "/admin/catalog-quality/batch-runs/{id}/checkpoint": { "post": { "operationId": "postAdminCatalogQualityBatchRunsByIdCheckpoint", "summary": "admin operator endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "description": "admin operator endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "tags": [ "admin" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "x-routeInventory": { "file": "src/app/api/v1/admin/catalog-quality/batch-runs/[id]/checkpoint/route.ts", "audience": "admin_operator", "authMode": "admin_session_or_admin_key", "minTier": "admin", "operationClass": "write", "idempotencySupport": "admin_review", "tierChecked": true, "ownershipOrScopeChecked": true, "writeAuditFindings": [] } } }, "/admin/catalog-quality/batch-runs/{id}/complete": { "post": { "operationId": "postAdminCatalogQualityBatchRunsByIdComplete", "summary": "admin operator endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "description": "admin operator endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "tags": [ "admin" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "x-routeInventory": { "file": "src/app/api/v1/admin/catalog-quality/batch-runs/[id]/complete/route.ts", "audience": "admin_operator", "authMode": "admin_session_or_admin_key", "minTier": "admin", "operationClass": "write", "idempotencySupport": "admin_review", "tierChecked": true, "ownershipOrScopeChecked": true, "writeAuditFindings": [] } } }, "/admin/catalog-quality/batch-runs/{id}/items": { "get": { "operationId": "getAdminCatalogQualityBatchRunsByIdItems", "summary": "admin operator endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "description": "admin operator endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "tags": [ "admin" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "x-routeInventory": { "file": "src/app/api/v1/admin/catalog-quality/batch-runs/[id]/items/route.ts", "audience": "admin_operator", "authMode": "admin_session_or_admin_key", "minTier": "admin", "operationClass": "read", "idempotencySupport": "not_applicable", "tierChecked": true, "ownershipOrScopeChecked": true, "writeAuditFindings": [] } } }, "/admin/catalog-quality/checks": { "post": { "operationId": "postAdminCatalogQualityChecks", "summary": "admin operator endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "description": "admin operator endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "tags": [ "admin" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "x-routeInventory": { "file": "src/app/api/v1/admin/catalog-quality/checks/route.ts", "audience": "admin_operator", "authMode": "admin_session_or_admin_key", "minTier": "admin", "operationClass": "write", "idempotencySupport": "admin_review", "tierChecked": true, "ownershipOrScopeChecked": true, "writeAuditFindings": [] } } }, "/admin/catalog-quality/decisions/{id}/resolve": { "post": { "operationId": "postAdminCatalogQualityDecisionsByIdResolve", "summary": "admin operator endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "description": "admin operator endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "tags": [ "admin" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "x-routeInventory": { "file": "src/app/api/v1/admin/catalog-quality/decisions/[id]/resolve/route.ts", "audience": "admin_operator", "authMode": "admin_session_or_admin_key", "minTier": "admin", "operationClass": "write", "idempotencySupport": "admin_review", "tierChecked": true, "ownershipOrScopeChecked": true, "writeAuditFindings": [] } } }, "/admin/catalog-quality/hygiene-issues": { "get": { "operationId": "getAdminCatalogQualityHygieneIssues", "summary": "Summarize catalog-research hygiene issues (placeholder licenses, wikimedia mistagged as institutional, non-canonical verifiedFields, tracking-param URLs, generic credits, Commons thumbnail URLs); pass ?gap= for the per-item list, ?section= to scope by Together section", "description": "Summarize catalog-research hygiene issues (placeholder licenses, wikimedia mistagged as institutional, non-canonical verifiedFields, tracking-param URLs, generic credits, Commons thumbnail URLs); pass ?gap= for the per-item list, ?section= to scope by Together section", "tags": [ "admin" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true } }, "/admin/catalog-quality/items": { "get": { "operationId": "getAdminCatalogQualityItems", "summary": "admin operator endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "description": "admin operator endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "tags": [ "admin" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "x-routeInventory": { "file": "src/app/api/v1/admin/catalog-quality/items/route.ts", "audience": "admin_operator", "authMode": "admin_session_or_admin_key", "minTier": "admin", "operationClass": "read", "idempotencySupport": "not_applicable", "tierChecked": true, "ownershipOrScopeChecked": true, "writeAuditFindings": [] } } }, "/admin/catalog-quality/items/{section}/{id}": { "get": { "operationId": "getAdminCatalogQualityItemsBySectionById", "summary": "admin operator endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "description": "admin operator endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "tags": [ "admin" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "name": "section", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "x-routeInventory": { "file": "src/app/api/v1/admin/catalog-quality/items/[section]/[id]/route.ts", "audience": "admin_operator", "authMode": "admin_session_or_admin_key", "minTier": "admin", "operationClass": "read", "idempotencySupport": "not_applicable", "tierChecked": true, "ownershipOrScopeChecked": true, "writeAuditFindings": [] } }, "patch": { "operationId": "patchAdminCatalogQualityItemsBySectionById", "summary": "admin operator endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "description": "admin operator endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "tags": [ "admin" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" }, { "name": "section", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "x-routeInventory": { "file": "src/app/api/v1/admin/catalog-quality/items/[section]/[id]/route.ts", "audience": "admin_operator", "authMode": "admin_session_or_admin_key", "minTier": "admin", "operationClass": "write", "idempotencySupport": "admin_review", "tierChecked": true, "ownershipOrScopeChecked": true, "writeAuditFindings": [] } } }, "/admin/catalog-quality/items/{section}/{id}/checks": { "get": { "operationId": "getAdminCatalogQualityItemsBySectionByIdChecks", "summary": "admin operator endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "description": "admin operator endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "tags": [ "admin" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "name": "section", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "x-routeInventory": { "file": "src/app/api/v1/admin/catalog-quality/items/[section]/[id]/checks/route.ts", "audience": "admin_operator", "authMode": "admin_session_or_admin_key", "minTier": "admin", "operationClass": "read", "idempotencySupport": "not_applicable", "tierChecked": true, "ownershipOrScopeChecked": true, "writeAuditFindings": [] } } }, "/admin/catalog-quality/next-item": { "get": { "operationId": "getAdminCatalogQualityNextItem", "summary": "admin operator endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "description": "admin operator endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "tags": [ "admin" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "x-routeInventory": { "file": "src/app/api/v1/admin/catalog-quality/next-item/route.ts", "audience": "admin_operator", "authMode": "admin_session_or_admin_key", "minTier": "admin", "operationClass": "read", "idempotencySupport": "not_applicable", "tierChecked": true, "ownershipOrScopeChecked": true, "writeAuditFindings": [] } } }, "/admin/catalog-quality/recommendations": { "get": { "operationId": "getAdminCatalogQualityRecommendations", "summary": "admin operator endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "description": "admin operator endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "tags": [ "admin" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "x-routeInventory": { "file": "src/app/api/v1/admin/catalog-quality/recommendations/route.ts", "audience": "admin_operator", "authMode": "admin_session_or_admin_key", "minTier": "admin", "operationClass": "read", "idempotencySupport": "not_applicable", "tierChecked": true, "ownershipOrScopeChecked": true, "writeAuditFindings": [] } } }, "/admin/catalog-quality/runs/{id}/abandon": { "post": { "operationId": "postAdminCatalogQualityRunsByIdAbandon", "summary": "admin operator endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "description": "admin operator endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "tags": [ "admin" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "x-routeInventory": { "file": "src/app/api/v1/admin/catalog-quality/runs/[id]/abandon/route.ts", "audience": "admin_operator", "authMode": "admin_session_or_admin_key", "minTier": "admin", "operationClass": "write", "idempotencySupport": "admin_review", "tierChecked": true, "ownershipOrScopeChecked": true, "writeAuditFindings": [] } } }, "/admin/catalog-quality/runs/{id}/complete": { "post": { "operationId": "postAdminCatalogQualityRunsByIdComplete", "summary": "admin operator endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "description": "admin operator endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "tags": [ "admin" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "x-routeInventory": { "file": "src/app/api/v1/admin/catalog-quality/runs/[id]/complete/route.ts", "audience": "admin_operator", "authMode": "admin_session_or_admin_key", "minTier": "admin", "operationClass": "write", "idempotencySupport": "admin_review", "tierChecked": true, "ownershipOrScopeChecked": true, "writeAuditFindings": [] } } }, "/admin/catalog-quality/runs/start": { "post": { "operationId": "postAdminCatalogQualityRunsStart", "summary": "admin operator endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "description": "admin operator endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "tags": [ "admin" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "x-routeInventory": { "file": "src/app/api/v1/admin/catalog-quality/runs/start/route.ts", "audience": "admin_operator", "authMode": "admin_session_or_admin_key", "minTier": "admin", "operationClass": "write", "idempotencySupport": "admin_review", "tierChecked": true, "ownershipOrScopeChecked": true, "writeAuditFindings": [] } } }, "/admin/explore-guides/audit": { "get": { "operationId": "getAdminExploreGuidesAudit", "summary": "admin operator endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "description": "admin operator endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "tags": [ "admin" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "x-routeInventory": { "file": "src/app/api/v1/admin/explore-guides/audit/route.ts", "audience": "admin_operator", "authMode": "admin_session_or_admin_key", "minTier": "admin", "operationClass": "read", "idempotencySupport": "not_applicable", "tierChecked": true, "ownershipOrScopeChecked": true, "writeAuditFindings": [] } } }, "/admin/explore-guides/backfill": { "post": { "operationId": "postAdminExploreGuidesBackfill", "summary": "admin operator endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "description": "admin operator endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "tags": [ "admin" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "x-routeInventory": { "file": "src/app/api/v1/admin/explore-guides/backfill/route.ts", "audience": "admin_operator", "authMode": "admin_session_or_admin_key", "minTier": "admin", "operationClass": "write", "idempotencySupport": "admin_review", "tierChecked": true, "ownershipOrScopeChecked": true, "writeAuditFindings": [] } } }, "/admin/image-ingestion/failed": { "get": { "operationId": "getAdminImageIngestionFailed", "summary": "admin operator endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "description": "admin operator endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "tags": [ "admin" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "x-routeInventory": { "file": "src/app/api/v1/admin/image-ingestion/failed/route.ts", "audience": "admin_operator", "authMode": "admin_session_or_admin_key", "minTier": "admin", "operationClass": "read", "idempotencySupport": "not_applicable", "tierChecked": true, "ownershipOrScopeChecked": true, "writeAuditFindings": [] } } }, "/admin/image-ingestion/pause": { "post": { "operationId": "postAdminImageIngestionPause", "summary": "admin operator endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "description": "admin operator endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "tags": [ "admin" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "x-routeInventory": { "file": "src/app/api/v1/admin/image-ingestion/pause/route.ts", "audience": "admin_operator", "authMode": "admin_session_or_admin_key", "minTier": "admin", "operationClass": "write", "idempotencySupport": "admin_review", "tierChecked": true, "ownershipOrScopeChecked": true, "writeAuditFindings": [] } } }, "/admin/image-ingestion/retry/{id}": { "post": { "operationId": "postAdminImageIngestionRetryById", "summary": "admin operator endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "description": "admin operator endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "tags": [ "admin" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "x-routeInventory": { "file": "src/app/api/v1/admin/image-ingestion/retry/[id]/route.ts", "audience": "admin_operator", "authMode": "admin_session_or_admin_key", "minTier": "admin", "operationClass": "write", "idempotencySupport": "admin_review", "tierChecked": true, "ownershipOrScopeChecked": true, "writeAuditFindings": [] } } }, "/admin/image-ingestion/stats": { "get": { "operationId": "getAdminImageIngestionStats", "summary": "admin operator endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "description": "admin operator endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "tags": [ "admin" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "x-routeInventory": { "file": "src/app/api/v1/admin/image-ingestion/stats/route.ts", "audience": "admin_operator", "authMode": "admin_session_or_admin_key", "minTier": "admin", "operationClass": "read", "idempotencySupport": "not_applicable", "tierChecked": true, "ownershipOrScopeChecked": true, "writeAuditFindings": [] } } }, "/admin/integrity/bucket-list": { "get": { "operationId": "getAdminIntegrityBucketList", "summary": "Bucket-list integrity report and recent run history", "description": "Bucket-list integrity report and recent run history", "tags": [ "admin" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true }, "post": { "operationId": "postAdminIntegrityBucketList", "summary": "Run bucket-list integrity audit/repair pipeline", "description": "Run bucket-list integrity audit/repair pipeline", "tags": [ "admin" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } } }, "/admin/operations/overview": { "get": { "operationId": "getAdminOperationsOverview", "summary": "Admin operations overview snapshot", "description": "Admin operations overview snapshot", "tags": [ "admin" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true } }, "/admin/operations/partnerships": { "get": { "operationId": "getAdminOperationsPartnerships", "summary": "Partnership health list with issue flags", "description": "Partnership health list with issue flags", "tags": [ "admin" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true } }, "/admin/operations/partnerships/{id}": { "get": { "operationId": "getAdminOperationsPartnershipsById", "summary": "Partnership-level diagnostics and counts", "description": "Partnership-level diagnostics and counts", "tags": [ "admin" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true } }, "/admin/operations/partnerships/{id}/cancel": { "post": { "operationId": "postAdminOperationsPartnershipsByIdCancel", "summary": "admin operator endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "description": "admin operator endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "tags": [ "admin" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "x-routeInventory": { "file": "src/app/api/v1/admin/operations/partnerships/[id]/cancel/route.ts", "audience": "admin_operator", "authMode": "admin_session_or_admin_key", "minTier": "admin", "operationClass": "write", "idempotencySupport": "admin_review", "tierChecked": true, "ownershipOrScopeChecked": true, "writeAuditFindings": [] } } }, "/admin/operations/partnerships/{id}/repair": { "post": { "operationId": "postAdminOperationsPartnershipsByIdRepair", "summary": "Run a targeted partnership repair action (admin)", "description": "Run a targeted partnership repair action (admin)", "tags": [ "admin" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } } }, "/admin/operations/partnerships/{id}/test-state": { "patch": { "operationId": "patchAdminOperationsPartnershipsByIdTestState", "summary": "admin operator endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "description": "admin operator endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "tags": [ "admin" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "x-routeInventory": { "file": "src/app/api/v1/admin/operations/partnerships/[id]/test-state/route.ts", "audience": "admin_operator", "authMode": "admin_session_or_admin_key", "minTier": "admin", "operationClass": "write", "idempotencySupport": "admin_review", "tierChecked": true, "ownershipOrScopeChecked": true, "writeAuditFindings": [] } } }, "/admin/operations/partnerships/mark-likely-test": { "post": { "operationId": "postAdminOperationsPartnershipsMarkLikelyTest", "summary": "admin operator endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "description": "admin operator endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "tags": [ "admin" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "x-routeInventory": { "file": "src/app/api/v1/admin/operations/partnerships/mark-likely-test/route.ts", "audience": "admin_operator", "authMode": "admin_session_or_admin_key", "minTier": "admin", "operationClass": "write", "idempotencySupport": "admin_review", "tierChecked": true, "ownershipOrScopeChecked": true, "writeAuditFindings": [] } } }, "/admin/operations/users": { "get": { "operationId": "getAdminOperationsUsers", "summary": "List users with API key and active-partnership diagnostics", "description": "List users with API key and active-partnership diagnostics", "tags": [ "admin" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true } }, "/admin/operations/users/{id}/archive": { "patch": { "operationId": "patchAdminOperationsUsersByIdArchive", "summary": "Soft-archive or restore a user (admin)", "description": "Soft-archive or restore a user (admin)", "tags": [ "admin" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } } }, "/admin/operations/users/{id}/diagnostics": { "get": { "operationId": "getAdminOperationsUsersByIdDiagnostics", "summary": "Detailed diagnostics for a user", "description": "Detailed diagnostics for a user", "tags": [ "admin" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true } }, "/admin/operations/users/archive-likely-test": { "post": { "operationId": "postAdminOperationsUsersArchiveLikelyTest", "summary": "Soft-archive likely test users in bulk (admin)", "description": "Soft-archive likely test users in bulk (admin)", "tags": [ "admin" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } } }, "/admin/research-context": { "get": { "operationId": "getAdminResearchContext", "summary": "admin operator endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "description": "admin operator endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "tags": [ "admin" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "x-routeInventory": { "file": "src/app/api/v1/admin/research-context/route.ts", "audience": "admin_operator", "authMode": "admin_session_or_admin_key", "minTier": "admin", "operationClass": "read", "idempotencySupport": "not_applicable", "tierChecked": true, "ownershipOrScopeChecked": true, "writeAuditFindings": [] } } }, "/admin/research-notes": { "get": { "operationId": "getAdminResearchNotes", "summary": "admin operator endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "description": "admin operator endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "tags": [ "admin" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "x-routeInventory": { "file": "src/app/api/v1/admin/research-notes/route.ts", "audience": "admin_operator", "authMode": "admin_session_or_admin_key", "minTier": "admin", "operationClass": "read", "idempotencySupport": "not_applicable", "tierChecked": true, "ownershipOrScopeChecked": true, "writeAuditFindings": [] } }, "post": { "operationId": "postAdminResearchNotes", "summary": "admin operator endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "description": "admin operator endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "tags": [ "admin" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "x-routeInventory": { "file": "src/app/api/v1/admin/research-notes/route.ts", "audience": "admin_operator", "authMode": "admin_session_or_admin_key", "minTier": "admin", "operationClass": "write", "idempotencySupport": "admin_review", "tierChecked": true, "ownershipOrScopeChecked": true, "writeAuditFindings": [] } } }, "/admin/research-notes/{id}/resolve": { "post": { "operationId": "postAdminResearchNotesByIdResolve", "summary": "admin operator endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "description": "admin operator endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "tags": [ "admin" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "x-routeInventory": { "file": "src/app/api/v1/admin/research-notes/[id]/resolve/route.ts", "audience": "admin_operator", "authMode": "admin_session_or_admin_key", "minTier": "admin", "operationClass": "write", "idempotencySupport": "admin_review", "tierChecked": true, "ownershipOrScopeChecked": true, "writeAuditFindings": [] } } }, "/admin/security-events": { "get": { "operationId": "adminListSecurityEvents", "summary": "Admin: query security-focused event feed and risk summary", "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" } } } }, "/admin/solo-completions-backfill": { "get": { "operationId": "getAdminSoloCompletionsBackfill", "summary": "Admin: preview legacy solo-completions backfill candidates", "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "name": "sampleSize", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0 } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" } } } }, "/admin/stats": { "get": { "operationId": "adminGetStats", "summary": "Admin: retrieve API key and security analytics", "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" } } } }, "/admin/users/{id}/api-access": { "patch": { "operationId": "adminSetUserApiAccess", "summary": "Admin: suspend or restore user API access", "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" } } } }, "/admin/users/{id}/tier-override": { "patch": { "operationId": "adminSetUserTierOverride", "summary": "Admin: set or clear user API tier override", "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" } } } }, "/ai-import/commit": { "post": { "operationId": "postAiImportCommit", "summary": "ai import helper endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "description": "ai import helper endpoint; auth: admin_session_or_admin_key; minimum tier: admin", "tags": [ "ai-import" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "x-routeInventory": { "file": "src/app/api/v1/ai-import/commit/route.ts", "audience": "ai_import_helper", "authMode": "admin_session_or_admin_key", "minTier": "admin", "operationClass": "write", "idempotencySupport": "admin_review", "tierChecked": true, "ownershipOrScopeChecked": true, "writeAuditFindings": [] } } }, "/ai-import/preview": { "post": { "operationId": "postAiImportPreview", "summary": "ai import helper endpoint; auth: clerk_session; minimum tier: session", "description": "ai import helper endpoint; auth: clerk_session; minimum tier: session", "tags": [ "ai-import" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "x-routeInventory": { "file": "src/app/api/v1/ai-import/preview/route.ts", "audience": "ai_import_helper", "authMode": "clerk_session", "minTier": "session", "operationClass": "read", "idempotencySupport": "not_applicable", "tierChecked": true, "ownershipOrScopeChecked": true, "writeAuditFindings": [] } } }, "/ai-import/prompts": { "post": { "operationId": "postAiImportPrompts", "summary": "ai import helper endpoint; auth: clerk_session; minimum tier: session", "description": "ai import helper endpoint; auth: clerk_session; minimum tier: session", "tags": [ "ai-import" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "x-routeInventory": { "file": "src/app/api/v1/ai-import/prompts/route.ts", "audience": "ai_import_helper", "authMode": "clerk_session", "minTier": "session", "operationClass": "write", "idempotencySupport": "session_helper_review", "tierChecked": true, "ownershipOrScopeChecked": true, "writeAuditFindings": [] } } }, "/auth/keys": { "get": { "operationId": "listOwnApiKeys", "summary": "List own API keys", "parameters": [ { "$ref": "#/components/parameters/RequestId" } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "401": { "$ref": "#/components/responses/Error" } } } }, "/auth/keys/{id}": { "patch": { "operationId": "updateOwnApiKey", "summary": "Rename key and/or update expiration", "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" } } }, "delete": { "operationId": "deleteOwnApiKey", "summary": "Soft-delete own API key", "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "401": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" } } } }, "/auth/me": { "get": { "operationId": "getAuthMe", "summary": "Get current API principal context", "parameters": [ { "$ref": "#/components/parameters/RequestId" } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "401": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } } } }, "/auth/register": { "post": { "operationId": "registerApiKey", "summary": "Create API key from Clerk session", "security": [], "parameters": [ { "$ref": "#/components/parameters/RequestId" } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" } } } }, "/auth/revoke": { "delete": { "operationId": "revokeOwnApiKey", "summary": "Revoke current API key", "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "401": { "$ref": "#/components/responses/Error" } } } }, "/auth/rotate": { "post": { "operationId": "rotateOwnApiKey", "summary": "Rotate current API key", "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "401": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" } } } }, "/bucket-lists": { "get": { "operationId": "getBucketLists", "summary": "List bucket list templates (filter: section)", "description": "List bucket list templates (filter: section)", "tags": [ "bucket-lists" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "401": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true } }, "/bucket-lists/{id}": { "get": { "operationId": "getBucketListsById", "summary": "Get bucket list with items", "description": "Get bucket list with items", "tags": [ "bucket-lists" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true } }, "/capabilities": { "get": { "operationId": "getApiCapabilities", "summary": "Get machine-readable API capabilities", "security": [], "parameters": [ { "$ref": "#/components/parameters/RequestId" } ], "responses": { "200": { "$ref": "#/components/responses/Success" } } } }, "/catalog/{section}/{catalogTable}/{catalogItemId}/research": { "get": { "operationId": "getCatalogBySectionByCatalogtableByCatalogitemidResearch", "summary": "Get aliases, structured source evidence, and media assets for any canonical catalog item", "description": "Get aliases, structured source evidence, and media assets for any canonical catalog item", "tags": [ "catalog" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "name": "section", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "catalogTable", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "catalogItemId", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true }, "put": { "operationId": "putCatalogBySectionByCatalogtableByCatalogitemidResearch", "summary": "Replace aliases, structured source evidence, and media assets for any canonical catalog item", "description": "Replace aliases, structured source evidence, and media assets for any canonical catalog item", "tags": [ "catalog" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" }, { "name": "section", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "catalogTable", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "catalogItemId", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } } }, "/catalog/{section}/{catalogTable}/{catalogItemId}/rich-content": { "get": { "operationId": "getCatalogBySectionByCatalogtableByCatalogitemidRichContent", "summary": "Get rich content such as Learn More About write-ups for any canonical catalog item", "description": "Get rich content such as Learn More About write-ups for any canonical catalog item", "tags": [ "catalog" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "name": "section", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "catalogTable", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "catalogItemId", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "contentType", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true }, "put": { "operationId": "putCatalogBySectionByCatalogtableByCatalogitemidRichContent", "summary": "Upsert rich content such as Learn More About write-ups for any canonical catalog item", "description": "Upsert rich content such as Learn More About write-ups for any canonical catalog item", "tags": [ "catalog" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" }, { "name": "section", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "catalogTable", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "catalogItemId", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } } }, "/catalog/research/coverage": { "post": { "operationId": "postCatalogResearchCoverage", "summary": "Return alias/source/media/Learn More coverage flags for a batch of catalog item targets", "description": "Return alias/source/media/Learn More coverage flags for a batch of catalog item targets", "tags": [ "catalog" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } } }, "/dream/items": { "post": { "operationId": "createDreamItem", "summary": "Create a dream item", "parameters": [ { "$ref": "#/components/parameters/IdempotencyKey" } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" } } }, "get": { "operationId": "getDreamItems", "summary": "List dream items", "description": "List dream items", "tags": [ "dream" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "name": "partnershipId", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "401": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true } }, "/dream/items/{id}": { "patch": { "operationId": "patchDreamItemsById", "summary": "Update dream item", "description": "Update dream item", "tags": [ "dream" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } }, "delete": { "operationId": "deleteDreamItemsById", "summary": "Remove dream item", "description": "Remove dream item", "tags": [ "dream" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "partnershipId", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true } }, "/dream/items/{id}/move": { "post": { "operationId": "postDreamItemsByIdMove", "summary": "Move dream item to list", "description": "Move dream item to list", "tags": [ "dream" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } } }, "/dream/items/{id}/toggle-complete": { "post": { "operationId": "postDreamItemsByIdToggleComplete", "summary": "Toggle dream item complete", "description": "Toggle dream item complete", "tags": [ "dream" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } } }, "/dream/lists": { "post": { "operationId": "createDreamList", "summary": "Create a dream list", "parameters": [ { "$ref": "#/components/parameters/IdempotencyKey" } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" } } }, "get": { "operationId": "getDreamLists", "summary": "List dream lists", "description": "List dream lists", "tags": [ "dream" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "name": "partnershipId", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "401": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true } }, "/dream/lists/{id}": { "get": { "operationId": "getDreamListsById", "summary": "Get dream list with stats", "description": "Get dream list with stats", "tags": [ "dream" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "partnershipId", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true }, "patch": { "operationId": "patchDreamListsById", "summary": "Update dream list", "description": "Update dream list", "tags": [ "dream" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } }, "delete": { "operationId": "deleteDreamListsById", "summary": "Remove dream list", "description": "Remove dream list", "tags": [ "dream" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "partnershipId", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true } }, "/dream/lists/{id}/history": { "get": { "operationId": "getDreamListsByIdHistory", "summary": "List private dream-list change history", "description": "List private dream-list change history", "tags": [ "dream" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "partnershipId", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true }, "post": { "operationId": "postDreamListsByIdHistory", "summary": "Record private dream-list change history", "description": "Record private dream-list change history", "tags": [ "dream" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } } }, "/dream/lists/{id}/workspace": { "get": { "operationId": "getDreamListsByIdWorkspace", "summary": "List private candidate workspace rows for items that should be in this bucket list", "description": "List private candidate workspace rows for items that should be in this bucket list", "tags": [ "dream" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true }, "post": { "operationId": "postDreamListsByIdWorkspace", "summary": "Import pasted/CSV/markdown candidate rows, including optional creatorNote and whyIncluded", "description": "Import pasted/CSV/markdown candidate rows, including optional creatorNote and whyIncluded", "tags": [ "dream" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } } }, "/dream/lists/{id}/workspace/{candidateId}": { "patch": { "operationId": "patchDreamListsByIdWorkspaceByCandidateid", "summary": "Update a private candidate workspace row, including creatorNote, whyIncluded, sources, and match status", "description": "Update a private candidate workspace row, including creatorNote, whyIncluded, sources, and match status", "tags": [ "dream" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "candidateId", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } } }, "/dream/lists/stats": { "get": { "operationId": "getDreamListsStats", "summary": "Dream list stats", "description": "Dream list stats", "tags": [ "dream" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "name": "partnershipId", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "401": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true } }, "/dream/templates": { "get": { "operationId": "getDreamTemplates", "summary": "List dream templates", "description": "List dream templates", "tags": [ "dream" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "401": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true } }, "/dream/templates/{id}": { "get": { "operationId": "getDreamTemplatesById", "summary": "Get dream template with items", "description": "Get dream template with items", "tags": [ "dream" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true } }, "/dream/templates/add-to-lists": { "post": { "operationId": "postDreamTemplatesAddToLists", "summary": "Add dream template to lists", "description": "Add dream template to lists", "tags": [ "dream" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } } }, "/dream/templates/categories": { "get": { "operationId": "getDreamTemplatesCategories", "summary": "Dream template categories", "description": "Dream template categories", "tags": [ "dream" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "401": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true } }, "/dream/templates/matches": { "get": { "operationId": "getDreamTemplatesMatches", "summary": "Matched dream templates", "description": "Matched dream templates", "tags": [ "dream" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "401": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true } }, "/dream/templates/vote": { "post": { "operationId": "postDreamTemplatesVote", "summary": "Vote on a dream template", "description": "Vote on a dream template", "tags": [ "dream" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } } }, "/explore/activities": { "post": { "operationId": "createExploreActivity", "summary": "Create an activity", "parameters": [ { "$ref": "#/components/parameters/IdempotencyKey" } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" } } }, "get": { "operationId": "getExploreActivities", "summary": "List activities", "description": "List activities", "tags": [ "explore" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "name": "partnershipId", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "401": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true } }, "/explore/activities/{id}": { "get": { "operationId": "getExploreActivitiesById", "summary": "Get activity", "description": "Get activity", "tags": [ "explore" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "partnershipId", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true }, "patch": { "operationId": "patchExploreActivitiesById", "summary": "Update activity", "description": "Update activity", "tags": [ "explore" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } }, "delete": { "operationId": "deleteExploreActivitiesById", "summary": "Remove activity", "description": "Remove activity", "tags": [ "explore" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "partnershipId", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true } }, "/explore/catalog": { "get": { "operationId": "getExploreCatalog", "summary": "Browse explore locations (paginated)", "description": "Browse explore locations (paginated)", "tags": [ "explore" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "401": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true } }, "/explore/day-trips": { "post": { "operationId": "createExploreDayTrip", "summary": "Create a day trip", "parameters": [ { "$ref": "#/components/parameters/IdempotencyKey" } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" } } }, "get": { "operationId": "getExploreDayTrips", "summary": "List day trips", "description": "List day trips", "tags": [ "explore" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "name": "partnershipId", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "401": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true } }, "/explore/day-trips/{id}": { "get": { "operationId": "getExploreDayTripsById", "summary": "Get day trip", "description": "Get day trip", "tags": [ "explore" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "partnershipId", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true }, "patch": { "operationId": "patchExploreDayTripsById", "summary": "Update day trip", "description": "Update day trip", "tags": [ "explore" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } }, "delete": { "operationId": "deleteExploreDayTripsById", "summary": "Remove day trip", "description": "Remove day trip", "tags": [ "explore" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "partnershipId", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true } }, "/explore/items": { "post": { "operationId": "createExploreItem", "summary": "Create an explore item", "parameters": [ { "$ref": "#/components/parameters/IdempotencyKey" } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" } } }, "get": { "operationId": "getExploreItems", "summary": "List explore items", "description": "List explore items", "tags": [ "explore" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "401": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true } }, "/explore/items/{id}": { "get": { "operationId": "getExploreItemsById", "summary": "Get explore item", "description": "Get explore item", "tags": [ "explore" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true }, "patch": { "operationId": "patchExploreItemsById", "summary": "Update explore item", "description": "Update explore item", "tags": [ "explore" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } }, "delete": { "operationId": "deleteExploreItemsById", "summary": "Remove explore item", "description": "Remove explore item", "tags": [ "explore" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true } }, "/explore/items/search": { "get": { "operationId": "getExploreItemsSearch", "summary": "Search explore items", "description": "Search explore items", "tags": [ "explore" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "name": "q", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "401": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true } }, "/explore/places": { "post": { "operationId": "createExplorePlace", "summary": "Create a place", "parameters": [ { "$ref": "#/components/parameters/IdempotencyKey" } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" } } }, "get": { "operationId": "getExplorePlaces", "summary": "List places", "description": "List places", "tags": [ "explore" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "name": "partnershipId", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "401": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true } }, "/explore/places/{id}": { "get": { "operationId": "getExplorePlacesById", "summary": "Get place", "description": "Get place", "tags": [ "explore" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "partnershipId", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true }, "patch": { "operationId": "patchExplorePlacesById", "summary": "Update place", "description": "Update place", "tags": [ "explore" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } }, "delete": { "operationId": "deleteExplorePlacesById", "summary": "Remove place", "description": "Remove place", "tags": [ "explore" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "partnershipId", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true } }, "/explore/visits": { "get": { "operationId": "getExploreVisits", "summary": "List visits", "description": "List visits", "tags": [ "explore" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "401": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true }, "post": { "operationId": "postExploreVisits", "summary": "Log a visit", "description": "Log a visit", "tags": [ "explore" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } } }, "/explore/visits/{id}": { "patch": { "operationId": "patchExploreVisitsById", "summary": "Update a visit", "description": "Update a visit", "tags": [ "explore" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } }, "delete": { "operationId": "deleteExploreVisitsById", "summary": "Remove a visit", "description": "Remove a visit", "tags": [ "explore" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true } }, "/explore/visits/stats": { "get": { "operationId": "getExploreVisitsStats", "summary": "Visit stats", "description": "Visit stats", "tags": [ "explore" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "401": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true } }, "/grow/catalog": { "get": { "operationId": "getGrowCatalog", "summary": "Browse project templates", "description": "Browse project templates", "tags": [ "grow" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "401": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true } }, "/listen/catalog": { "get": { "operationId": "getListenCatalog", "summary": "Browse listen catalog", "description": "Browse listen catalog", "tags": [ "listen" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "401": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true } }, "/listen/catalog/categories": { "get": { "operationId": "getListenCatalogCategories", "summary": "List listen categories", "description": "List listen categories", "tags": [ "listen" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "401": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true } }, "/listen/catalog/search": { "get": { "operationId": "getListenCatalogSearch", "summary": "Search listen catalog", "description": "Search listen catalog", "tags": [ "listen" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "name": "q", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "401": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true } }, "/listen/list": { "post": { "operationId": "createListenListItem", "summary": "Create a listen list item", "parameters": [ { "$ref": "#/components/parameters/IdempotencyKey" } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" } } }, "get": { "operationId": "getListenList", "summary": "List listening entries", "description": "List listening entries", "tags": [ "listen" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "name": "partnershipId", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "401": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true } }, "/listen/list/{id}": { "patch": { "operationId": "patchListenListById", "summary": "Update listening entry", "description": "Update listening entry", "tags": [ "listen" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } }, "delete": { "operationId": "deleteListenListById", "summary": "Remove listening entry", "description": "Remove listening entry", "tags": [ "listen" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "partnershipId", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true } }, "/listen/list/stats": { "get": { "operationId": "getListenListStats", "summary": "Listening stats", "description": "Listening stats", "tags": [ "listen" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "name": "partnershipId", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "401": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true } }, "/listen/lists": { "get": { "operationId": "getListenLists", "summary": "List curated listen lists", "description": "List curated listen lists", "tags": [ "listen" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "401": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true } }, "/listen/lists/slug/{slug}": { "get": { "operationId": "getListenListsSlugBySlug", "summary": "Get curated listen list by slug", "description": "Get curated listen list by slug", "tags": [ "listen" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "name": "slug", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true } }, "/listen/matches": { "get": { "operationId": "getListenMatches", "summary": "Get matched listen items", "description": "Get matched listen items", "tags": [ "listen" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "name": "partnershipId", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "401": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true } }, "/listen/votes": { "get": { "operationId": "getListenVotes", "summary": "List listen votes", "description": "List listen votes", "tags": [ "listen" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "name": "partnershipId", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "401": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true }, "post": { "operationId": "postListenVotes", "summary": "Vote on a listen item", "description": "Vote on a listen item", "tags": [ "listen" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } } }, "/me": { "get": { "operationId": "getApiMe", "summary": "Get current user profile and partnerships", "parameters": [ { "$ref": "#/components/parameters/RequestId" } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "401": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } } } }, "/openapi": { "get": { "operationId": "getApiOpenApi", "summary": "Get OpenAPI v1 JSON spec", "security": [], "parameters": [ { "$ref": "#/components/parameters/RequestId" } ], "responses": { "200": { "$ref": "#/components/responses/Success" } } } }, "/partnerships": { "get": { "operationId": "getPartnerships", "summary": "List my partnerships", "description": "List my partnerships", "tags": [ "partnerships" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true } }, "/partnerships/{id}/completions": { "post": { "operationId": "createCompletion", "summary": "Create a partnership completion", "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" } } }, "get": { "operationId": "getPartnershipsByIdCompletions", "summary": "Get completions for a partnership", "description": "Get completions for a partnership", "tags": [ "partnerships" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true } }, "/play/catalog": { "get": { "operationId": "getPlayCatalog", "summary": "Browse game catalog (filters: category, subcategory, page, pageSize)", "description": "Browse game catalog (filters: category, subcategory, page, pageSize)", "tags": [ "play" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "401": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true } }, "/play/catalog/search": { "get": { "operationId": "getPlayCatalogSearch", "summary": "Search games", "description": "Search games", "tags": [ "play" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "name": "q", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "401": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true } }, "/play/game-nights": { "get": { "operationId": "getPlayGameNights", "summary": "List game nights", "description": "List game nights", "tags": [ "play" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "401": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true }, "post": { "operationId": "postPlayGameNights", "summary": "Create a game night", "description": "Create a game night", "tags": [ "play" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } } }, "/play/game-nights/{id}/games": { "post": { "operationId": "postPlayGameNightsByIdGames", "summary": "Add a game to a night", "description": "Add a game to a night", "tags": [ "play" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } } }, "/play/list": { "post": { "operationId": "createPlayListItem", "summary": "Create a play list item", "parameters": [ { "$ref": "#/components/parameters/IdempotencyKey" } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" } } }, "get": { "operationId": "getPlayList", "summary": "List gaming collection", "description": "List gaming collection", "tags": [ "play" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "name": "partnershipId", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "401": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true } }, "/play/list/{id}": { "patch": { "operationId": "patchPlayListById", "summary": "Update gaming entry", "description": "Update gaming entry", "tags": [ "play" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } }, "delete": { "operationId": "deletePlayListById", "summary": "agent or user endpoint; auth: bearer_api_key; minimum tier: personal", "description": "agent or user endpoint; auth: bearer_api_key; minimum tier: personal", "tags": [ "play" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "x-routeInventory": { "file": "src/app/api/v1/play/list/[id]/route.ts", "audience": "agent_or_user", "authMode": "bearer_api_key", "minTier": "personal", "operationClass": "destructive_write", "idempotencySupport": "missing_or_unknown", "tierChecked": true, "ownershipOrScopeChecked": true, "writeAuditFindings": [ "bearer-write-idempotency-review" ] } } }, "/play/list/{id}/record-play": { "post": { "operationId": "postPlayListByIdRecordPlay", "summary": "Record a play session", "description": "Record a play session", "tags": [ "play" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } } }, "/play/matches": { "get": { "operationId": "getPlayMatches", "summary": "Get matched games", "description": "Get matched games", "tags": [ "play" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "name": "partnershipId", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "401": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true } }, "/play/stats": { "get": { "operationId": "getPlayStats", "summary": "Gaming stats", "description": "Gaming stats", "tags": [ "play" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "name": "partnershipId", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "401": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true } }, "/play/votes": { "get": { "operationId": "getPlayVotes", "summary": "List game votes", "description": "List game votes", "tags": [ "play" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "name": "partnershipId", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "401": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true }, "post": { "operationId": "postPlayVotes", "summary": "Vote on a game", "description": "Vote on a game", "tags": [ "play" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } } }, "/read/catalog": { "get": { "operationId": "getReadCatalog", "summary": "Browse book catalog", "description": "Browse book catalog", "tags": [ "read" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "401": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true } }, "/read/catalog/categories": { "get": { "operationId": "getReadCatalogCategories", "summary": "List book categories", "description": "List book categories", "tags": [ "read" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "401": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true } }, "/read/catalog/search": { "get": { "operationId": "getReadCatalogSearch", "summary": "Search books", "description": "Search books", "tags": [ "read" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "name": "q", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "401": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true } }, "/read/list": { "post": { "operationId": "createReadListItem", "summary": "Create a read list item", "parameters": [ { "$ref": "#/components/parameters/IdempotencyKey" } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" } } }, "get": { "operationId": "getReadList", "summary": "List reading entries", "description": "List reading entries", "tags": [ "read" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "name": "partnershipId", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "401": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true } }, "/read/list/{id}": { "patch": { "operationId": "patchReadListById", "summary": "Update reading entry", "description": "Update reading entry", "tags": [ "read" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } }, "delete": { "operationId": "deleteReadListById", "summary": "agent or user endpoint; auth: bearer_api_key; minimum tier: personal", "description": "agent or user endpoint; auth: bearer_api_key; minimum tier: personal", "tags": [ "read" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "x-routeInventory": { "file": "src/app/api/v1/read/list/[id]/route.ts", "audience": "agent_or_user", "authMode": "bearer_api_key", "minTier": "personal", "operationClass": "destructive_write", "idempotencySupport": "missing_or_unknown", "tierChecked": true, "ownershipOrScopeChecked": true, "writeAuditFindings": [ "bearer-write-idempotency-review" ] } } }, "/read/list/stats": { "get": { "operationId": "getReadListStats", "summary": "Reading stats", "description": "Reading stats", "tags": [ "read" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "name": "partnershipId", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "401": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true } }, "/read/lists": { "get": { "operationId": "getReadLists", "summary": "List curated book lists", "description": "List curated book lists", "tags": [ "read" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "401": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true } }, "/read/lists/{id}": { "get": { "operationId": "getReadListsById", "summary": "Get curated book list", "description": "Get curated book list", "tags": [ "read" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true } }, "/read/lists/slug/{slug}": { "get": { "operationId": "getReadListsSlugBySlug", "summary": "Get curated book list by slug", "description": "Get curated book list by slug", "tags": [ "read" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "name": "slug", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true } }, "/read/matches": { "get": { "operationId": "getReadMatches", "summary": "Get matched books", "description": "Get matched books", "tags": [ "read" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "name": "partnershipId", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "401": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true } }, "/read/votes": { "get": { "operationId": "getReadVotes", "summary": "List book votes", "description": "List book votes", "tags": [ "read" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "name": "partnershipId", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "401": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true }, "post": { "operationId": "postReadVotes", "summary": "Vote on a book", "description": "Vote on a book", "tags": [ "read" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } } }, "/search": { "get": { "operationId": "getSearch", "summary": "Cross-section search", "description": "Cross-section search", "tags": [ "search" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "name": "q", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "sections", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "401": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true } }, "/talk/questions": { "get": { "operationId": "getTalkQuestions", "summary": "Browse conversation questions", "description": "Browse conversation questions", "tags": [ "talk" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "401": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true }, "post": { "operationId": "postTalkQuestions", "summary": "Create a question", "description": "Create a question", "tags": [ "talk" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } } }, "/talk/questions/{id}": { "get": { "operationId": "getTalkQuestionsById", "summary": "Get question", "description": "Get question", "tags": [ "talk" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true }, "patch": { "operationId": "patchTalkQuestionsById", "summary": "Update question", "description": "Update question", "tags": [ "talk" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } }, "delete": { "operationId": "deleteTalkQuestionsById", "summary": "Remove question", "description": "Remove question", "tags": [ "talk" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true } }, "/talk/questions/{id}/discussed": { "post": { "operationId": "postTalkQuestionsByIdDiscussed", "summary": "Mark discussed", "description": "Mark discussed", "tags": [ "talk" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } }, "delete": { "operationId": "deleteTalkQuestionsByIdDiscussed", "summary": "Unmark discussed", "description": "Unmark discussed", "tags": [ "talk" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true } }, "/talk/questions/{id}/heart": { "post": { "operationId": "postTalkQuestionsByIdHeart", "summary": "Toggle question heart", "description": "Toggle question heart", "tags": [ "talk" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } } }, "/talk/questions/categories": { "get": { "operationId": "getTalkQuestionsCategories", "summary": "List question categories", "description": "List question categories", "tags": [ "talk" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "401": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true } }, "/talk/questions/random": { "get": { "operationId": "getTalkQuestionsRandom", "summary": "Get random question", "description": "Get random question", "tags": [ "talk" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "401": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true } }, "/usage": { "get": { "operationId": "getCurrentApiUsage", "summary": "Get current key usage, limits, and effective access", "parameters": [ { "$ref": "#/components/parameters/RequestId" } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "401": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } } } }, "/watch/catalog/search": { "get": { "operationId": "getWatchCatalogSearch", "summary": "Search movies/TV via TMDB", "description": "Search movies/TV via TMDB", "tags": [ "watch" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "name": "q", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "401": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true } }, "/watch/list": { "post": { "operationId": "createWatchListItem", "summary": "Create a watch list item", "parameters": [ { "$ref": "#/components/parameters/IdempotencyKey" } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" } } }, "get": { "operationId": "getWatchList", "summary": "List watchlist items", "description": "List watchlist items", "tags": [ "watch" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "name": "partnershipId", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "401": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true } }, "/watch/list/{id}": { "get": { "operationId": "getWatchListById", "summary": "Get watchlist item", "description": "Get watchlist item", "tags": [ "watch" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "partnershipId", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true }, "delete": { "operationId": "deleteWatchListById", "summary": "Remove from watchlist", "description": "Remove from watchlist", "tags": [ "watch" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "partnershipId", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true } }, "/watch/list/{id}/heart": { "post": { "operationId": "postWatchListByIdHeart", "summary": "Set heart level", "description": "Set heart level", "tags": [ "watch" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } } }, "/watch/list/{id}/notes": { "patch": { "operationId": "patchWatchListByIdNotes", "summary": "Update notes", "description": "Update notes", "tags": [ "watch" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } } }, "/watch/list/{id}/rating": { "post": { "operationId": "postWatchListByIdRating", "summary": "Set rating", "description": "Set rating", "tags": [ "watch" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } } }, "/watch/list/{id}/seen-before": { "post": { "operationId": "postWatchListByIdSeenBefore", "summary": "Set seen-before status", "description": "Set seen-before status", "tags": [ "watch" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } } }, "/watch/list/{id}/watched": { "post": { "operationId": "postWatchListByIdWatched", "summary": "Mark as watched", "description": "Mark as watched", "tags": [ "watch" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "$ref": "#/components/parameters/IdempotencyKey" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "400": { "$ref": "#/components/responses/Error" }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "409": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } } }, "/watch/stats": { "get": { "operationId": "getWatchStats", "summary": "Watch stats", "description": "Watch stats", "tags": [ "watch" ], "parameters": [ { "$ref": "#/components/parameters/RequestId" }, { "name": "partnershipId", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Success" }, "401": { "$ref": "#/components/responses/Error" }, "429": { "$ref": "#/components/responses/Error" } }, "x-generatedFromDiscovery": true } } } }