{ "openapi": "3.1.0", "info": { "title": "Hydrogen API", "description": "Documentation générée depuis `config/routes.php`. La référence détaillée (corps de requête, codes d'erreur) reste dans `docs/api.md`.", "version": "1.0.0" }, "servers": [ { "url": "http://hydrogen.dev.com", "description": "Serveur courant (APP_URL)" } ], "components": { "securitySchemes": { "bearerAuth": { "type": "http", "scheme": "bearer", "bearerFormat": "session-token", "description": "Jeton de session utilisateur (Authorization: Bearer …)." }, "adminToken": { "type": "http", "scheme": "bearer", "description": "Jeton admin statique ADMIN_API_TOKEN (service-to-service)." }, "staffToken": { "type": "http", "scheme": "bearer", "description": "Jeton back-office nominatif (login /admin/staff)." } } }, "paths": { "/admin/audit": { "get": { "operationId": "getAuditLog", "summary": "Get audit log", "tags": [ "admin: audit" ], "parameters": [ { "name": "cursorId", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "from", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "method", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "operator", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "pathPrefix", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "status", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "to", "in": "query", "required": false, "schema": { "type": "string" } } ], "security": [ { "adminToken": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" } } } }, "/admin/badge-categories": { "get": { "operationId": "listBadgeCategories", "summary": "List badge categories", "tags": [ "admin: badge-categories" ], "security": [ { "adminToken": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" } } }, "post": { "operationId": "createBadgeCategory", "summary": "Create badge category", "tags": [ "admin: badge-categories" ], "security": [ { "adminToken": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" }, "422": { "description": "Validation error" } } } }, "/admin/badge-categories/{slug}": { "get": { "operationId": "getBadgeCategory", "summary": "Get badge category", "tags": [ "admin: badge-categories" ], "parameters": [ { "name": "slug", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[a-z0-9-]{1,64}$" } } ], "security": [ { "adminToken": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" }, "404": { "description": "Not found" } } }, "put": { "operationId": "updateBadgeCategory", "summary": "Update badge category", "tags": [ "admin: badge-categories" ], "parameters": [ { "name": "slug", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[a-z0-9-]{1,64}$" } } ], "security": [ { "adminToken": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } }, "delete": { "operationId": "deleteBadgeCategory", "summary": "Delete badge category", "tags": [ "admin: badge-categories" ], "parameters": [ { "name": "slug", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[a-z0-9-]{1,64}$" } } ], "security": [ { "adminToken": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } } }, "/admin/badges": { "get": { "operationId": "listAdminBadges", "summary": "List admin badges", "tags": [ "admin: badges" ], "security": [ { "adminToken": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" } } }, "post": { "operationId": "createBadge", "summary": "Create badge", "tags": [ "admin: badges" ], "security": [ { "adminToken": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" }, "422": { "description": "Validation error" } } } }, "/admin/badges/{slug}": { "get": { "operationId": "getAdminBadge", "summary": "Get admin badge", "tags": [ "admin: badges" ], "parameters": [ { "name": "slug", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[a-z0-9-]{1,64}$" } } ], "security": [ { "adminToken": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" }, "404": { "description": "Not found" } } }, "put": { "operationId": "updateBadge", "summary": "Update badge", "tags": [ "admin: badges" ], "parameters": [ { "name": "slug", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[a-z0-9-]{1,64}$" } } ], "security": [ { "adminToken": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } }, "delete": { "operationId": "deleteBadge", "summary": "Delete badge", "tags": [ "admin: badges" ], "parameters": [ { "name": "slug", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[a-z0-9-]{1,64}$" } } ], "security": [ { "adminToken": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } } }, "/admin/badges/{slug}/icons/{slot}": { "post": { "operationId": "uploadBadgeIcon", "summary": "Upload badge icon", "tags": [ "admin: badges" ], "parameters": [ { "name": "slug", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[a-z0-9-]{1,64}$" } }, { "name": "slot", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^locked|[1-5]$" } } ], "security": [ { "adminToken": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } }, "delete": { "operationId": "deleteBadgeIcon", "summary": "Delete badge icon", "tags": [ "admin: badges" ], "parameters": [ { "name": "slug", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[a-z0-9-]{1,64}$" } }, { "name": "slot", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^locked|[1-5]$" } } ], "security": [ { "adminToken": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } } }, "/admin/badges/{slug}/translations/{locale}": { "get": { "operationId": "getBadgeTranslation", "summary": "Get badge translation", "tags": [ "admin: badges" ], "parameters": [ { "name": "slug", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[a-z0-9-]{1,64}$" } }, { "name": "locale", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[a-z]{2}-[A-Z]{2}$" } } ], "security": [ { "adminToken": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" }, "404": { "description": "Not found" } } }, "put": { "operationId": "putBadgeTranslation", "summary": "Put badge translation", "tags": [ "admin: badges" ], "parameters": [ { "name": "slug", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[a-z0-9-]{1,64}$" } }, { "name": "locale", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[a-z]{2}-[A-Z]{2}$" } } ], "security": [ { "adminToken": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } }, "delete": { "operationId": "deleteBadgeTranslation", "summary": "Delete badge translation", "tags": [ "admin: badges" ], "parameters": [ { "name": "slug", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[a-z0-9-]{1,64}$" } }, { "name": "locale", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[a-z]{2}-[A-Z]{2}$" } } ], "security": [ { "adminToken": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } } }, "/admin/brands": { "get": { "operationId": "listAdminBrands", "summary": "List admin brands", "tags": [ "admin: brands" ], "security": [ { "adminToken": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" } } }, "post": { "operationId": "createBrand", "summary": "Create brand", "tags": [ "admin: brands" ], "security": [ { "adminToken": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" }, "422": { "description": "Validation error" } } } }, "/admin/brands/{id}": { "get": { "operationId": "getAdminBrand", "summary": "Get admin brand", "tags": [ "admin: brands" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[0-9]+$" } } ], "security": [ { "adminToken": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" }, "404": { "description": "Not found" } } }, "put": { "operationId": "updateBrand", "summary": "Update brand", "tags": [ "admin: brands" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[0-9]+$" } } ], "security": [ { "adminToken": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } }, "delete": { "operationId": "deleteBrand", "summary": "Delete brand", "tags": [ "admin: brands" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[0-9]+$" } } ], "security": [ { "adminToken": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } } }, "/admin/brands/{id}/editorial/{locale}": { "get": { "operationId": "getBrandEditorial", "summary": "Get brand editorial", "tags": [ "admin: brands" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[0-9]+$" } }, { "name": "locale", "in": "path", "required": true, "schema": { "type": "string" } } ], "security": [ { "adminToken": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" }, "404": { "description": "Not found" } } }, "put": { "operationId": "putBrandEditorial", "summary": "Put brand editorial", "tags": [ "admin: brands" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[0-9]+$" } }, { "name": "locale", "in": "path", "required": true, "schema": { "type": "string" } } ], "security": [ { "adminToken": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } }, "delete": { "operationId": "deleteBrandEditorial", "summary": "Delete brand editorial", "tags": [ "admin: brands" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[0-9]+$" } }, { "name": "locale", "in": "path", "required": true, "schema": { "type": "string" } } ], "security": [ { "adminToken": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } } }, "/admin/brands/{id}/images/{type}/{mode}": { "post": { "operationId": "uploadBrandImage", "summary": "Upload brand image", "tags": [ "admin: brands" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[0-9]+$" } }, { "name": "type", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^icon|logo$" } }, { "name": "mode", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^light|dark|monochrome$" } } ], "security": [ { "adminToken": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } }, "delete": { "operationId": "deleteBrandImage", "summary": "Delete brand image", "tags": [ "admin: brands" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[0-9]+$" } }, { "name": "type", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^icon|logo$" } }, { "name": "mode", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^light|dark|monochrome$" } } ], "security": [ { "adminToken": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } } }, "/admin/cache/purge": { "post": { "operationId": "purgeGlideCache", "summary": "Purge glide cache", "tags": [ "admin: cache" ], "parameters": [ { "name": "delete", "in": "query", "required": false, "schema": { "type": "string" } } ], "security": [ { "adminToken": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" }, "422": { "description": "Validation error" } } } }, "/admin/cities/{id}": { "get": { "operationId": "getAdminCity", "summary": "Get admin city", "tags": [ "admin: cities" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$" } } ], "security": [ { "adminToken": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" }, "404": { "description": "Not found" } } } }, "/admin/comments/recent": { "get": { "operationId": "listRecentComments", "summary": "List recent comments", "tags": [ "admin: comments" ], "parameters": [ { "name": "cursorAt", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "cursorId", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "string" } } ], "security": [ { "adminToken": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" } } } }, "/admin/comments/stats": { "get": { "operationId": "getCommentStats", "summary": "Get comment stats", "tags": [ "admin: comments" ], "parameters": [ { "name": "days", "in": "query", "required": false, "schema": { "type": "integer" } } ], "security": [ { "adminToken": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" } } } }, "/admin/comments/{hex}": { "get": { "operationId": "getComment", "summary": "Get comment", "tags": [ "admin: comments" ], "parameters": [ { "name": "hex", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[0-9a-f]{32}$" } } ], "security": [ { "adminToken": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" }, "404": { "description": "Not found" } } }, "delete": { "operationId": "deleteComment", "summary": "Delete comment", "tags": [ "admin: comments" ], "parameters": [ { "name": "hex", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[0-9a-f]{32}$" } } ], "security": [ { "adminToken": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } } }, "/admin/comments/{hex}/censor": { "post": { "operationId": "censorComment", "summary": "Censor comment", "tags": [ "admin: comments" ], "parameters": [ { "name": "hex", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[0-9a-f]{32}$" } } ], "security": [ { "adminToken": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } } }, "/admin/comments/{hex}/reports": { "get": { "operationId": "listCommentReports", "summary": "List comment reports", "tags": [ "admin: comments" ], "parameters": [ { "name": "hex", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[0-9a-f]{32}$" } } ], "security": [ { "adminToken": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" }, "404": { "description": "Not found" } } } }, "/admin/comments/{hex}/restore": { "post": { "operationId": "restoreComment", "summary": "Restore comment", "tags": [ "admin: comments" ], "parameters": [ { "name": "hex", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[0-9a-f]{32}$" } } ], "security": [ { "adminToken": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } } }, "/admin/countries": { "post": { "operationId": "createCountry", "summary": "Create country", "tags": [ "admin: countries" ], "security": [ { "adminToken": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" }, "422": { "description": "Validation error" } } } }, "/admin/countries/{code}": { "get": { "operationId": "getAdminCountry", "summary": "Get admin country", "tags": [ "admin: countries" ], "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[a-zA-Z]{2,3}$" } } ], "security": [ { "adminToken": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" }, "404": { "description": "Not found" } } }, "put": { "operationId": "updateCountry", "summary": "Update country", "tags": [ "admin: countries" ], "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[a-zA-Z]{2}$" } } ], "security": [ { "adminToken": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } }, "delete": { "operationId": "deleteCountry", "summary": "Delete country", "tags": [ "admin: countries" ], "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[a-zA-Z]{2}$" } } ], "security": [ { "adminToken": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } } }, "/admin/countries/{code}/content/{locale}": { "get": { "operationId": "getCountryContent", "summary": "Get country content", "tags": [ "admin: countries" ], "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[a-zA-Z]{2,3}$" } }, { "name": "locale", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[a-z]{2}-[A-Z]{2}$" } } ], "security": [ { "adminToken": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" }, "404": { "description": "Not found" } } }, "put": { "operationId": "putCountryContent", "summary": "Put country content", "tags": [ "admin: countries" ], "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[a-zA-Z]{2,3}$" } }, { "name": "locale", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[a-z]{2}-[A-Z]{2}$" } } ], "security": [ { "adminToken": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } }, "delete": { "operationId": "deleteCountryContent", "summary": "Delete country content", "tags": [ "admin: countries" ], "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[a-zA-Z]{2,3}$" } }, { "name": "locale", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[a-z]{2}-[A-Z]{2}$" } } ], "security": [ { "adminToken": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } } }, "/admin/countries/{code}/description/{locale}": { "get": { "operationId": "getCountryDescription", "summary": "Get country description", "tags": [ "admin: countries" ], "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[a-zA-Z]{2,3}$" } }, { "name": "locale", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[a-z]{2}-[A-Z]{2}$" } } ], "security": [ { "adminToken": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" }, "404": { "description": "Not found" } } }, "put": { "operationId": "putCountryDescription", "summary": "Put country description", "tags": [ "admin: countries" ], "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[a-zA-Z]{2,3}$" } }, { "name": "locale", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[a-z]{2}-[A-Z]{2}$" } } ], "security": [ { "adminToken": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } }, "delete": { "operationId": "deleteCountryDescription", "summary": "Delete country description", "tags": [ "admin: countries" ], "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[a-zA-Z]{2,3}$" } }, { "name": "locale", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[a-z]{2}-[A-Z]{2}$" } } ], "security": [ { "adminToken": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } } }, "/admin/coupons": { "post": { "operationId": "createCoupon", "summary": "Create coupon", "tags": [ "admin: coupons" ], "security": [ { "adminToken": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" }, "422": { "description": "Validation error" } } }, "get": { "operationId": "listCoupons", "summary": "List coupons", "tags": [ "admin: coupons" ], "parameters": [ { "name": "cursorAt", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "cursorId", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "string" } } ], "security": [ { "adminToken": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" } } } }, "/admin/coupons/{id}": { "get": { "operationId": "getCoupon", "summary": "Get coupon", "tags": [ "admin: coupons" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[A-Za-z0-9._-]{1,32}$" } } ], "security": [ { "adminToken": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" }, "404": { "description": "Not found" } } }, "put": { "operationId": "updateCoupon", "summary": "Update coupon", "tags": [ "admin: coupons" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[A-Za-z0-9._-]{1,32}$" } } ], "security": [ { "adminToken": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } }, "delete": { "operationId": "deleteCoupon", "summary": "Delete coupon", "tags": [ "admin: coupons" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[A-Za-z0-9._-]{1,32}$" } } ], "security": [ { "adminToken": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } } }, "/admin/coupons/{id}/redemptions": { "get": { "operationId": "listCouponRedemptions", "summary": "List coupon redemptions", "tags": [ "admin: coupons" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[A-Za-z0-9._-]{1,32}$" } }, { "name": "cursorAt", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "cursorUserId", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "string" } } ], "security": [ { "adminToken": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" }, "404": { "description": "Not found" } } } }, "/admin/currencies": { "get": { "operationId": "listCurrencies", "summary": "List currencies", "tags": [ "admin: currencies" ], "parameters": [ { "name": "activeOnly", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } } } }, "post": { "operationId": "createCurrency", "summary": "Create currency", "tags": [ "admin: currencies" ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "422": { "description": "Validation error" } } } }, "/admin/currencies/{code}": { "get": { "operationId": "getCurrency", "summary": "Get currency", "tags": [ "admin: currencies" ], "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[A-Za-z0-9_]{2,12}$" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "404": { "description": "Not found" } } }, "put": { "operationId": "updateCurrency", "summary": "Update currency", "tags": [ "admin: currencies" ], "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[A-Za-z0-9_]{2,12}$" } } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } }, "delete": { "operationId": "deleteCurrency", "summary": "Delete currency", "tags": [ "admin: currencies" ], "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[A-Za-z0-9_]{2,12}$" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } } }, "/admin/documents": { "get": { "operationId": "listDocuments_2", "summary": "List documents", "tags": [ "admin: documents" ], "parameters": [ { "name": "category", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } } } }, "post": { "operationId": "createDocument", "summary": "Create document", "tags": [ "admin: documents" ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "422": { "description": "Validation error" } } } }, "/admin/documents/{slug}": { "get": { "operationId": "getDocument_2", "summary": "Get document", "tags": [ "admin: documents" ], "parameters": [ { "name": "slug", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[a-z0-9-]{1,80}$" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "404": { "description": "Not found" } } }, "patch": { "operationId": "updateDocument", "summary": "Update document", "tags": [ "admin: documents" ], "parameters": [ { "name": "slug", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[a-z0-9-]{1,80}$" } } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } }, "delete": { "operationId": "deleteDocument", "summary": "Delete document", "tags": [ "admin: documents" ], "parameters": [ { "name": "slug", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[a-z0-9-]{1,80}$" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } } }, "/admin/documents/{slug}/translations/{locale}": { "get": { "operationId": "getDocumentTranslation", "summary": "Get document translation", "tags": [ "admin: documents" ], "parameters": [ { "name": "slug", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[a-z0-9-]{1,80}$" } }, { "name": "locale", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[a-z]{2}-[A-Z]{2}$" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "404": { "description": "Not found" } } }, "put": { "operationId": "putDocumentTranslation", "summary": "Put document translation", "tags": [ "admin: documents" ], "parameters": [ { "name": "slug", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[a-z0-9-]{1,80}$" } }, { "name": "locale", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[a-z]{2}-[A-Z]{2}$" } } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } }, "delete": { "operationId": "deleteDocumentTranslation", "summary": "Delete document translation", "tags": [ "admin: documents" ], "parameters": [ { "name": "slug", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[a-z0-9-]{1,80}$" } }, { "name": "locale", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[a-z]{2}-[A-Z]{2}$" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } } }, "/admin/documents/{slug}/translations/{locale}/revisions": { "get": { "operationId": "listDocumentRevisions", "summary": "List document revisions", "tags": [ "admin: documents" ], "parameters": [ { "name": "slug", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[a-z0-9-]{1,80}$" } }, { "name": "locale", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[a-z]{2}-[A-Z]{2}$" } }, { "name": "before", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "404": { "description": "Not found" } } } }, "/admin/establishments/{id}": { "get": { "operationId": "getAdminEstablishment", "summary": "Get admin establishment", "tags": [ "admin: establishments" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[a-f0-9]{32}$" } } ], "security": [ { "adminToken": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" }, "404": { "description": "Not found" } } } }, "/admin/health": { "get": { "operationId": "getHealth", "summary": "Get health", "tags": [ "admin: health" ], "security": [ { "adminToken": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" } } } }, "/admin/jobs/cleanup-orphan-files": { "post": { "operationId": "cleanupOrphanFiles", "summary": "Cleanup orphan files", "tags": [ "admin: jobs" ], "parameters": [ { "name": "delete", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } } ], "security": [ { "adminToken": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" }, "422": { "description": "Validation error" } } } }, "/admin/jobs/describe-queue": { "get": { "operationId": "getDescribeQueue", "summary": "Get describe queue", "tags": [ "admin: jobs" ], "security": [ { "adminToken": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" } } } }, "/admin/jobs/describe-queue/requeue": { "post": { "operationId": "requeueDescribe", "summary": "Requeue describe", "tags": [ "admin: jobs" ], "security": [ { "adminToken": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" }, "422": { "description": "Validation error" } } } }, "/admin/jobs/flush/{job}": { "post": { "operationId": "flushJob", "summary": "Flush job", "tags": [ "admin: jobs" ], "parameters": [ { "name": "job", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^counters|notifications|tracking$" } } ], "security": [ { "adminToken": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } } }, "/admin/ledger/entries": { "get": { "operationId": "listLedgerEntries", "summary": "List ledger entries", "tags": [ "admin: ledger" ], "parameters": [ { "name": "currency", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "event", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "from", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "to", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "type", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "user", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } } } }, "post": { "operationId": "createLedgerEntry", "summary": "Create ledger entry", "tags": [ "admin: ledger" ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "422": { "description": "Validation error" } } } }, "/admin/ledger/entries/{id}/reverse": { "post": { "operationId": "reverseLedgerEntry", "summary": "Reverse ledger entry", "tags": [ "admin: ledger" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } } }, "/admin/maintenance": { "get": { "operationId": "getMaintenanceStatus", "summary": "Get maintenance status", "tags": [ "admin: maintenance" ], "security": [ { "adminToken": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" } } }, "put": { "operationId": "setMaintenance", "summary": "Set maintenance", "tags": [ "admin: maintenance" ], "security": [ { "adminToken": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" }, "422": { "description": "Validation error" } } } }, "/admin/media/backfill-biome": { "post": { "operationId": "backfillMediaBiome", "summary": "Backfill media biome", "tags": [ "admin: media" ], "parameters": [ { "name": "batchSize", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string" } } ], "security": [ { "adminToken": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" }, "422": { "description": "Validation error" } } } }, "/admin/media/backfill-geo": { "post": { "operationId": "backfillMediaGeo", "summary": "Backfill media geo", "tags": [ "admin: media" ], "parameters": [ { "name": "batchSize", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string" } } ], "security": [ { "adminToken": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" }, "422": { "description": "Validation error" } } } }, "/admin/media/describe": { "post": { "operationId": "describeMedia", "summary": "Describe media", "tags": [ "admin: media" ], "security": [ { "adminToken": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" }, "422": { "description": "Validation error" } } } }, "/admin/media/recent": { "get": { "operationId": "getRecentMedia", "summary": "Get recent media", "tags": [ "admin: media" ], "parameters": [ { "name": "cursorAt", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "cursorId", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } } ], "security": [ { "adminToken": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" } } } }, "/admin/media/reindex-all": { "post": { "operationId": "reindexAllMedia", "summary": "Reindex all media", "tags": [ "admin: media" ], "parameters": [ { "name": "batchSize", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string" } } ], "security": [ { "adminToken": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" }, "422": { "description": "Validation error" } } } }, "/admin/media/stats": { "get": { "operationId": "getAdminMediaStats", "summary": "Get admin media stats", "tags": [ "admin: media" ], "parameters": [ { "name": "days", "in": "query", "required": false, "schema": { "type": "integer" } } ], "security": [ { "adminToken": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" } } } }, "/admin/media/stats/cameras": { "get": { "operationId": "getAdminMediaCameraStats", "summary": "Get admin media camera stats", "tags": [ "admin: media" ], "parameters": [ { "name": "brand", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } } ], "security": [ { "adminToken": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" } } } }, "/admin/media/stats/countries": { "get": { "operationId": "getMediaCountryTrends", "summary": "Get media country trends", "tags": [ "admin: media" ], "parameters": [ { "name": "country", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "days", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } } ], "security": [ { "adminToken": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" } } } }, "/admin/media/without-geo": { "get": { "operationId": "getMediaWithoutGeo", "summary": "Get media without geo", "tags": [ "admin: media" ], "parameters": [ { "name": "batchSize", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string" } } ], "security": [ { "adminToken": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" } } } }, "/admin/media/{hex}": { "get": { "operationId": "getAdminMedia", "summary": "Get admin media", "tags": [ "admin: media" ], "parameters": [ { "name": "hex", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[0-9a-f]{32}$" } } ], "security": [ { "adminToken": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" }, "404": { "description": "Not found" } } }, "put": { "operationId": "updateMedia", "summary": "Update media", "tags": [ "admin: media" ], "parameters": [ { "name": "hex", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[0-9a-f]{32}$" } } ], "security": [ { "adminToken": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } }, "delete": { "operationId": "deleteMedia", "summary": "Delete media", "tags": [ "admin: media" ], "parameters": [ { "name": "hex", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[0-9a-f]{32}$" } } ], "security": [ { "adminToken": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } } }, "/admin/media/{hex}/base64": { "get": { "operationId": "getMediaBase64", "summary": "Get media base64", "tags": [ "admin: media" ], "parameters": [ { "name": "hex", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[0-9a-f]{32}$" } }, { "name": "format", "in": "query", "required": false, "schema": { "type": "string" } } ], "security": [ { "adminToken": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" }, "404": { "description": "Not found" } } } }, "/admin/media/{hex}/claim": { "post": { "operationId": "claimMedia", "summary": "Claim media", "tags": [ "admin: media" ], "parameters": [ { "name": "hex", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[0-9a-f]{32}$" } } ], "security": [ { "adminToken": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } } }, "/admin/media/{hex}/comments": { "get": { "operationId": "listMediaComments_2", "summary": "List media comments", "tags": [ "admin: media" ], "parameters": [ { "name": "hex", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[0-9a-f]{32}$" } }, { "name": "cursorAt", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "cursorId", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "string" } } ], "security": [ { "adminToken": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" }, "404": { "description": "Not found" } } } }, "/admin/media/{hex}/describe-ai": { "post": { "operationId": "describeMediaWithAi", "summary": "Describe media with ai", "tags": [ "admin: media" ], "parameters": [ { "name": "hex", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[0-9a-f]{32}$" } }, { "name": "mode", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "model", "in": "query", "required": false, "schema": { "type": "string" } } ], "security": [ { "adminToken": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } } }, "/admin/media/{hex}/describe-prompt": { "get": { "operationId": "getDescribePrompt", "summary": "Get describe prompt", "tags": [ "admin: media" ], "parameters": [ { "name": "hex", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[0-9a-f]{32}$" } } ], "security": [ { "adminToken": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" }, "404": { "description": "Not found" } } } }, "/admin/media/{hex}/enrichment": { "post": { "operationId": "setMediaEnrichment", "summary": "Set media enrichment", "tags": [ "admin: media" ], "parameters": [ { "name": "hex", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[0-9a-f]{32}$" } } ], "security": [ { "adminToken": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } } }, "/admin/media/{hex}/fail": { "post": { "operationId": "failMedia", "summary": "Fail media", "tags": [ "admin: media" ], "parameters": [ { "name": "hex", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[0-9a-f]{32}$" } } ], "security": [ { "adminToken": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } } }, "/admin/media/{hex}/flag": { "put": { "operationId": "flagMedia", "summary": "Flag media", "tags": [ "admin: media" ], "parameters": [ { "name": "hex", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[0-9a-f]{32}$" } } ], "security": [ { "adminToken": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } } }, "/admin/media/{hex}/geo": { "put": { "operationId": "setMediaGeo", "summary": "Set media geo", "tags": [ "admin: media" ], "parameters": [ { "name": "hex", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[0-9a-f]{32}$" } } ], "security": [ { "adminToken": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } } }, "/admin/media/{hex}/phash-diff/{other}": { "get": { "operationId": "getMediaPhashDiff", "summary": "Get media phash diff", "tags": [ "admin: media" ], "parameters": [ { "name": "hex", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[0-9a-f]{32}$" } }, { "name": "other", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[0-9a-f]{32}$" } } ], "security": [ { "adminToken": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" }, "404": { "description": "Not found" } } } }, "/admin/media/{hex}/published": { "put": { "operationId": "setMediaPublication", "summary": "Set media publication", "tags": [ "admin: media" ], "parameters": [ { "name": "hex", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[0-9a-f]{32}$" } } ], "security": [ { "adminToken": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } } }, "/admin/media/{hex}/reactions": { "get": { "operationId": "listMediaReactions", "summary": "List media reactions", "tags": [ "admin: media" ], "parameters": [ { "name": "hex", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[0-9a-f]{32}$" } }, { "name": "cursorAt", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "cursorId", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "value", "in": "query", "required": false, "schema": { "type": "string" } } ], "security": [ { "adminToken": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" }, "404": { "description": "Not found" } } } }, "/admin/media/{hex}/recompute-stats": { "post": { "operationId": "recomputeMediaStats", "summary": "Recompute media stats", "tags": [ "admin: media" ], "parameters": [ { "name": "hex", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[0-9a-f]{32}$" } } ], "security": [ { "adminToken": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } } }, "/admin/media/{hex}/reindex": { "post": { "operationId": "reindexMedia", "summary": "Reindex media", "tags": [ "admin: media" ], "parameters": [ { "name": "hex", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[0-9a-f]{32}$" } } ], "security": [ { "adminToken": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } } }, "/admin/media/{hex}/reports": { "get": { "operationId": "listMediaReports", "summary": "List media reports", "tags": [ "admin: media" ], "parameters": [ { "name": "hex", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[0-9a-f]{32}$" } } ], "security": [ { "adminToken": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" }, "404": { "description": "Not found" } } } }, "/admin/media/{hex}/trends": { "get": { "operationId": "getMediaEngagementTrends", "summary": "Get media engagement trends", "tags": [ "admin: media" ], "parameters": [ { "name": "hex", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[0-9a-f]{32}$" } }, { "name": "days", "in": "query", "required": false, "schema": { "type": "integer" } } ], "security": [ { "adminToken": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" }, "404": { "description": "Not found" } } } }, "/admin/newsletter/export": { "get": { "operationId": "exportNewsletterSubscribers", "summary": "Export newsletter subscribers", "tags": [ "admin: newsletter" ], "parameters": [ { "name": "status", "in": "query", "required": false, "schema": { "type": "string" } } ], "security": [ { "adminToken": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" } } } }, "/admin/newsletter/stats": { "get": { "operationId": "getNewsletterStats", "summary": "Get newsletter stats", "tags": [ "admin: newsletter" ], "security": [ { "adminToken": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" } } } }, "/admin/newsletter/subscribers": { "get": { "operationId": "listNewsletterSubscribers", "summary": "List newsletter subscribers", "tags": [ "admin: newsletter" ], "parameters": [ { "name": "cursorAt", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "cursorId", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "status", "in": "query", "required": false, "schema": { "type": "string" } } ], "security": [ { "adminToken": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" } } } }, "/admin/newsletter/subscribers/{id}": { "get": { "operationId": "getNewsletterSubscriber", "summary": "Get newsletter subscriber", "tags": [ "admin: newsletter" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[0-9a-f]{32}$" } } ], "security": [ { "adminToken": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" }, "404": { "description": "Not found" } } }, "delete": { "operationId": "forceUnsubscribeNewsletterSubscriber", "summary": "Force unsubscribe newsletter subscriber", "tags": [ "admin: newsletter" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[0-9a-f]{32}$" } } ], "security": [ { "adminToken": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } } }, "/admin/newsletter/subscribers/{id}/resend-confirmation": { "post": { "operationId": "resendNewsletterConfirmation", "summary": "Resend newsletter confirmation", "tags": [ "admin: newsletter" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[0-9a-f]{32}$" } } ], "security": [ { "adminToken": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } } }, "/admin/notifications": { "post": { "operationId": "sendNotification", "summary": "Send notification", "tags": [ "admin: notifications" ], "parameters": [ { "name": "batchSize", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string" } } ], "security": [ { "adminToken": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" }, "422": { "description": "Validation error" } } } }, "/admin/offers/{id}": { "get": { "operationId": "getAdminOffer", "summary": "Get admin offer", "tags": [ "admin: offers" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[a-f0-9]{32}$" } } ], "security": [ { "adminToken": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" }, "404": { "description": "Not found" } } } }, "/admin/provider-types": { "get": { "operationId": "listProviderTypes", "summary": "List provider types", "tags": [ "admin: provider-types" ], "security": [ { "adminToken": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" } } }, "post": { "operationId": "createProviderType", "summary": "Create provider type", "tags": [ "admin: provider-types" ], "security": [ { "adminToken": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" }, "422": { "description": "Validation error" } } } }, "/admin/provider-types/{id}": { "get": { "operationId": "getProviderType", "summary": "Get provider type", "tags": [ "admin: provider-types" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[0-9]+$" } } ], "security": [ { "adminToken": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" }, "404": { "description": "Not found" } } }, "put": { "operationId": "updateProviderType", "summary": "Update provider type", "tags": [ "admin: provider-types" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[0-9]+$" } } ], "security": [ { "adminToken": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } }, "delete": { "operationId": "deleteProviderType", "summary": "Delete provider type", "tags": [ "admin: provider-types" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[0-9]+$" } } ], "security": [ { "adminToken": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } } }, "/admin/regions/{code}": { "get": { "operationId": "getAdminRegion", "summary": "Get admin region", "tags": [ "admin: regions" ], "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[a-zA-Z0-9-]{2,7}$" } } ], "security": [ { "adminToken": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" }, "404": { "description": "Not found" } } } }, "/admin/reports": { "get": { "operationId": "listReports", "summary": "List reports", "tags": [ "admin: reports" ], "parameters": [ { "name": "cursorAt", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "cursorId", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "status", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "targetType", "in": "query", "required": false, "schema": { "type": "string" } } ], "security": [ { "adminToken": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" } } } }, "/admin/reports/{hex}": { "get": { "operationId": "getReport", "summary": "Get report", "tags": [ "admin: reports" ], "parameters": [ { "name": "hex", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[0-9a-f]{32}$" } } ], "security": [ { "adminToken": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" }, "404": { "description": "Not found" } } }, "patch": { "operationId": "resolveReport", "summary": "Resolve report", "tags": [ "admin: reports" ], "parameters": [ { "name": "hex", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[0-9a-f]{32}$" } } ], "security": [ { "adminToken": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } } }, "/admin/search/health": { "get": { "operationId": "getSearchHealth", "summary": "Get search health", "tags": [ "admin: search" ], "security": [ { "adminToken": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" } } } }, "/admin/social-feeds/{code}": { "get": { "operationId": "getAdminSocialFeed", "summary": "Get admin social feed", "tags": [ "admin: social-feeds" ], "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[0-9A-Za-z]{4,10}$" } } ], "security": [ { "adminToken": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" }, "404": { "description": "Not found" } } } }, "/admin/staff": { "get": { "operationId": "listStaff", "summary": "List staff", "tags": [ "admin: staff" ], "parameters": [ { "name": "after", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } } ], "security": [ { "staffToken": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" } } }, "post": { "operationId": "createStaff", "summary": "Create staff", "tags": [ "admin: staff" ], "security": [ { "staffToken": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" }, "422": { "description": "Validation error" } } } }, "/admin/staff/actions": { "get": { "operationId": "getStaffActionLog", "summary": "Get staff action log", "tags": [ "admin: staff" ], "parameters": [ { "name": "action", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "before", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "from", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "staffId", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "to", "in": "query", "required": false, "schema": { "type": "string" } } ], "security": [ { "staffToken": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" } } } }, "/admin/staff/login": { "post": { "operationId": "loginStaff", "summary": "Login staff", "tags": [ "admin: staff" ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "422": { "description": "Validation error" } } } }, "/admin/staff/logout": { "post": { "operationId": "logoutStaff", "summary": "Logout staff", "tags": [ "admin: staff" ], "security": [ { "staffToken": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" }, "422": { "description": "Validation error" } } } }, "/admin/staff/me": { "get": { "operationId": "getCurrentStaff", "summary": "Get current staff", "tags": [ "admin: staff" ], "security": [ { "staffToken": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" } } } }, "/admin/staff/stats": { "get": { "operationId": "getStaffStats", "summary": "Get staff stats", "tags": [ "admin: staff" ], "parameters": [ { "name": "days", "in": "query", "required": false, "schema": { "type": "integer" } } ], "security": [ { "staffToken": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" } } } }, "/admin/staff/{id}": { "get": { "operationId": "getStaff", "summary": "Get staff", "tags": [ "admin: staff" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[0-9]+$" } } ], "security": [ { "staffToken": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" }, "404": { "description": "Not found" } } }, "put": { "operationId": "updateStaff", "summary": "Update staff", "tags": [ "admin: staff" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[0-9]+$" } } ], "security": [ { "staffToken": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } }, "delete": { "operationId": "deleteStaff", "summary": "Delete staff", "tags": [ "admin: staff" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[0-9]+$" } } ], "security": [ { "staffToken": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } } }, "/admin/staff/{id}/reset-password": { "post": { "operationId": "resetStaffPassword", "summary": "Reset staff password", "tags": [ "admin: staff" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[0-9]+$" } } ], "security": [ { "staffToken": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } } }, "/admin/stats": { "get": { "operationId": "getAdminStats", "summary": "Get admin stats", "tags": [ "admin: stats" ], "security": [ { "adminToken": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" } } } }, "/admin/stats/demographics": { "get": { "operationId": "getUserDemographics", "summary": "Get user demographics", "tags": [ "admin: stats" ], "parameters": [ { "name": "on", "in": "query", "required": false, "schema": { "type": "string" }, "description": "YYYY-MM-DD — la capture la plus récente antérieure ou égale à cette date (défaut : la dernière). Comparer deux dates répond à « mon audience vieillit-elle ? ». Une date inexistante est un 400." } ], "security": [ { "adminToken": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" } } } }, "/admin/stats/demographics/refresh": { "post": { "operationId": "refreshUserDemographics", "summary": "Refresh user demographics", "tags": [ "admin: stats" ], "security": [ { "adminToken": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" }, "409": { "description": "Une capture est déjà en cours (verrou nommé MySQL) — rien n'a été écrit." }, "422": { "description": "Validation error" } } } }, "/admin/stats/registration-heatmap": { "get": { "operationId": "getRegistrationHeatmap", "summary": "Get registration heatmap", "tags": [ "admin: stats" ], "parameters": [ { "name": "days", "in": "query", "required": false, "schema": { "type": "integer" }, "description": "Longueur de la fenêtre en jours, bornée 1..180 (défaut 30)." } ], "security": [ { "adminToken": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" } } } }, "/admin/stats/sessions": { "get": { "operationId": "getSessionStats", "summary": "Get session stats", "tags": [ "admin: stats" ], "security": [ { "adminToken": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" } } } }, "/admin/stats/trends": { "get": { "operationId": "getMetricTrends", "summary": "Get metric trends", "tags": [ "admin: stats" ], "parameters": [ { "name": "days", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "metric", "in": "query", "required": false, "schema": { "type": "string" } } ], "security": [ { "adminToken": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" } } } }, "/admin/subregions/{code}": { "get": { "operationId": "getAdminSubregion", "summary": "Get admin subregion", "tags": [ "admin: subregions" ], "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[a-zA-Z0-9-]{2,7}$" } } ], "security": [ { "adminToken": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" }, "404": { "description": "Not found" } } } }, "/admin/system/logs": { "get": { "operationId": "getSystemLogs", "summary": "Get system logs", "tags": [ "admin: system" ], "parameters": [ { "name": "cursorId", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "from", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "level", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "pathPrefix", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "status", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "to", "in": "query", "required": false, "schema": { "type": "string" } } ], "security": [ { "adminToken": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" } } } }, "/admin/topics": { "get": { "operationId": "listAdminTopics", "summary": "List admin topics", "tags": [ "admin: topics" ], "parameters": [ { "name": "active", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "level", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "parent", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "q", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } } } }, "post": { "operationId": "createTopic", "summary": "Create topic", "tags": [ "admin: topics" ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "422": { "description": "Validation error" } } } }, "/admin/topics/{slug}": { "get": { "operationId": "getAdminTopic", "summary": "Get admin topic", "tags": [ "admin: topics" ], "parameters": [ { "name": "slug", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[a-z0-9-]{1,64}$" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "404": { "description": "Not found" } } }, "put": { "operationId": "updateTopic", "summary": "Update topic", "tags": [ "admin: topics" ], "parameters": [ { "name": "slug", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[a-z0-9-]{1,64}$" } } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } }, "delete": { "operationId": "deleteTopic", "summary": "Delete topic", "tags": [ "admin: topics" ], "parameters": [ { "name": "slug", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[a-z0-9-]{1,64}$" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } } }, "/admin/topics/{slug}/parents": { "put": { "operationId": "setTopicParents", "summary": "Set topic parents", "tags": [ "admin: topics" ], "parameters": [ { "name": "slug", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[a-z0-9-]{1,64}$" } } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } } }, "/admin/tracking/clicks/{ref}": { "get": { "operationId": "getTrackingClick", "summary": "Get tracking click", "tags": [ "admin: tracking" ], "parameters": [ { "name": "ref", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[0-9a-f]{32}$" } } ], "security": [ { "adminToken": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" }, "404": { "description": "Not found" } } } }, "/admin/tracking/conversions": { "post": { "operationId": "recordConversion", "summary": "Record conversion", "tags": [ "admin: tracking" ], "security": [ { "adminToken": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" }, "422": { "description": "Validation error" } } } }, "/admin/tracking/{targetType}/{targetId}": { "get": { "operationId": "getTrackingStats", "summary": "Get tracking stats", "tags": [ "admin: tracking" ], "parameters": [ { "name": "targetType", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "targetId", "in": "path", "required": true, "schema": { "type": "string" } } ], "security": [ { "adminToken": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "403": { "description": "Forbidden" }, "404": { "description": "Not found" } } } }, "/admin/users": { "get": { "operationId": "listUsers", "summary": "List users", "tags": [ "admin: users" ], "parameters": [ { "name": "banned", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "confirmed", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "deleted", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "verified", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/admin/users/banned": { "get": { "operationId": "listBannedUsers", "summary": "List banned users", "tags": [ "admin: users" ], "parameters": [ { "name": "confirmed", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "deleted", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "verified", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/admin/users/reindex-all": { "post": { "operationId": "reindexAllUsers", "summary": "Reindex all users", "tags": [ "admin: users" ], "parameters": [ { "name": "batchSize", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string" } } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "422": { "description": "Validation error" } } } }, "/admin/users/search": { "get": { "operationId": "searchUsers_2", "summary": "Search users", "tags": [ "admin: users" ], "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "q", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "sort", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/admin/users/unconfirmed": { "get": { "operationId": "listUnconfirmedUsers", "summary": "List unconfirmed users", "tags": [ "admin: users" ], "parameters": [ { "name": "banned", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "deleted", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "verified", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/admin/users/{hex}": { "get": { "operationId": "getUser_2", "summary": "Get user", "tags": [ "admin: users" ], "parameters": [ { "name": "hex", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[0-9a-f]{32}$" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "404": { "description": "Not found" } } } }, "/admin/users/{hex}/address": { "get": { "operationId": "getUserAddress", "summary": "Get user address", "tags": [ "admin: users" ], "parameters": [ { "name": "hex", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[0-9a-f]{32}$" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "404": { "description": "Not found" } } } }, "/admin/users/{hex}/anonymize": { "post": { "operationId": "anonymizeUser", "summary": "Anonymize user", "tags": [ "admin: users" ], "parameters": [ { "name": "hex", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[0-9a-f]{32}$" } } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } } }, "/admin/users/{hex}/avatar": { "post": { "operationId": "uploadUserAvatar", "summary": "Upload user avatar", "tags": [ "admin: users" ], "parameters": [ { "name": "hex", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[0-9a-f]{32}$" } }, { "name": "reason", "in": "query", "required": false, "schema": { "type": "string" } } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } }, "delete": { "operationId": "deleteUserAvatar", "summary": "Delete user avatar", "tags": [ "admin: users" ], "parameters": [ { "name": "hex", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[0-9a-f]{32}$" } }, { "name": "reason", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } } }, "/admin/users/{hex}/badges": { "get": { "operationId": "listUserBadges", "summary": "List user badges", "tags": [ "admin: users" ], "parameters": [ { "name": "hex", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[0-9a-f]{32}$" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "404": { "description": "Not found" } } } }, "/admin/users/{hex}/badges/{slug}": { "put": { "operationId": "assignUserBadge", "summary": "Assign user badge", "tags": [ "admin: users" ], "parameters": [ { "name": "hex", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[0-9a-f]{32}$" } }, { "name": "slug", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[a-z0-9-]{1,64}$" } } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } }, "delete": { "operationId": "revokeUserBadge", "summary": "Revoke user badge", "tags": [ "admin: users" ], "parameters": [ { "name": "hex", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[0-9a-f]{32}$" } }, { "name": "slug", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[a-z0-9-]{1,64}$" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } } }, "/admin/users/{hex}/balances": { "get": { "operationId": "getUserBalances", "summary": "Get user balances", "tags": [ "admin: users" ], "parameters": [ { "name": "hex", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[0-9a-f]{32}$" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "404": { "description": "Not found" } } } }, "/admin/users/{hex}/ban": { "put": { "operationId": "banUser", "summary": "Ban user", "tags": [ "admin: users" ], "parameters": [ { "name": "hex", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[0-9a-f]{32}$" } } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } } }, "/admin/users/{hex}/blocks": { "get": { "operationId": "listUserBlocks", "summary": "List user blocks", "tags": [ "admin: users" ], "parameters": [ { "name": "hex", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[0-9a-f]{32}$" } }, { "name": "blockedByCursorAt", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "blockedByCursorId", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "blockingCursorAt", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "blockingCursorId", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "404": { "description": "Not found" } } } }, "/admin/users/{hex}/comments": { "get": { "operationId": "listUserComments", "summary": "List user comments", "tags": [ "admin: users" ], "parameters": [ { "name": "hex", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[0-9a-f]{32}$" } }, { "name": "cursorAt", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "cursorId", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "404": { "description": "Not found" } } } }, "/admin/users/{hex}/confirm": { "post": { "operationId": "confirmUser", "summary": "Confirm user", "tags": [ "admin: users" ], "parameters": [ { "name": "hex", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[0-9a-f]{32}$" } } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } } }, "/admin/users/{hex}/cover": { "post": { "operationId": "uploadUserCover", "summary": "Upload user cover", "tags": [ "admin: users" ], "parameters": [ { "name": "hex", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[0-9a-f]{32}$" } }, { "name": "reason", "in": "query", "required": false, "schema": { "type": "string" } } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } }, "delete": { "operationId": "deleteUserCover", "summary": "Delete user cover", "tags": [ "admin: users" ], "parameters": [ { "name": "hex", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[0-9a-f]{32}$" } }, { "name": "reason", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } } }, "/admin/users/{hex}/history": { "get": { "operationId": "listUserActions", "summary": "List user actions", "tags": [ "admin: users" ], "parameters": [ { "name": "hex", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[0-9a-f]{32}$" } }, { "name": "before", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "404": { "description": "Not found" } } } }, "/admin/users/{hex}/official": { "put": { "operationId": "setUserOfficial", "summary": "Set user official", "tags": [ "admin: users" ], "parameters": [ { "name": "hex", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[0-9a-f]{32}$" } } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } } }, "/admin/users/{hex}/profile": { "put": { "operationId": "updateUserProfile", "summary": "Update user profile", "tags": [ "admin: users" ], "parameters": [ { "name": "hex", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[0-9a-f]{32}$" } } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } } }, "/admin/users/{hex}/reactions": { "get": { "operationId": "listUserReactions", "summary": "List user reactions", "tags": [ "admin: users" ], "parameters": [ { "name": "hex", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[0-9a-f]{32}$" } }, { "name": "cursorAt", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "cursorId", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "value", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "404": { "description": "Not found" } } } }, "/admin/users/{hex}/referrals": { "get": { "operationId": "getUserReferrals", "summary": "Get user referrals", "tags": [ "admin: users" ], "parameters": [ { "name": "hex", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[0-9a-f]{32}$" } }, { "name": "cursorAt", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "cursorId", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "days", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "stats", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "404": { "description": "Not found" } } } }, "/admin/users/{hex}/reindex": { "post": { "operationId": "reindexUser", "summary": "Reindex user", "tags": [ "admin: users" ], "parameters": [ { "name": "hex", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[0-9a-f]{32}$" } } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } } }, "/admin/users/{hex}/reports": { "get": { "operationId": "listUserReports", "summary": "List user reports", "tags": [ "admin: users" ], "parameters": [ { "name": "hex", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[0-9a-f]{32}$" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "404": { "description": "Not found" } } } }, "/admin/users/{hex}/sessions": { "get": { "operationId": "listUserSessions", "summary": "List user sessions", "tags": [ "admin: users" ], "parameters": [ { "name": "hex", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[0-9a-f]{32}$" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "404": { "description": "Not found" } } }, "delete": { "operationId": "revokeAllUserSessions", "summary": "Revoke all user sessions", "tags": [ "admin: users" ], "parameters": [ { "name": "hex", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[0-9a-f]{32}$" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } } }, "/admin/users/{hex}/sessions/{id}": { "delete": { "operationId": "revokeUserSession", "summary": "Revoke user session", "tags": [ "admin: users" ], "parameters": [ { "name": "hex", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[0-9a-f]{32}$" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } } }, "/admin/users/{hex}/unban": { "put": { "operationId": "unbanUser", "summary": "Unban user", "tags": [ "admin: users" ], "parameters": [ { "name": "hex", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[0-9a-f]{32}$" } } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } } }, "/admin/users/{hex}/verified": { "put": { "operationId": "setUserVerified", "summary": "Set user verified", "tags": [ "admin: users" ], "parameters": [ { "name": "hex", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[0-9a-f]{32}$" } } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } } }, "/api/account/deletion/confirm": { "post": { "operationId": "confirmAccountDeletion", "summary": "Confirm account deletion", "tags": [ "account" ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "422": { "description": "Validation error" } } } }, "/api/auth/confirm-email": { "post": { "operationId": "confirmEmail", "summary": "Confirm email", "tags": [ "auth" ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "422": { "description": "Validation error" } } } }, "/api/auth/confirm-email-change": { "post": { "operationId": "confirmEmailChange", "summary": "Confirm email change", "tags": [ "auth" ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "422": { "description": "Validation error" } } } }, "/api/auth/forgot-password": { "post": { "operationId": "forgotPassword", "summary": "Forgot password", "tags": [ "auth" ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "422": { "description": "Validation error" } } } }, "/api/auth/login": { "post": { "operationId": "login", "summary": "Login", "tags": [ "auth" ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "422": { "description": "Validation error" } } } }, "/api/auth/logout": { "post": { "operationId": "logout", "summary": "Logout", "tags": [ "auth" ], "security": [ { "bearerAuth": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "422": { "description": "Validation error" } } } }, "/api/auth/logout-all": { "post": { "operationId": "logoutAll", "summary": "Logout all", "tags": [ "auth" ], "security": [ { "bearerAuth": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "422": { "description": "Validation error" } } } }, "/api/auth/me": { "get": { "operationId": "me", "summary": "Me", "tags": [ "auth" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" } } } }, "/api/auth/oauth/apple": { "post": { "operationId": "appleLogin", "summary": "Apple login", "tags": [ "auth" ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "422": { "description": "Validation error" } } } }, "/api/auth/oauth/facebook": { "post": { "operationId": "facebookLogin", "summary": "Facebook login", "tags": [ "auth" ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "422": { "description": "Validation error" } } } }, "/api/auth/oauth/google": { "post": { "operationId": "googleLogin", "summary": "Google login", "tags": [ "auth" ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "422": { "description": "Validation error" } } } }, "/api/auth/register": { "post": { "operationId": "register", "summary": "Register", "tags": [ "auth" ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "422": { "description": "Validation error" } } } }, "/api/auth/resend-confirmation": { "post": { "operationId": "resendConfirmation", "summary": "Resend confirmation", "tags": [ "auth" ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "422": { "description": "Validation error" } } } }, "/api/auth/reset-password": { "post": { "operationId": "resetPassword", "summary": "Reset password", "tags": [ "auth" ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "422": { "description": "Validation error" } } } }, "/api/auth/sessions": { "get": { "operationId": "listSessions", "summary": "List sessions", "tags": [ "auth" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" } } } }, "/api/auth/sessions/{id}": { "delete": { "operationId": "revokeSession", "summary": "Revoke session", "tags": [ "auth" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } } }, "/api/badges": { "get": { "operationId": "listBadges", "summary": "List badges", "tags": [ "badges" ], "parameters": [ { "name": "groupBy", "in": "query", "required": false, "schema": { "type": "string" } } ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" } } } }, "/api/brands": { "get": { "operationId": "listBrands", "summary": "List brands", "tags": [ "brands" ], "parameters": [ { "name": "groupBy", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "q", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/api/brands/{code}": { "get": { "operationId": "getBrand", "summary": "Get brand", "tags": [ "brands" ], "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[a-z0-9]{1,64}$" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "404": { "description": "Not found" } } } }, "/api/brands/{code}/clicks": { "post": { "operationId": "createBrandClick", "summary": "Create brand click", "tags": [ "brands" ], "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[a-z0-9]{1,64}$" } } ], "security": [ {}, { "bearerAuth": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } } }, "/api/cities": { "get": { "operationId": "listCities", "summary": "List cities", "tags": [ "cities" ], "parameters": [ { "name": "country", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "region", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "subregion", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/api/cities/search": { "get": { "operationId": "searchCities", "summary": "Search cities", "tags": [ "cities" ], "parameters": [ { "name": "country", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "distance", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "lat", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "lng", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "q", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "region", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "subregion", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/api/cities/{id}": { "get": { "operationId": "getCity", "summary": "Get city", "tags": [ "cities" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "404": { "description": "Not found" } } } }, "/api/countries": { "get": { "operationId": "listCountries", "summary": "List countries", "tags": [ "countries" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/api/countries/search": { "get": { "operationId": "searchCountries", "summary": "Search countries", "tags": [ "countries" ], "parameters": [ { "name": "distance", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "lat", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "lng", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "q", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/api/countries/{code}": { "get": { "operationId": "getCountry", "summary": "Get country", "tags": [ "countries" ], "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[a-zA-Z]{2,3}$" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "404": { "description": "Not found" } } } }, "/api/documents": { "get": { "operationId": "listDocuments", "summary": "List documents", "tags": [ "documents" ], "parameters": [ { "name": "category", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/api/documents/{slug}": { "get": { "operationId": "getDocument", "summary": "Get document", "tags": [ "documents" ], "parameters": [ { "name": "slug", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[a-z0-9-]{1,80}$" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "404": { "description": "Not found" } } } }, "/api/establishments": { "get": { "operationId": "listEstablishments", "summary": "List establishments", "tags": [ "establishments" ], "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "sort", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/api/establishments/search": { "get": { "operationId": "searchEstablishments", "summary": "Search establishments", "tags": [ "establishments" ], "parameters": [ { "name": "distance", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "lat", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "lng", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "q", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/api/establishments/{id}": { "get": { "operationId": "getEstablishment", "summary": "Get establishment", "tags": [ "establishments" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[a-f0-9]{32}$" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "404": { "description": "Not found" } } } }, "/api/i18n/locales": { "get": { "operationId": "listLocales", "summary": "List locales", "tags": [ "i18n" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/api/leaderboard": { "get": { "operationId": "getLeaderboard", "summary": "Get leaderboard", "tags": [ "leaderboard" ], "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "metric", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/api/media/comments/{commentId}": { "patch": { "operationId": "updateMediaComment", "summary": "Update media comment", "tags": [ "media" ], "parameters": [ { "name": "commentId", "in": "path", "required": true, "schema": { "type": "string" } } ], "security": [ { "bearerAuth": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } }, "delete": { "operationId": "deleteMediaComment", "summary": "Delete media comment", "tags": [ "media" ], "parameters": [ { "name": "commentId", "in": "path", "required": true, "schema": { "type": "string" } } ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } } }, "/api/media/comments/{commentId}/replies": { "get": { "operationId": "listMediaCommentReplies", "summary": "List media comment replies", "tags": [ "media" ], "parameters": [ { "name": "commentId", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "before", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "404": { "description": "Not found" } } } }, "/api/media/comments/{commentId}/reports": { "post": { "operationId": "reportComment", "summary": "Report comment", "tags": [ "media" ], "parameters": [ { "name": "commentId", "in": "path", "required": true, "schema": { "type": "string" } } ], "security": [ { "bearerAuth": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } } }, "/api/media/comments/{commentId}/thread": { "get": { "operationId": "getMediaCommentThread", "summary": "Get media comment thread", "tags": [ "media" ], "parameters": [ { "name": "commentId", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "404": { "description": "Not found" } } } }, "/api/media/hashtags/autocomplete": { "get": { "operationId": "autocompleteMediaHashtags", "summary": "Autocomplete media hashtags", "tags": [ "media" ], "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "q", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/api/media/hashtags/related": { "get": { "operationId": "relatedMediaHashtags", "summary": "Related media hashtags", "tags": [ "media" ], "parameters": [ { "name": "hashtag", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/api/media/hashtags/trending": { "get": { "operationId": "trendingMediaHashtags", "summary": "Trending media hashtags", "tags": [ "media" ], "parameters": [ { "name": "distance", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "lat", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "lng", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/api/media/in-bounds": { "get": { "operationId": "searchMediaInBounds", "summary": "Search media in bounds", "tags": [ "media" ], "parameters": [ { "name": "east", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "hashtags", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "north", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "orientation", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "q", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "south", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "west", "in": "query", "required": false, "schema": { "type": "string" } } ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" } } } }, "/api/media/latest": { "get": { "operationId": "listLatestMedia", "summary": "List latest media", "tags": [ "media" ], "parameters": [ { "name": "before", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "string" } } ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" } } } }, "/api/media/nearby": { "get": { "operationId": "searchNearbyMedia", "summary": "Search nearby media", "tags": [ "media" ], "parameters": [ { "name": "distance", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "hashtags", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "lat", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "lng", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "orientation", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "q", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/api/media/recommended/nearby": { "get": { "operationId": "recommendedNearbyMedia", "summary": "Recommended nearby media", "tags": [ "media" ], "parameters": [ { "name": "distance", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "lat", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "lng", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "personalize", "in": "query", "required": false, "schema": { "type": "string" } } ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" } } } }, "/api/media/search": { "get": { "operationId": "searchMedia", "summary": "Search media", "tags": [ "media" ], "parameters": [ { "name": "biome", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "country", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "hashtags", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "orientation", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "q", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "sort", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "type", "in": "query", "required": false, "schema": { "type": "string" } } ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" } } } }, "/api/media/trending": { "get": { "operationId": "trendingMedia", "summary": "Trending media", "tags": [ "media" ], "parameters": [ { "name": "country", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "personalize", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "windowDays", "in": "query", "required": false, "schema": { "type": "integer" } } ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" } } } }, "/api/media/{mediaId}": { "get": { "operationId": "getMedia", "summary": "Get media", "tags": [ "media" ], "parameters": [ { "name": "mediaId", "in": "path", "required": true, "schema": { "type": "string" } } ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "404": { "description": "Not found" } } } }, "/api/media/{mediaId}/comments": { "get": { "operationId": "listMediaComments", "summary": "List media comments", "tags": [ "media" ], "parameters": [ { "name": "mediaId", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "before", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "string" } } ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "404": { "description": "Not found" } } }, "post": { "operationId": "createMediaComment", "summary": "Create media comment", "tags": [ "media" ], "parameters": [ { "name": "mediaId", "in": "path", "required": true, "schema": { "type": "string" } } ], "security": [ { "bearerAuth": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } } }, "/api/media/{mediaId}/dislikes": { "get": { "operationId": "listMediaDislikers", "summary": "List media dislikers", "tags": [ "media" ], "parameters": [ { "name": "mediaId", "in": "path", "required": true, "schema": { "type": "string" } } ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "404": { "description": "Not found" } } } }, "/api/media/{mediaId}/likes": { "get": { "operationId": "listMediaLikers", "summary": "List media likers", "tags": [ "media" ], "parameters": [ { "name": "mediaId", "in": "path", "required": true, "schema": { "type": "string" } } ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "404": { "description": "Not found" } } } }, "/api/media/{mediaId}/reports": { "post": { "operationId": "reportMedia", "summary": "Report media", "tags": [ "media" ], "parameters": [ { "name": "mediaId", "in": "path", "required": true, "schema": { "type": "string" } } ], "security": [ { "bearerAuth": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } } }, "/api/newsletter/subscribe": { "post": { "operationId": "subscribe", "summary": "Subscribe", "tags": [ "newsletter" ], "security": [ {}, { "bearerAuth": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "422": { "description": "Validation error" } } } }, "/api/offers": { "get": { "operationId": "listOffers", "summary": "List offers", "tags": [ "offers" ], "parameters": [ { "name": "establishment", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "sort", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/api/offers/search": { "get": { "operationId": "searchOffers", "summary": "Search offers", "tags": [ "offers" ], "parameters": [ { "name": "distance", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "lat", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "lng", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "q", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/api/offers/{id}": { "get": { "operationId": "getOffer", "summary": "Get offer", "tags": [ "offers" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[a-f0-9]{32}$" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "404": { "description": "Not found" } } } }, "/api/offers/{id}/clicks": { "post": { "operationId": "createOfferClick", "summary": "Create offer click", "tags": [ "offers" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[a-f0-9]{32}$" } } ], "security": [ {}, { "bearerAuth": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } } }, "/api/ping": { "get": { "operationId": "ping", "summary": "Ping", "tags": [ "ping" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/api/pois": { "get": { "operationId": "listPois", "summary": "List pois", "tags": [ "pois" ], "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "sort", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/api/pois/search": { "get": { "operationId": "searchPois", "summary": "Search pois", "tags": [ "pois" ], "parameters": [ { "name": "distance", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "lat", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "lng", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "q", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/api/pois/{id}": { "get": { "operationId": "getPoi", "summary": "Get poi", "tags": [ "pois" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[a-fA-F0-9]{32}$" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "404": { "description": "Not found" } } } }, "/api/regions": { "get": { "operationId": "listRegions", "summary": "List regions", "tags": [ "regions" ], "parameters": [ { "name": "country", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/api/regions/search": { "get": { "operationId": "searchRegions", "summary": "Search regions", "tags": [ "regions" ], "parameters": [ { "name": "country", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "distance", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "lat", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "lng", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "q", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/api/regions/{code}": { "get": { "operationId": "getRegion", "summary": "Get region", "tags": [ "regions" ], "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[a-zA-Z0-9-]{2,7}$" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "404": { "description": "Not found" } } } }, "/api/social-feeds/{code}": { "get": { "operationId": "getSocialFeed", "summary": "Get social feed", "tags": [ "social-feeds" ], "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[0-9A-Za-z]{4,10}$" } } ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "404": { "description": "Not found" } } } }, "/api/socials": { "get": { "operationId": "listSocials", "summary": "List socials", "tags": [ "socials" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/api/subregions": { "get": { "operationId": "listSubregions", "summary": "List subregions", "tags": [ "subregions" ], "parameters": [ { "name": "country", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "region", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/api/subregions/search": { "get": { "operationId": "searchSubregions", "summary": "Search subregions", "tags": [ "subregions" ], "parameters": [ { "name": "country", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "distance", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "lat", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "lng", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "q", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "region", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/api/subregions/{code}": { "get": { "operationId": "getSubregion", "summary": "Get subregion", "tags": [ "subregions" ], "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[a-zA-Z0-9-]{2,7}$" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "404": { "description": "Not found" } } } }, "/api/topics": { "get": { "operationId": "listTopics", "summary": "List topics", "tags": [ "topics" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/api/users/me": { "delete": { "operationId": "requestAccountDeletion", "summary": "Request account deletion", "tags": [ "users" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "422": { "description": "Validation error" } } } }, "/api/users/me/address": { "get": { "operationId": "getMyAddress", "summary": "Get my address", "tags": [ "users" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" } } }, "patch": { "operationId": "updateMyAddress", "summary": "Update my address", "tags": [ "users" ], "security": [ { "bearerAuth": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "422": { "description": "Validation error" } } }, "delete": { "operationId": "deleteMyAddress", "summary": "Delete my address", "tags": [ "users" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "422": { "description": "Validation error" } } } }, "/api/users/me/avatar": { "post": { "operationId": "uploadAvatar", "summary": "Upload avatar", "tags": [ "users" ], "security": [ { "bearerAuth": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "422": { "description": "Validation error" } } }, "delete": { "operationId": "deleteAvatar", "summary": "Delete avatar", "tags": [ "users" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "422": { "description": "Validation error" } } } }, "/api/users/me/badges": { "get": { "operationId": "getMyBadges", "summary": "Get my badges", "tags": [ "users" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" } } } }, "/api/users/me/blocks": { "get": { "operationId": "listMyBlocks", "summary": "List my blocks", "tags": [ "users" ], "parameters": [ { "name": "before", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "string" } } ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" } } } }, "/api/users/me/blocks/{userId}": { "post": { "operationId": "blockUser", "summary": "Block user", "tags": [ "users" ], "parameters": [ { "name": "userId", "in": "path", "required": true, "schema": { "type": "string" } } ], "security": [ { "bearerAuth": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } }, "delete": { "operationId": "unblockUser", "summary": "Unblock user", "tags": [ "users" ], "parameters": [ { "name": "userId", "in": "path", "required": true, "schema": { "type": "string" } } ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } } }, "/api/users/me/bookmarks": { "get": { "operationId": "listMyBookmarks", "summary": "List my bookmarks", "tags": [ "users" ], "parameters": [ { "name": "before", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "collectionId", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "unclassified", "in": "query", "required": false, "schema": { "type": "string" } } ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" } } } }, "/api/users/me/bookmarks/collections": { "get": { "operationId": "listMyBookmarkCollections", "summary": "List my bookmark collections", "tags": [ "users" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" } } }, "post": { "operationId": "createBookmarkCollection", "summary": "Create bookmark collection", "tags": [ "users" ], "security": [ { "bearerAuth": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "422": { "description": "Validation error" } } } }, "/api/users/me/bookmarks/collections/{collectionId}": { "patch": { "operationId": "updateBookmarkCollection", "summary": "Update bookmark collection", "tags": [ "users" ], "parameters": [ { "name": "collectionId", "in": "path", "required": true, "schema": { "type": "string" } } ], "security": [ { "bearerAuth": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } }, "delete": { "operationId": "deleteBookmarkCollection", "summary": "Delete bookmark collection", "tags": [ "users" ], "parameters": [ { "name": "collectionId", "in": "path", "required": true, "schema": { "type": "string" } } ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } } }, "/api/users/me/cover": { "post": { "operationId": "uploadCover", "summary": "Upload cover", "tags": [ "users" ], "security": [ { "bearerAuth": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "422": { "description": "Validation error" } } }, "delete": { "operationId": "deleteCover", "summary": "Delete cover", "tags": [ "users" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "422": { "description": "Validation error" } } } }, "/api/users/me/dislikes": { "get": { "operationId": "listMyDislikedMedia", "summary": "List my disliked media", "tags": [ "users" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" } } } }, "/api/users/me/export": { "get": { "operationId": "exportMyData", "summary": "Export my data", "tags": [ "users" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" } } } }, "/api/users/me/feed": { "get": { "operationId": "listMyFeed", "summary": "List my feed", "tags": [ "users" ], "parameters": [ { "name": "before", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "string" } } ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" } } } }, "/api/users/me/followers": { "get": { "operationId": "listMyFollowers", "summary": "List my followers", "tags": [ "users" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" } } } }, "/api/users/me/following": { "get": { "operationId": "listMyFollowing", "summary": "List my following", "tags": [ "users" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" } } } }, "/api/users/me/following/{targetUserId}": { "post": { "operationId": "followUser", "summary": "Follow user", "tags": [ "users" ], "parameters": [ { "name": "targetUserId", "in": "path", "required": true, "schema": { "type": "string" } } ], "security": [ { "bearerAuth": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } }, "delete": { "operationId": "unfollowUser", "summary": "Unfollow user", "tags": [ "users" ], "parameters": [ { "name": "targetUserId", "in": "path", "required": true, "schema": { "type": "string" } } ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } } }, "/api/users/me/likes": { "get": { "operationId": "listMyLikedMedia", "summary": "List my liked media", "tags": [ "users" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" } } } }, "/api/users/me/media": { "post": { "operationId": "uploadMedia", "summary": "Upload media", "tags": [ "users" ], "security": [ { "bearerAuth": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "422": { "description": "Validation error" } } }, "get": { "operationId": "listMyMedia", "summary": "List my media", "tags": [ "users" ], "parameters": [ { "name": "before", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "string" } } ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" } } } }, "/api/users/me/media/{mediaId}": { "delete": { "operationId": "deleteMyMedia", "summary": "Delete my media", "tags": [ "users" ], "parameters": [ { "name": "mediaId", "in": "path", "required": true, "schema": { "type": "string" } } ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } } }, "/api/users/me/media/{mediaId}/bookmark": { "put": { "operationId": "upsertBookmark", "summary": "Upsert bookmark", "tags": [ "users" ], "parameters": [ { "name": "mediaId", "in": "path", "required": true, "schema": { "type": "string" } } ], "security": [ { "bearerAuth": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } }, "delete": { "operationId": "deleteBookmark", "summary": "Delete bookmark", "tags": [ "users" ], "parameters": [ { "name": "mediaId", "in": "path", "required": true, "schema": { "type": "string" } } ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } } }, "/api/users/me/media/{mediaId}/description": { "put": { "operationId": "setMediaDescription", "summary": "Set media description", "tags": [ "users" ], "parameters": [ { "name": "mediaId", "in": "path", "required": true, "schema": { "type": "string" } } ], "security": [ { "bearerAuth": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } }, "delete": { "operationId": "deleteMediaDescription", "summary": "Delete media description", "tags": [ "users" ], "parameters": [ { "name": "mediaId", "in": "path", "required": true, "schema": { "type": "string" } } ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } } }, "/api/users/me/media/{mediaId}/geo": { "put": { "operationId": "setMyMediaGeo", "summary": "Set my media geo", "tags": [ "users" ], "parameters": [ { "name": "mediaId", "in": "path", "required": true, "schema": { "type": "string" } } ], "security": [ { "bearerAuth": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } } }, "/api/users/me/media/{mediaId}/reaction": { "put": { "operationId": "upsertMediaReaction", "summary": "Upsert media reaction", "tags": [ "users" ], "parameters": [ { "name": "mediaId", "in": "path", "required": true, "schema": { "type": "string" } } ], "security": [ { "bearerAuth": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } }, "delete": { "operationId": "deleteMediaReaction", "summary": "Delete media reaction", "tags": [ "users" ], "parameters": [ { "name": "mediaId", "in": "path", "required": true, "schema": { "type": "string" } } ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } } }, "/api/users/me/nickname": { "put": { "operationId": "updateNickname", "summary": "Update nickname", "tags": [ "users" ], "security": [ { "bearerAuth": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "422": { "description": "Validation error" } } } }, "/api/users/me/notifications": { "get": { "operationId": "listNotifications", "summary": "List notifications", "tags": [ "users" ], "parameters": [ { "name": "before", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "filter", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "string" } } ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" } } } }, "/api/users/me/notifications/mark-all-read": { "post": { "operationId": "markAllNotificationsRead", "summary": "Mark all notifications read", "tags": [ "users" ], "security": [ { "bearerAuth": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "422": { "description": "Validation error" } } } }, "/api/users/me/notifications/preferences": { "get": { "operationId": "listNotificationPreferences", "summary": "List notification preferences", "tags": [ "users" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" } } }, "patch": { "operationId": "updateNotificationPreferences", "summary": "Update notification preferences", "tags": [ "users" ], "security": [ { "bearerAuth": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "422": { "description": "Validation error" } } } }, "/api/users/me/notifications/unread-count": { "get": { "operationId": "unreadNotificationCount", "summary": "Unread notification count", "tags": [ "users" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" } } } }, "/api/users/me/notifications/{id}": { "delete": { "operationId": "deleteNotification", "summary": "Delete notification", "tags": [ "users" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } } }, "/api/users/me/notifications/{id}/read": { "patch": { "operationId": "markNotificationRead", "summary": "Mark notification read", "tags": [ "users" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "security": [ { "bearerAuth": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } } }, "/api/users/me/oauth-identities": { "get": { "operationId": "listOAuthIdentities", "summary": "List o auth identities", "tags": [ "users" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" } } } }, "/api/users/me/oauth/apple": { "post": { "operationId": "linkApple", "summary": "Link apple", "tags": [ "users" ], "security": [ { "bearerAuth": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "422": { "description": "Validation error" } } } }, "/api/users/me/oauth/facebook": { "post": { "operationId": "linkFacebook", "summary": "Link facebook", "tags": [ "users" ], "security": [ { "bearerAuth": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "422": { "description": "Validation error" } } } }, "/api/users/me/oauth/google": { "post": { "operationId": "linkGoogle", "summary": "Link google", "tags": [ "users" ], "security": [ { "bearerAuth": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "422": { "description": "Validation error" } } } }, "/api/users/me/password": { "post": { "operationId": "setPassword", "summary": "Set password", "tags": [ "users" ], "security": [ { "bearerAuth": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "422": { "description": "Validation error" } } } }, "/api/users/me/profile": { "patch": { "operationId": "updateMyProfile", "summary": "Update my profile", "tags": [ "users" ], "security": [ { "bearerAuth": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "422": { "description": "Validation error" } } } }, "/api/users/me/settings": { "get": { "operationId": "getSettings", "summary": "Get settings", "tags": [ "users" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" } } }, "patch": { "operationId": "updateSettings", "summary": "Update settings", "tags": [ "users" ], "security": [ { "bearerAuth": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "422": { "description": "Validation error" } } } }, "/api/users/me/social-feeds": { "post": { "operationId": "createSocialFeed", "summary": "Create social feed", "tags": [ "users" ], "security": [ { "bearerAuth": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "422": { "description": "Validation error" } } }, "get": { "operationId": "listMySocialFeeds", "summary": "List my social feeds", "tags": [ "users" ], "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "string" } } ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" } } } }, "/api/users/me/social-feeds/{code}": { "delete": { "operationId": "deleteSocialFeed", "summary": "Delete social feed", "tags": [ "users" ], "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[0-9A-Za-z]{4,10}$" } } ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } } }, "/api/users/me/socials": { "get": { "operationId": "getMySocials", "summary": "Get my socials", "tags": [ "users" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" } } }, "put": { "operationId": "setMySocials", "summary": "Set my socials", "tags": [ "users" ], "security": [ { "bearerAuth": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "422": { "description": "Validation error" } } } }, "/api/users/me/sponsorship": { "get": { "operationId": "getMySponsorship", "summary": "Get my sponsorship", "tags": [ "users" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" } } } }, "/api/users/me/topics": { "get": { "operationId": "getMyTopics", "summary": "Get my topics", "tags": [ "users" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" } } }, "put": { "operationId": "setMyTopics", "summary": "Set my topics", "tags": [ "users" ], "security": [ { "bearerAuth": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "422": { "description": "Validation error" } } } }, "/api/users/me/transactions": { "get": { "operationId": "listMyTransactions", "summary": "List my transactions", "tags": [ "users" ], "parameters": [ { "name": "before", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "currency", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "type", "in": "query", "required": false, "schema": { "type": "string" } } ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" } } } }, "/api/users/me/username": { "post": { "operationId": "setUsername", "summary": "Set username", "tags": [ "users" ], "security": [ { "bearerAuth": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "422": { "description": "Validation error" } } } }, "/api/users/me/username/change": { "post": { "operationId": "changeUsername", "summary": "Change username", "tags": [ "users" ], "security": [ { "bearerAuth": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "422": { "description": "Validation error" } } } }, "/api/users/search": { "get": { "operationId": "searchUsers", "summary": "Search users", "tags": [ "users" ], "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "q", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "sort", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/api/users/{userHex}/reports": { "post": { "operationId": "reportUser", "summary": "Report user", "tags": [ "users" ], "parameters": [ { "name": "userHex", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[0-9a-f]{32}$" } } ], "security": [ { "bearerAuth": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "404": { "description": "Not found" }, "422": { "description": "Validation error" } } } }, "/api/users/{userId}": { "get": { "operationId": "getUser", "summary": "Get user", "tags": [ "users" ], "parameters": [ { "name": "userId", "in": "path", "required": true, "schema": { "type": "string" } } ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "404": { "description": "Not found" } } } }, "/api/users/{userId}/badges": { "get": { "operationId": "getUserBadges", "summary": "Get user badges", "tags": [ "users" ], "parameters": [ { "name": "userId", "in": "path", "required": true, "schema": { "type": "string" } } ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "404": { "description": "Not found" } } } }, "/api/users/{userId}/dislikes": { "get": { "operationId": "listUserDislikedMedia", "summary": "List user disliked media", "tags": [ "users" ], "parameters": [ { "name": "userId", "in": "path", "required": true, "schema": { "type": "string" } } ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "404": { "description": "Not found" } } } }, "/api/users/{userId}/followers": { "get": { "operationId": "listUserFollowers", "summary": "List user followers", "tags": [ "users" ], "parameters": [ { "name": "userId", "in": "path", "required": true, "schema": { "type": "string" } } ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "404": { "description": "Not found" } } } }, "/api/users/{userId}/following": { "get": { "operationId": "listUserFollowing", "summary": "List user following", "tags": [ "users" ], "parameters": [ { "name": "userId", "in": "path", "required": true, "schema": { "type": "string" } } ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "404": { "description": "Not found" } } } }, "/api/users/{userId}/likes": { "get": { "operationId": "listUserLikedMedia", "summary": "List user liked media", "tags": [ "users" ], "parameters": [ { "name": "userId", "in": "path", "required": true, "schema": { "type": "string" } } ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "404": { "description": "Not found" } } } }, "/api/users/{userId}/media": { "get": { "operationId": "listUserMedia", "summary": "List user media", "tags": [ "users" ], "parameters": [ { "name": "userId", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "before", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "string" } } ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "404": { "description": "Not found" } } } }, "/api/users/{userId}/relationship": { "get": { "operationId": "getUserRelationship", "summary": "Get user relationship", "tags": [ "users" ], "parameters": [ { "name": "userId", "in": "path", "required": true, "schema": { "type": "string" } } ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Unauthenticated" }, "404": { "description": "Not found" } } } } } }