{ "openapi": "3.1.0", "info": { "title": "Volubit CMS API Documentation", "version": "1.0.0", "description": "Interactive OpenAPI / Swagger Documentation for Volubit Content Delivery API and Admin API." }, "servers": [ { "url": "http://localhost:8000/api" } ], "security": [ { "AdminApiToken": [] } ], "paths": { "/admin/admins": { "get": { "operationId": "admin.admins.index", "tags": [ "AdminUser" ], "responses": { "200": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "email": { "type": "string" }, "isActive": { "type": "boolean" }, "lastLogin": { "type": [ "string", "null" ] }, "createdAt": { "type": [ "string", "null" ] } }, "required": [ "id", "name", "email", "isActive", "lastLogin", "createdAt" ] } } }, "required": [ "success", "data" ] } } } } } }, "post": { "operationId": "admin.admins.store", "tags": [ "AdminUser" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "maxLength": 255 }, "email": { "type": "string", "format": "email" }, "password": { "type": "string", "minLength": 8 } }, "required": [ "name", "email", "password" ] } } } }, "responses": { "201": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "email": { "type": "string" }, "isActive": { "type": "boolean" }, "createdAt": { "type": [ "string", "null" ] } }, "required": [ "id", "name", "email", "isActive", "createdAt" ] }, "message": { "type": "string", "const": "Admin user created successfully." } }, "required": [ "success", "data", "message" ] } } } }, "422": { "$ref": "#/components/responses/ValidationException" } } } }, "/admin/admins/{id}": { "put": { "operationId": "admin.admins.update", "tags": [ "AdminUser" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "maxLength": 255 }, "email": { "type": "string", "format": "email" }, "password": { "type": [ "string", "null" ], "minLength": 8 }, "is_active": { "type": "boolean" } } } } } }, "responses": { "200": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "email": { "type": "string" }, "isActive": { "type": "boolean" } }, "required": [ "id", "name", "email", "isActive" ] }, "message": { "type": "string", "const": "Admin user updated successfully." } }, "required": [ "success", "data", "message" ] } } } }, "404": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "error": { "type": "object", "properties": { "code": { "type": "string", "const": "NOT_FOUND" }, "message": { "type": "string", "const": "Admin user not found." } }, "required": [ "code", "message" ] } }, "required": [ "success", "error" ] } } } }, "422": { "$ref": "#/components/responses/ValidationException" } } }, "delete": { "operationId": "admin.admins.destroy", "tags": [ "AdminUser" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "message": { "type": "string", "const": "Admin user deleted successfully." } }, "required": [ "success", "message" ] } } } }, "404": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "error": { "type": "object", "properties": { "code": { "type": "string", "const": "NOT_FOUND" }, "message": { "type": "string", "const": "Admin user not found." } }, "required": [ "code", "message" ] } }, "required": [ "success", "error" ] } } } }, "422": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "error": { "type": "object", "properties": { "code": { "type": "string", "const": "CANNOT_DELETE_SELF" }, "message": { "type": "string", "const": "You cannot delete your own account." } }, "required": [ "code", "message" ] } }, "required": [ "success", "error" ] } } } } } } }, "/admin/stats": { "get": { "operationId": "admin.stats", "tags": [ "AdminUser" ], "responses": { "200": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object", "properties": { "totalBlocks": { "type": "integer", "minimum": 0 }, "totalMedia": { "type": "integer", "minimum": 0 }, "totalAdmins": { "type": "integer", "minimum": 0 }, "activeAdmins": { "type": "integer", "minimum": 0 }, "recentEdits": { "type": "integer", "minimum": 0 }, "blocksPerPage": { "type": "array", "items": {} } }, "required": [ "totalBlocks", "totalMedia", "totalAdmins", "activeAdmins", "recentEdits", "blocksPerPage" ] } }, "required": [ "success", "data" ] } } } } } } }, "/admin/audit-log": { "get": { "operationId": "admin.audit-log", "tags": [ "AdminUser" ], "parameters": [ { "name": "action", "in": "query", "description": "Filter by audit action (create, update, delete, login, logout)", "schema": { "type": "string" } }, { "name": "admin_id", "in": "query", "description": "Filter by admin user UUID", "schema": { "type": "string" } }, { "name": "content_page", "in": "query", "description": "Filter by content page", "schema": { "type": "string" } }, { "name": "from", "in": "query", "description": "Filter logs from this date (Y-m-d)", "schema": { "type": "string" } }, { "name": "to", "in": "query", "description": "Filter logs up to this date (Y-m-d)", "schema": { "type": "string" } }, { "name": "page", "in": "query", "description": "Page number", "schema": { "type": "integer", "default": 1 } } ], "responses": { "200": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object", "properties": { "current_page": { "type": "integer", "minimum": 1 }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/AuditLog" } }, "first_page_url": { "type": [ "string", "null" ] }, "from": { "type": [ "integer", "null" ], "minimum": 1 }, "last_page_url": { "type": [ "string", "null" ] }, "last_page": { "type": "integer", "minimum": 1 }, "links": { "type": "array", "description": "Generated paginator links.", "items": { "type": "object", "properties": { "url": { "type": [ "string", "null" ] }, "label": { "type": "string" }, "active": { "type": "boolean" } }, "required": [ "url", "label", "active" ] } }, "next_page_url": { "type": [ "string", "null" ] }, "path": { "type": [ "string", "null" ], "description": "Base path for paginator generated URLs." }, "per_page": { "type": "integer", "description": "Number of items shown per page.", "minimum": 0 }, "prev_page_url": { "type": [ "string", "null" ] }, "to": { "type": [ "integer", "null" ], "description": "Number of the last item in the slice.", "minimum": 1 }, "total": { "type": "integer", "description": "Total number of items being paginated.", "minimum": 0 } }, "required": [ "current_page", "data", "first_page_url", "from", "last_page_url", "last_page", "links", "next_page_url", "path", "per_page", "prev_page_url", "to", "total" ] } }, "required": [ "success", "data" ] } } } } } } }, "/articles": { "get": { "operationId": "articles", "tags": [ "Article" ], "parameters": [ { "name": "category", "in": "query", "description": "Filter by category slug", "schema": { "type": "string" } }, { "name": "tag", "in": "query", "description": "Filter by tag", "schema": { "type": "string" } }, { "name": "featured", "in": "query", "description": "Featured articles only (true/false)", "schema": { "type": "boolean" } }, { "name": "search", "in": "query", "description": "Full-text search on title and excerpt", "schema": { "type": "string" } }, { "name": "page", "in": "query", "description": "Page number", "schema": { "type": "integer", "default": 1 } }, { "name": "limit", "in": "query", "description": "Items per page (max 50)", "schema": { "type": "integer", "default": 10 } }, { "name": "published", "in": "query", "description": "Return only published articles (true/false, default: true)", "schema": { "type": "boolean", "default": true } } ], "responses": { "200": { "description": "Paginated set of `ArticleResource`", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ArticleCollection" }, { "type": "object", "properties": { "links": { "type": "object", "properties": { "first": { "type": [ "string", "null" ] }, "last": { "type": [ "string", "null" ] }, "prev": { "type": [ "string", "null" ] }, "next": { "type": [ "string", "null" ] } }, "required": [ "first", "last", "prev", "next" ] }, "meta": { "type": "object", "properties": { "current_page": { "type": "integer", "minimum": 1 }, "from": { "type": [ "integer", "null" ], "minimum": 1 }, "last_page": { "type": "integer", "minimum": 1 }, "links": { "type": "array", "description": "Generated paginator links.", "items": { "type": "object", "properties": { "url": { "type": [ "string", "null" ] }, "label": { "type": "string" }, "active": { "type": "boolean" } }, "required": [ "url", "label", "active" ] } }, "path": { "type": [ "string", "null" ], "description": "Base path for paginator generated URLs." }, "per_page": { "type": "integer", "description": "Number of items shown per page.", "minimum": 0 }, "to": { "type": [ "integer", "null" ], "description": "Number of the last item in the slice.", "minimum": 1 }, "total": { "type": "integer", "description": "Total number of items being paginated.", "minimum": 0 } }, "required": [ "current_page", "from", "last_page", "links", "path", "per_page", "to", "total" ] } }, "required": [ "links", "meta" ] } ] } } } } }, "security": [] } }, "/articles/featured": { "get": { "operationId": "articles.featured", "tags": [ "Article" ], "responses": { "200": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "$ref": "#/components/schemas/ArticleResource" } }, "required": [ "success", "data" ] } } } }, "404": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "error": { "type": "object", "properties": { "code": { "type": "string", "const": "NOT_FOUND" }, "message": { "type": "string", "const": "No featured article found." } }, "required": [ "code", "message" ] } }, "required": [ "success", "error" ] } } } } }, "security": [] } }, "/articles/{slug}": { "get": { "operationId": "articles.show", "tags": [ "Article" ], "parameters": [ { "name": "slug", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "$ref": "#/components/schemas/ArticleResource" } }, "required": [ "success", "data" ] } } } }, "404": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "error": { "type": "object", "properties": { "code": { "type": "string", "const": "NOT_FOUND" }, "message": { "type": "string", "const": "Article not found." } }, "required": [ "code", "message" ] } }, "required": [ "success", "error" ] } } } } }, "security": [] } }, "/admin/articles": { "get": { "operationId": "admin.articles.index", "tags": [ "Article" ], "parameters": [ { "name": "category", "in": "query", "description": "Filter by category slug", "schema": { "type": "string" } }, { "name": "published", "in": "query", "description": "Filter by publish status (true/false)", "schema": { "type": "string" } }, { "name": "limit", "in": "query", "description": "Items per page", "schema": { "type": "integer", "default": 20 } }, { "name": "page", "in": "query", "description": "Page number", "schema": { "type": "integer", "default": 1 } } ], "responses": { "200": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object", "properties": { "current_page": { "type": "integer", "minimum": 1 }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/Article" } }, "first_page_url": { "type": [ "string", "null" ] }, "from": { "type": [ "integer", "null" ], "minimum": 1 }, "last_page_url": { "type": [ "string", "null" ] }, "last_page": { "type": "integer", "minimum": 1 }, "links": { "type": "array", "description": "Generated paginator links.", "items": { "type": "object", "properties": { "url": { "type": [ "string", "null" ] }, "label": { "type": "string" }, "active": { "type": "boolean" } }, "required": [ "url", "label", "active" ] } }, "next_page_url": { "type": [ "string", "null" ] }, "path": { "type": [ "string", "null" ], "description": "Base path for paginator generated URLs." }, "per_page": { "type": "integer", "description": "Number of items shown per page.", "minimum": 0 }, "prev_page_url": { "type": [ "string", "null" ] }, "to": { "type": [ "integer", "null" ], "description": "Number of the last item in the slice.", "minimum": 1 }, "total": { "type": "integer", "description": "Total number of items being paginated.", "minimum": 0 } }, "required": [ "current_page", "data", "first_page_url", "from", "last_page_url", "last_page", "links", "next_page_url", "path", "per_page", "prev_page_url", "to", "total" ] } }, "required": [ "success", "data" ] } } } } } }, "post": { "operationId": "admin.articles.store", "tags": [ "Article" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "title": { "type": "string", "maxLength": 255 }, "slug": { "type": [ "string", "null" ] }, "excerpt": { "type": "string" }, "content": { "type": "string" }, "category": { "type": "string" }, "tags": { "type": [ "array", "null" ], "items": { "type": "string" } }, "author": { "type": "string" }, "read_time": { "type": "string" }, "image_url": { "type": [ "string", "null" ], "format": "uri" }, "image_alt": { "type": [ "string", "null" ] }, "is_featured": { "type": [ "boolean", "null" ] }, "is_published": { "type": [ "boolean", "null" ] }, "sort_order": { "type": [ "integer", "null" ] } }, "required": [ "title", "excerpt", "content", "category", "author", "read_time" ] } } } }, "responses": { "201": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "allOf": [ { "$ref": "#/components/schemas/AdminArticleResource" }, { "type": "object", "required": [ "updatedBy" ] } ] }, "message": { "type": "string", "const": "Article created successfully." } }, "required": [ "success", "data", "message" ] } } } }, "422": { "$ref": "#/components/responses/ValidationException" } } } }, "/admin/articles/{id}": { "get": { "operationId": "admin.articles.show", "tags": [ "Article" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "allOf": [ { "$ref": "#/components/schemas/AdminArticleResource" }, { "type": "object", "required": [ "updatedBy" ] } ] } }, "required": [ "success", "data" ] } } } }, "404": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "error": { "type": "object", "properties": { "code": { "type": "string", "const": "NOT_FOUND" }, "message": { "type": "string", "const": "Article not found." } }, "required": [ "code", "message" ] } }, "required": [ "success", "error" ] } } } } } }, "put": { "operationId": "admin.articles.update", "tags": [ "Article" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "title": { "type": "string", "maxLength": 255 }, "slug": { "type": "string" }, "excerpt": { "type": "string" }, "content": { "type": "string" }, "category": { "type": "string" }, "tags": { "type": [ "array", "null" ], "items": { "type": "string" } }, "author": { "type": "string" }, "read_time": { "type": "string" }, "image_url": { "type": [ "string", "null" ], "format": "uri" }, "image_alt": { "type": [ "string", "null" ] }, "is_featured": { "type": "boolean" }, "is_published": { "type": "boolean" }, "sort_order": { "type": [ "integer", "null" ] } } } } } }, "responses": { "200": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "allOf": [ { "$ref": "#/components/schemas/AdminArticleResource" }, { "type": "object", "required": [ "updatedBy" ] } ] }, "message": { "type": "string", "const": "Article updated successfully." } }, "required": [ "success", "data", "message" ] } } } }, "404": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "error": { "type": "object", "properties": { "code": { "type": "string", "const": "NOT_FOUND" }, "message": { "type": "string", "const": "Article not found." } }, "required": [ "code", "message" ] } }, "required": [ "success", "error" ] } } } }, "422": { "$ref": "#/components/responses/ValidationException" } } }, "delete": { "operationId": "admin.articles.destroy", "tags": [ "Article" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "message": { "type": "string", "const": "Article deleted successfully." } }, "required": [ "success", "message" ] } } } }, "404": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "error": { "type": "object", "properties": { "code": { "type": "string", "const": "NOT_FOUND" }, "message": { "type": "string", "const": "Article not found." } }, "required": [ "code", "message" ] } }, "required": [ "success", "error" ] } } } } } } }, "/article-categories": { "get": { "operationId": "article-categories.index", "tags": [ "ArticleCategory" ], "parameters": [ { "name": "search", "in": "query", "description": "Search category by name or description", "schema": { "type": "string" } }, { "name": "page", "in": "query", "description": "Page number for pagination", "schema": { "type": "integer" } }, { "name": "limit", "in": "query", "description": "Items per page (max 50)", "schema": { "type": "integer" } }, { "name": "sort", "in": "query", "description": "Sort field (sort_order, name, created_at)", "schema": { "type": "string", "default": "sort_order" } }, { "name": "order", "in": "query", "description": "Sort direction (asc, desc)", "schema": { "type": "string", "default": "asc" } } ], "responses": { "200": { "description": "", "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/ArticleCategoryResource" } } }, "required": [ "success", "data" ] }, { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/ArticleCategoryResource" } }, "meta": { "type": "object", "properties": { "current_page": { "type": "integer" }, "per_page": { "type": "integer" }, "total": { "type": "integer" }, "last_page": { "type": "integer" } }, "required": [ "current_page", "per_page", "total", "last_page" ] } }, "required": [ "success", "data", "meta" ] } ] } } } } }, "security": [] } }, "/article-categories/{slug}": { "get": { "operationId": "article-categories.show", "tags": [ "ArticleCategory" ], "parameters": [ { "name": "slug", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "$ref": "#/components/schemas/ArticleCategoryResource" } }, "required": [ "success", "data" ] } } } }, "404": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "error": { "type": "object", "properties": { "code": { "type": "string", "const": "NOT_FOUND" }, "message": { "type": "string", "const": "Category not found." } }, "required": [ "code", "message" ] } }, "required": [ "success", "error" ] } } } } }, "security": [] } }, "/articles/categories": { "get": { "operationId": "articles.categories", "tags": [ "ArticleCategory" ], "parameters": [ { "name": "search", "in": "query", "description": "Search category by name or description", "schema": { "type": "string" } }, { "name": "page", "in": "query", "description": "Page number for pagination", "schema": { "type": "integer" } }, { "name": "limit", "in": "query", "description": "Items per page (max 50)", "schema": { "type": "integer" } }, { "name": "sort", "in": "query", "description": "Sort field (sort_order, name, created_at)", "schema": { "type": "string", "default": "sort_order" } }, { "name": "order", "in": "query", "description": "Sort direction (asc, desc)", "schema": { "type": "string", "default": "asc" } } ], "responses": { "200": { "description": "", "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/ArticleCategoryResource" } } }, "required": [ "success", "data" ] }, { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/ArticleCategoryResource" } }, "meta": { "type": "object", "properties": { "current_page": { "type": "integer" }, "per_page": { "type": "integer" }, "total": { "type": "integer" }, "last_page": { "type": "integer" } }, "required": [ "current_page", "per_page", "total", "last_page" ] } }, "required": [ "success", "data", "meta" ] } ] } } } } }, "security": [] } }, "/admin/article-categories": { "get": { "operationId": "admin.article-categories.index", "tags": [ "ArticleCategory" ], "responses": { "200": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "slug": { "type": "string" }, "description": { "type": [ "string", "null" ] }, "sortOrder": { "type": "integer" } }, "required": [ "id", "name", "slug", "description", "sortOrder" ] } } }, "required": [ "success", "data" ] } } } } } }, "post": { "operationId": "admin.article-categories.store", "tags": [ "ArticleCategory" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "maxLength": 255 }, "slug": { "type": [ "string", "null" ] }, "description": { "type": [ "string", "null" ] }, "sort_order": { "type": [ "integer", "null" ] } }, "required": [ "name" ] } } } }, "responses": { "201": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "slug": { "type": "string" }, "description": { "type": [ "string", "null" ] }, "sortOrder": { "type": "integer" } }, "required": [ "id", "name", "slug", "description", "sortOrder" ] }, "message": { "type": "string", "const": "Category created successfully." } }, "required": [ "success", "data", "message" ] } } } }, "422": { "$ref": "#/components/responses/ValidationException" } } } }, "/admin/article-categories/{id}": { "put": { "operationId": "admin.article-categories.update", "tags": [ "ArticleCategory" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "maxLength": 255 }, "slug": { "type": "string" }, "description": { "type": [ "string", "null" ] }, "sort_order": { "type": [ "integer", "null" ] } } } } } }, "responses": { "200": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "slug": { "type": "string" }, "description": { "type": [ "string", "null" ] }, "sortOrder": { "type": "integer" } }, "required": [ "id", "name", "slug", "description", "sortOrder" ] }, "message": { "type": "string", "const": "Category updated successfully." } }, "required": [ "success", "data", "message" ] } } } }, "404": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "error": { "type": "object", "properties": { "code": { "type": "string", "const": "NOT_FOUND" }, "message": { "type": "string", "const": "Category not found." } }, "required": [ "code", "message" ] } }, "required": [ "success", "error" ] } } } }, "422": { "$ref": "#/components/responses/ValidationException" } } }, "delete": { "operationId": "admin.article-categories.destroy", "tags": [ "ArticleCategory" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "message": { "type": "string", "const": "Category deleted successfully." } }, "required": [ "success", "message" ] } } } }, "404": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "error": { "type": "object", "properties": { "code": { "type": "string", "const": "NOT_FOUND" }, "message": { "type": "string", "const": "Category not found." } }, "required": [ "code", "message" ] } }, "required": [ "success", "error" ] } } } } } } }, "/checkout/register": { "post": { "operationId": "checkout.register", "tags": [ "Checkout" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "plan": { "type": "string", "enum": [ "monthly", "quarterly", "yearly" ] }, "name": { "type": "string", "maxLength": 255 }, "email": { "type": "string", "format": "email" }, "whatsapp": { "type": "string", "maxLength": 50 }, "discord": { "type": "string", "maxLength": 255 }, "telegram": { "type": [ "string", "null" ], "maxLength": 255 }, "coupon": { "type": [ "string", "null" ], "maxLength": 50 } }, "required": [ "plan", "name", "email", "whatsapp", "discord" ] } } } }, "responses": { "201": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object", "properties": { "member_id": { "type": "string" }, "plan": { "type": [ "string", "null" ] }, "amount": { "type": "string" }, "payment_url": { "type": "string" }, "expires_at": { "type": "string" } }, "required": [ "member_id", "plan", "amount", "payment_url", "expires_at" ] }, "message": { "type": "string", "const": "Checkout initiated. Complete payment within 30 minutes." } }, "required": [ "success", "data", "message" ] } } } }, "422": { "$ref": "#/components/responses/ValidationException" } }, "security": [] } }, "/contact": { "post": { "operationId": "contact", "tags": [ "Contact" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "maxLength": 255 }, "email": { "type": "string", "format": "email" }, "subject": { "type": "string", "maxLength": 255 }, "message": { "type": "string" }, "whatsapp": { "type": [ "string", "null" ], "maxLength": 50 } }, "required": [ "name", "email", "subject", "message" ] } } } }, "responses": { "200": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "message": { "type": "string", "const": "Message received. We'll reply within 1 business day." } }, "required": [ "success", "message" ] } } } }, "422": { "$ref": "#/components/responses/ValidationException" } }, "security": [] } }, "/content/{page}": { "get": { "operationId": "content.page", "tags": [ "Content" ], "parameters": [ { "name": "page", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "string" }, "cachedAt": { "type": "string" } }, "required": [ "success", "data", "cachedAt" ] } } } } }, "security": [] } }, "/content/{page}/{section}": { "get": { "operationId": "content.section", "tags": [ "Content" ], "parameters": [ { "name": "page", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "section", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "", "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "array", "items": {} }, "cachedAt": { "type": "string" } }, "required": [ "success", "data", "cachedAt" ] }, { "type": "object", "properties": { "success": { "type": "boolean" }, "data": {}, "cachedAt": { "type": "string" } }, "required": [ "success", "data", "cachedAt" ] } ] } } } }, "404": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "error": { "type": "object", "properties": { "code": { "type": "string", "const": "NOT_FOUND" }, "message": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "success", "error" ] } } } } }, "security": [] } }, "/admin/content": { "get": { "operationId": "admin.content.index", "tags": [ "Content" ], "parameters": [ { "name": "page", "in": "query", "description": "Filter by page key (e.g. home)", "schema": { "type": "string" } }, { "name": "block_type", "in": "query", "description": "Filter by block type (e.g. hero)", "schema": { "type": "string" } } ], "responses": { "200": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object", "properties": { "current_page": { "type": "integer", "minimum": 1 }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/ContentBlock" } }, "first_page_url": { "type": [ "string", "null" ] }, "from": { "type": [ "integer", "null" ], "minimum": 1 }, "last_page_url": { "type": [ "string", "null" ] }, "last_page": { "type": "integer", "minimum": 1 }, "links": { "type": "array", "description": "Generated paginator links.", "items": { "type": "object", "properties": { "url": { "type": [ "string", "null" ] }, "label": { "type": "string" }, "active": { "type": "boolean" } }, "required": [ "url", "label", "active" ] } }, "next_page_url": { "type": [ "string", "null" ] }, "path": { "type": [ "string", "null" ], "description": "Base path for paginator generated URLs." }, "per_page": { "type": "integer", "description": "Number of items shown per page.", "minimum": 0 }, "prev_page_url": { "type": [ "string", "null" ] }, "to": { "type": [ "integer", "null" ], "description": "Number of the last item in the slice.", "minimum": 1 }, "total": { "type": "integer", "description": "Total number of items being paginated.", "minimum": 0 } }, "required": [ "current_page", "data", "first_page_url", "from", "last_page_url", "last_page", "links", "next_page_url", "path", "per_page", "prev_page_url", "to", "total" ] } }, "required": [ "success", "data" ] } } } } } } }, "/admin/content/{id}": { "get": { "operationId": "admin.content.show", "tags": [ "Content" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "$ref": "#/components/schemas/ContentBlockResource" } }, "required": [ "success", "data" ] } } } }, "404": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "error": { "type": "object", "properties": { "code": { "type": "string", "const": "NOT_FOUND" }, "message": { "type": "string", "const": "Content block not found." } }, "required": [ "code", "message" ] } }, "required": [ "success", "error" ] } } } } } }, "put": { "operationId": "admin.content.update", "tags": [ "Content" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "operations": { "type": "array", "items": { "type": "object", "properties": { "op": { "type": "string", "enum": [ "update", "addItem", "removeItem", "replace" ] }, "path": { "type": "string" }, "value": { "type": [ "string", "null" ] }, "index": { "type": [ "integer", "null" ] } }, "required": [ "op", "path" ] }, "minItems": 1 } }, "required": [ "operations" ] } } } }, "responses": { "200": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "$ref": "#/components/schemas/ContentBlockResource" }, "message": { "type": "string", "const": "Content block updated successfully." } }, "required": [ "success", "data", "message" ] } } } }, "404": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "error": { "type": "object", "properties": { "code": { "type": "string", "const": "NOT_FOUND" }, "message": { "type": "string", "const": "Content block not found." } }, "required": [ "code", "message" ] } }, "required": [ "success", "error" ] } } } }, "422": { "$ref": "#/components/responses/ValidationException" } } } }, "/events": { "get": { "operationId": "events", "tags": [ "Event" ], "parameters": [ { "name": "status", "in": "query", "description": "Event status filter (upcoming, past, cancelled)", "schema": { "type": "string", "default": "upcoming" } }, { "name": "featured", "in": "query", "description": "Featured events only (true/false)", "schema": { "type": "boolean" } }, { "name": "page", "in": "query", "description": "Page number", "schema": { "type": "integer", "default": 1 } }, { "name": "limit", "in": "query", "description": "Items per page (max 50)", "schema": { "type": "integer", "default": 10 } } ], "responses": { "200": { "description": "Paginated set of `EventResource`", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/EventCollection" }, "links": { "type": "object", "properties": { "first": { "type": [ "string", "null" ] }, "last": { "type": [ "string", "null" ] }, "prev": { "type": [ "string", "null" ] }, "next": { "type": [ "string", "null" ] } }, "required": [ "first", "last", "prev", "next" ] }, "meta": { "type": "object", "properties": { "current_page": { "type": "integer", "minimum": 1 }, "from": { "type": [ "integer", "null" ], "minimum": 1 }, "last_page": { "type": "integer", "minimum": 1 }, "links": { "type": "array", "description": "Generated paginator links.", "items": { "type": "object", "properties": { "url": { "type": [ "string", "null" ] }, "label": { "type": "string" }, "active": { "type": "boolean" } }, "required": [ "url", "label", "active" ] } }, "path": { "type": [ "string", "null" ], "description": "Base path for paginator generated URLs." }, "per_page": { "type": "integer", "description": "Number of items shown per page.", "minimum": 0 }, "to": { "type": [ "integer", "null" ], "description": "Number of the last item in the slice.", "minimum": 1 }, "total": { "type": "integer", "description": "Total number of items being paginated.", "minimum": 0 } }, "required": [ "current_page", "from", "last_page", "links", "path", "per_page", "to", "total" ] } }, "required": [ "data", "links", "meta" ] } } } } }, "security": [] } }, "/events/{slug}": { "get": { "operationId": "events.show", "tags": [ "Event" ], "parameters": [ { "name": "slug", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "$ref": "#/components/schemas/EventResource" } }, "required": [ "success", "data" ] } } } }, "404": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "error": { "type": "object", "properties": { "code": { "type": "string", "const": "NOT_FOUND" }, "message": { "type": "string", "const": "Event not found." } }, "required": [ "code", "message" ] } }, "required": [ "success", "error" ] } } } } }, "security": [] } }, "/admin/events": { "get": { "operationId": "admin.events.index", "tags": [ "Event" ], "parameters": [ { "name": "status", "in": "query", "description": "Filter by event status (draft, upcoming, ongoing, past, cancelled)", "schema": { "type": "string" } }, { "name": "published", "in": "query", "description": "Filter by published status (true/false)", "schema": { "type": "string" } }, { "name": "limit", "in": "query", "description": "Items per page", "schema": { "type": "integer", "default": 20 } }, { "name": "page", "in": "query", "description": "Page number", "schema": { "type": "integer", "default": 1 } } ], "responses": { "200": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object", "properties": { "current_page": { "type": "integer", "minimum": 1 }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/Event" } }, "first_page_url": { "type": [ "string", "null" ] }, "from": { "type": [ "integer", "null" ], "minimum": 1 }, "last_page_url": { "type": [ "string", "null" ] }, "last_page": { "type": "integer", "minimum": 1 }, "links": { "type": "array", "description": "Generated paginator links.", "items": { "type": "object", "properties": { "url": { "type": [ "string", "null" ] }, "label": { "type": "string" }, "active": { "type": "boolean" } }, "required": [ "url", "label", "active" ] } }, "next_page_url": { "type": [ "string", "null" ] }, "path": { "type": [ "string", "null" ], "description": "Base path for paginator generated URLs." }, "per_page": { "type": "integer", "description": "Number of items shown per page.", "minimum": 0 }, "prev_page_url": { "type": [ "string", "null" ] }, "to": { "type": [ "integer", "null" ], "description": "Number of the last item in the slice.", "minimum": 1 }, "total": { "type": "integer", "description": "Total number of items being paginated.", "minimum": 0 } }, "required": [ "current_page", "data", "first_page_url", "from", "last_page_url", "last_page", "links", "next_page_url", "path", "per_page", "prev_page_url", "to", "total" ] } }, "required": [ "success", "data" ] } } } } } }, "post": { "operationId": "admin.events.store", "tags": [ "Event" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "title": { "type": "string", "maxLength": 255 }, "slug": { "type": [ "string", "null" ] }, "description": { "type": "string" }, "short_desc": { "type": "string" }, "date": { "type": "string", "format": "date-time" }, "time": { "type": "string" }, "end_time": { "type": [ "string", "null" ] }, "location_type": { "type": "string", "enum": [ "online", "offline", "hybrid" ] }, "place": { "type": "string" }, "meeting_url": { "type": [ "string", "null" ], "format": "uri" }, "seats": { "type": [ "integer", "null" ], "minimum": 0 }, "speaker": { "type": "string" }, "speaker_role": { "type": [ "string", "null" ] }, "speaker_photo_url": { "type": [ "string", "null" ], "format": "uri" }, "speaker_photo_alt": { "type": [ "string", "null" ] }, "agenda": { "type": [ "array", "null" ], "items": { "type": "string" } }, "cover_image_url": { "type": [ "string", "null" ], "format": "uri" }, "cover_image_alt": { "type": [ "string", "null" ] }, "status": { "type": [ "string", "null" ], "enum": [ "draft", "upcoming", "ongoing", "past", "cancelled", null ] }, "is_featured": { "type": [ "boolean", "null" ] }, "is_published": { "type": [ "boolean", "null" ] }, "sort_order": { "type": [ "integer", "null" ] }, "recording_url": { "type": [ "string", "null" ], "format": "uri" } }, "required": [ "title", "description", "short_desc", "date", "time", "location_type", "place", "speaker" ] } } } }, "responses": { "201": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "allOf": [ { "$ref": "#/components/schemas/AdminEventResource" }, { "type": "object", "required": [ "updatedBy" ] } ] }, "message": { "type": "string", "const": "Event created successfully." } }, "required": [ "success", "data", "message" ] } } } }, "422": { "$ref": "#/components/responses/ValidationException" } } } }, "/admin/events/{id}": { "get": { "operationId": "admin.events.show", "tags": [ "Event" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "$ref": "#/components/schemas/AdminEventResource" } }, "required": [ "success", "data" ] } } } }, "404": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "error": { "type": "object", "properties": { "code": { "type": "string", "const": "NOT_FOUND" }, "message": { "type": "string", "const": "Event not found." } }, "required": [ "code", "message" ] } }, "required": [ "success", "error" ] } } } } } }, "put": { "operationId": "admin.events.update", "tags": [ "Event" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "title": { "type": "string", "maxLength": 255 }, "slug": { "type": "string" }, "description": { "type": "string" }, "short_desc": { "type": "string" }, "date": { "type": "string", "format": "date-time" }, "time": { "type": "string" }, "end_time": { "type": [ "string", "null" ] }, "location_type": { "type": "string", "enum": [ "online", "offline", "hybrid" ] }, "place": { "type": "string" }, "meeting_url": { "type": [ "string", "null" ], "format": "uri" }, "seats": { "type": [ "integer", "null" ], "minimum": 0 }, "speaker": { "type": "string" }, "speaker_role": { "type": [ "string", "null" ] }, "speaker_photo_url": { "type": [ "string", "null" ], "format": "uri" }, "speaker_photo_alt": { "type": [ "string", "null" ] }, "agenda": { "type": [ "array", "null" ], "items": { "type": "string" } }, "cover_image_url": { "type": [ "string", "null" ], "format": "uri" }, "cover_image_alt": { "type": [ "string", "null" ] }, "status": { "type": [ "string", "null" ], "enum": [ "draft", "upcoming", "ongoing", "past", "cancelled", null ] }, "is_featured": { "type": "boolean" }, "is_published": { "type": "boolean" }, "sort_order": { "type": [ "integer", "null" ] }, "recording_url": { "type": [ "string", "null" ], "format": "uri" } } } } } }, "responses": { "200": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "allOf": [ { "$ref": "#/components/schemas/AdminEventResource" }, { "type": "object", "required": [ "updatedBy" ] } ] }, "message": { "type": "string", "const": "Event updated successfully." } }, "required": [ "success", "data", "message" ] } } } }, "404": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "error": { "type": "object", "properties": { "code": { "type": "string", "const": "NOT_FOUND" }, "message": { "type": "string", "const": "Event not found." } }, "required": [ "code", "message" ] } }, "required": [ "success", "error" ] } } } }, "422": { "$ref": "#/components/responses/ValidationException" } } }, "delete": { "operationId": "admin.events.destroy", "tags": [ "Event" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "message": { "type": "string", "const": "Event deleted successfully." } }, "required": [ "success", "message" ] } } } }, "404": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "error": { "type": "object", "properties": { "code": { "type": "string", "const": "NOT_FOUND" }, "message": { "type": "string", "const": "Event not found." } }, "required": [ "code", "message" ] } }, "required": [ "success", "error" ] } } } } } } }, "/landing/{page}": { "get": { "operationId": "landing", "summary": "Get complete landing page data (nav settings, section content blocks, top 3 featured articles, top 3 upcoming events)", "tags": [ "Landing" ], "parameters": [ { "name": "page", "in": "path", "required": true, "description": "Page identifier (e.g. home)", "schema": { "type": "string" } } ], "responses": { "200": { "description": "", "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object", "properties": { "nav": { "type": [ "string", "null" ] }, "blocks": { "type": "string" }, "featuredArticles": { "type": "array", "items": {} }, "upcomingEvents": { "type": "array", "items": {} } }, "required": [ "nav", "blocks", "featuredArticles", "upcomingEvents" ] }, "cachedAt": { "type": "string" } }, "required": [ "success", "data", "cachedAt" ] }, { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "string" }, "cachedAt": { "type": "string" } }, "required": [ "success", "data", "cachedAt" ] } ] } } } } }, "security": [] } }, "/auth/login": { "post": { "operationId": "auth.login", "tags": [ "Login" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "email": { "type": "string", "format": "email" }, "password": { "type": "string" } }, "required": [ "email", "password" ] } } } }, "responses": { "200": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "email": { "type": "string" }, "isActive": { "type": "boolean" }, "lastLogin": { "type": [ "string", "null" ] } }, "required": [ "id", "name", "email", "isActive", "lastLogin" ] } }, "required": [ "success", "data" ] } } } }, "401": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "error": { "type": "object", "properties": { "code": { "type": "string", "const": "INVALID_CREDENTIALS" }, "message": { "type": "string", "const": "Invalid email or password." } }, "required": [ "code", "message" ] } }, "required": [ "success", "error" ] } } } }, "422": { "$ref": "#/components/responses/ValidationException" } }, "security": [] } }, "/auth/logout": { "post": { "operationId": "auth.logout", "tags": [ "Logout" ], "responses": { "200": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "message": { "type": "string", "const": "Logged out successfully." } }, "required": [ "success", "message" ] } } } }, "401": { "$ref": "#/components/responses/AuthenticationException" } }, "security": [] } }, "/auth/me": { "get": { "operationId": "auth.me", "tags": [ "Me" ], "responses": { "200": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "email": { "type": "string" }, "isActive": { "type": "string" }, "lastLogin": { "type": [ "string", "null" ] }, "createdAt": { "type": [ "string", "null" ] } }, "required": [ "id", "name", "email", "isActive", "lastLogin", "createdAt" ] } }, "required": [ "success", "data" ] } } } }, "401": { "$ref": "#/components/responses/AuthenticationException" } }, "security": [] } }, "/admin/media": { "get": { "operationId": "admin.media.index", "tags": [ "Media" ], "parameters": [ { "name": "mime_type", "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object", "properties": { "current_page": { "type": "integer", "minimum": 1 }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/Media" } }, "first_page_url": { "type": [ "string", "null" ] }, "from": { "type": [ "integer", "null" ], "minimum": 1 }, "last_page_url": { "type": [ "string", "null" ] }, "last_page": { "type": "integer", "minimum": 1 }, "links": { "type": "array", "description": "Generated paginator links.", "items": { "type": "object", "properties": { "url": { "type": [ "string", "null" ] }, "label": { "type": "string" }, "active": { "type": "boolean" } }, "required": [ "url", "label", "active" ] } }, "next_page_url": { "type": [ "string", "null" ] }, "path": { "type": [ "string", "null" ], "description": "Base path for paginator generated URLs." }, "per_page": { "type": "integer", "description": "Number of items shown per page.", "minimum": 0 }, "prev_page_url": { "type": [ "string", "null" ] }, "to": { "type": [ "integer", "null" ], "description": "Number of the last item in the slice.", "minimum": 1 }, "total": { "type": "integer", "description": "Total number of items being paginated.", "minimum": 0 } }, "required": [ "current_page", "data", "first_page_url", "from", "last_page_url", "last_page", "links", "next_page_url", "path", "per_page", "prev_page_url", "to", "total" ] } }, "required": [ "success", "data" ] } } } } } } }, "/admin/media/upload": { "post": { "operationId": "admin.media.upload", "tags": [ "Media" ], "requestBody": { "required": true, "content": { "multipart/form-data": { "schema": { "type": "object", "properties": { "file": { "type": "string", "format": "binary", "contentMediaType": "application/octet-stream", "description": "Maximum file size: 10240 kilobytes." }, "alt": { "type": [ "string", "null" ], "maxLength": 255 } }, "required": [ "file" ] } } } }, "responses": { "201": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "$ref": "#/components/schemas/Media" }, "message": { "type": "string", "const": "File uploaded successfully." } }, "required": [ "success", "data", "message" ] } } } }, "500": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "error": { "type": "object", "properties": { "code": { "type": "string", "const": "UPLOAD_FAILED" }, "message": { "type": "string", "const": "Failed to store file." } }, "required": [ "code", "message" ] } }, "required": [ "success", "error" ] } } } }, "422": { "$ref": "#/components/responses/ValidationException" } } } }, "/admin/media/{id}": { "delete": { "operationId": "admin.media.destroy", "tags": [ "Media" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "message": { "type": "string", "const": "Media file deleted successfully." } }, "required": [ "success", "message" ] } } } }, "409": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "error": { "type": "object", "properties": { "code": { "type": "string", "const": "IN_USE" }, "message": { "type": "string", "const": "Image is in use and cannot be deleted." } }, "required": [ "code", "message" ] } }, "required": [ "success", "error" ] } } } }, "404": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "error": { "type": "object", "properties": { "code": { "type": "string", "const": "NOT_FOUND" }, "message": { "type": "string", "const": "Media file not found." } }, "required": [ "code", "message" ] } }, "required": [ "success", "error" ] } } } } } } }, "/newsletter": { "post": { "operationId": "newsletter", "tags": [ "Newsletter" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "email": { "type": "string", "format": "email" } }, "required": [ "email" ] } } } }, "responses": { "200": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "message": { "type": "string", "const": "Subscribed successfully." } }, "required": [ "success", "message" ] } } } }, "422": { "$ref": "#/components/responses/ValidationException" } }, "security": [] } }, "/partnership/inquiry": { "post": { "operationId": "partnership.inquiry", "tags": [ "Partnership" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "company": { "type": "string", "maxLength": 255 }, "contact_name": { "type": "string", "maxLength": 255 }, "email": { "type": "string", "format": "email" }, "phone": { "type": [ "string", "null" ], "maxLength": 50 }, "message": { "type": [ "string", "null" ] } }, "required": [ "company", "contact_name", "email" ] } } } }, "responses": { "200": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "message": { "type": "string", "const": "Inquiry received. We'll be in touch within 1-2 business days." } }, "required": [ "success", "message" ] } } } }, "422": { "$ref": "#/components/responses/ValidationException" } }, "security": [] } }, "/auth/refresh": { "post": { "operationId": "auth.refresh", "tags": [ "Refresh" ], "responses": { "200": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "object", "properties": { "id": { "type": "integer" }, "name": { "type": "string" }, "email": { "type": "string" } }, "required": [ "id", "name", "email" ] } }, "required": [ "success", "data" ] } } } }, "401": { "$ref": "#/components/responses/AuthenticationException" } }, "security": [] } }, "/site-settings": { "get": { "operationId": "site-settings", "tags": [ "SiteSettings" ], "responses": { "200": { "description": "", "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "string" }, "cachedAt": { "type": "string" } }, "required": [ "success", "data", "cachedAt" ] }, { "type": "object", "properties": { "success": { "type": "boolean" }, "data": {}, "cachedAt": { "type": "string" } }, "required": [ "success", "data", "cachedAt" ] } ] } } } } }, "security": [] } }, "/admin/site-settings": { "get": { "operationId": "admin.site-settings.index", "tags": [ "SiteSettings" ], "responses": { "200": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "string" } }, "required": [ "success", "data" ] } } } } } }, "put": { "operationId": "admin.site-settings.update", "tags": [ "SiteSettings" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "key": { "type": "string", "enum": [ "nav", "footer", "branding", "announcementBar", "seo" ] }, "value": { "type": "array", "items": { "type": "string" }, "minItems": 1 } }, "required": [ "key", "value" ] } } } }, "responses": { "200": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "message": { "type": "string", "const": "Site setting updated successfully." } }, "required": [ "success", "message" ] } } } }, "422": { "$ref": "#/components/responses/ValidationException" } } } } }, "components": { "securitySchemes": { "AdminApiToken": { "type": "apiKey", "in": "header", "name": "X-Api-Token" } }, "schemas": { "AdminArticleResource": { "type": "object", "properties": { "id": { "type": "string" }, "slug": { "type": "string" }, "title": { "type": "string" }, "excerpt": { "type": [ "string", "null" ] }, "content": { "type": [ "string", "null" ] }, "category": { "type": "string" }, "tags": { "type": "array", "items": {} }, "author": { "type": "string" }, "readTime": { "type": "string" }, "imageUrl": { "type": [ "string", "null" ] }, "imageAlt": { "type": [ "string", "null" ] }, "isFeatured": { "type": "boolean" }, "isPublished": { "type": "boolean" }, "sortOrder": { "type": "integer" }, "publishedAt": { "type": [ "string", "null" ] }, "createdAt": { "type": [ "string", "null" ] }, "updatedAt": { "type": [ "string", "null" ] }, "updatedBy": { "type": [ "string", "null" ] } }, "required": [ "id", "slug", "title", "excerpt", "content", "category", "tags", "author", "readTime", "imageUrl", "imageAlt", "isFeatured", "isPublished", "sortOrder", "publishedAt", "createdAt", "updatedAt" ], "title": "AdminArticleResource" }, "AdminEventResource": { "type": "object", "properties": { "id": { "type": "string" }, "slug": { "type": "string" }, "title": { "type": "string" }, "description": { "type": "string" }, "shortDesc": { "type": "string" }, "date": { "type": "string" }, "time": { "type": "string" }, "endTime": { "type": [ "string", "null" ] }, "locationType": { "type": "string" }, "place": { "type": "string" }, "meetingUrl": { "type": [ "string", "null" ] }, "seats": { "type": "integer" }, "seatsTaken": { "type": "integer" }, "isFull": { "type": "boolean" }, "speaker": { "type": "string" }, "speakerRole": { "type": [ "string", "null" ] }, "speakerPhotoUrl": { "type": [ "string", "null" ] }, "speakerPhotoAlt": { "type": [ "string", "null" ] }, "agenda": { "type": "array", "items": {} }, "coverImageUrl": { "type": [ "string", "null" ] }, "coverImageAlt": { "type": [ "string", "null" ] }, "status": { "type": "string" }, "isFeatured": { "type": "boolean" }, "isPublished": { "type": "boolean" }, "sortOrder": { "type": "integer" }, "recordingUrl": { "type": [ "string", "null" ] }, "createdAt": { "type": [ "string", "null" ] }, "updatedAt": { "type": [ "string", "null" ] }, "updatedBy": { "type": [ "string", "null" ] } }, "required": [ "id", "slug", "title", "description", "shortDesc", "date", "time", "endTime", "locationType", "place", "meetingUrl", "seats", "seatsTaken", "isFull", "speaker", "speakerRole", "speakerPhotoUrl", "speakerPhotoAlt", "agenda", "coverImageUrl", "coverImageAlt", "status", "isFeatured", "isPublished", "sortOrder", "recordingUrl", "createdAt", "updatedAt" ], "title": "AdminEventResource" }, "Article": { "type": "object", "properties": { "id": { "type": "string" }, "slug": { "type": "string" }, "title": { "type": "string" }, "excerpt": { "type": "string" }, "content": { "type": "string" }, "category": { "type": "string" }, "tags": { "type": "array", "items": {} }, "author": { "type": "string" }, "read_time": { "type": "string" }, "image_url": { "type": [ "string", "null" ] }, "image_alt": { "type": [ "string", "null" ] }, "is_featured": { "type": "boolean" }, "is_published": { "type": "boolean" }, "sort_order": { "type": "integer" }, "published_at": { "type": [ "string", "null" ], "format": "date-time" }, "created_at": { "type": [ "string", "null" ], "format": "date-time" }, "updated_at": { "type": [ "string", "null" ], "format": "date-time" }, "updated_by": { "type": [ "string", "null" ] } }, "required": [ "id", "slug", "title", "excerpt", "content", "category", "tags", "author", "read_time", "image_url", "image_alt", "is_featured", "is_published", "sort_order", "published_at", "created_at", "updated_at", "updated_by" ], "title": "Article" }, "ArticleCategoryResource": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "slug": { "type": "string" }, "description": { "type": [ "string", "null" ] }, "sortOrder": { "type": "integer" }, "createdAt": { "type": [ "string", "null" ] }, "updatedAt": { "type": [ "string", "null" ] } }, "required": [ "id", "name", "slug", "description", "sortOrder", "createdAt", "updatedAt" ], "title": "ArticleCategoryResource" }, "ArticleCollection": { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/ArticleResource" } }, "meta": { "type": "object", "properties": { "current_page": { "type": "string" }, "per_page": { "type": "string" }, "total": { "type": "string" }, "last_page": { "type": "string" } }, "required": [ "current_page", "per_page", "total", "last_page" ] } }, "required": [ "success", "data", "meta" ], "title": "ArticleCollection" }, "ArticleResource": { "type": "object", "properties": { "id": { "type": "string" }, "slug": { "type": "string" }, "title": { "type": "string" }, "excerpt": { "type": [ "string", "null" ] }, "content": { "type": [ "string", "null" ] }, "category": { "type": "string" }, "tags": { "type": "array", "items": {} }, "author": { "type": "string" }, "readTime": { "type": "string" }, "image": { "type": [ "object", "null" ], "properties": { "url": { "type": [ "string", "null" ] }, "alt": { "type": "string" } }, "required": [ "url", "alt" ] }, "isFeatured": { "type": "boolean" }, "publishedAt": { "type": [ "string", "null" ] }, "createdAt": { "type": [ "string", "null" ] } }, "required": [ "id", "slug", "title", "excerpt", "content", "category", "tags", "author", "readTime", "image", "isFeatured", "publishedAt", "createdAt" ], "title": "ArticleResource" }, "AuditLog": { "type": "object", "properties": { "id": { "type": "string" }, "admin_id": { "type": [ "string", "null" ] }, "action": { "type": "string" }, "block_id": { "type": [ "string", "null" ] }, "block_page": { "type": [ "string", "null" ] }, "block_section": { "type": [ "string", "null" ] }, "metadata": { "type": [ "array", "null" ], "items": {} }, "ip_address": { "type": [ "string", "null" ] }, "created_at": { "type": [ "string", "null" ], "format": "date-time" }, "updated_at": { "type": [ "string", "null" ], "format": "date-time" } }, "required": [ "id", "admin_id", "action", "block_id", "block_page", "block_section", "metadata", "ip_address", "created_at", "updated_at" ], "title": "AuditLog" }, "BlockType": { "type": "string", "enum": [ "HeroBlock", "StatsBlock", "CardGridBlock", "ScheduleBlock", "FAQBlock", "FAQGroupBlock", "TestimonialBlock", "EventBlock", "ArticleBlock", "PartnerBlock", "MentorBlock", "ResearchBlock", "GalleryBlock", "PricingBlock", "CTABlock", "RichTextBlock", "ContactBlock", "SiteSettingsBlock", "CustomBlock", "FeaturedArticleBlock", "NewsletterBlock", "FeaturedEventBlock", "FooterBlock", "NavBlock" ], "title": "BlockType" }, "ContentBlock": { "type": "object", "properties": { "id": { "type": "string" }, "page": { "type": "string" }, "section": { "type": "string" }, "block_type": { "$ref": "#/components/schemas/BlockType" }, "locale": { "type": "string" }, "data": { "type": "array", "items": {} }, "updated_by": { "type": [ "string", "null" ] }, "created_at": { "type": [ "string", "null" ], "format": "date-time" }, "updated_at": { "type": [ "string", "null" ], "format": "date-time" } }, "required": [ "id", "page", "section", "block_type", "locale", "data", "updated_by", "created_at", "updated_at" ], "title": "ContentBlock" }, "ContentBlockResource": { "type": "object", "properties": { "id": { "type": "string" }, "page": { "type": "string" }, "section": { "type": "string" }, "blockType": { "anyOf": [ { "type": "string" }, { "$ref": "#/components/schemas/BlockType" } ] }, "locale": { "type": "string" }, "data": { "type": "string" }, "updatedAt": { "type": [ "string", "null" ] }, "updatedBy": { "type": [ "string", "null" ] } }, "required": [ "id", "page", "section", "blockType", "locale", "data", "updatedAt" ], "title": "ContentBlockResource" }, "Event": { "type": "object", "properties": { "id": { "type": "string" }, "slug": { "type": "string" }, "title": { "type": "string" }, "description": { "type": "string" }, "short_desc": { "type": "string" }, "date": { "type": "string", "format": "date-time" }, "time": { "type": "string" }, "end_time": { "type": [ "string", "null" ] }, "location_type": { "type": "string" }, "place": { "type": "string" }, "meeting_url": { "type": [ "string", "null" ] }, "seats": { "type": "integer" }, "seats_taken": { "type": "integer" }, "is_full": { "type": "boolean" }, "speaker": { "type": "string" }, "speaker_role": { "type": [ "string", "null" ] }, "speaker_photo_url": { "type": [ "string", "null" ] }, "speaker_photo_alt": { "type": [ "string", "null" ] }, "agenda": { "type": "array", "items": {} }, "cover_image_url": { "type": [ "string", "null" ] }, "cover_image_alt": { "type": [ "string", "null" ] }, "status": { "type": "string" }, "is_featured": { "type": "boolean" }, "is_published": { "type": "boolean" }, "sort_order": { "type": "integer" }, "recording_url": { "type": [ "string", "null" ] }, "created_at": { "type": [ "string", "null" ], "format": "date-time" }, "updated_at": { "type": [ "string", "null" ], "format": "date-time" }, "updated_by": { "type": [ "string", "null" ] } }, "required": [ "id", "slug", "title", "description", "short_desc", "date", "time", "end_time", "location_type", "place", "meeting_url", "seats", "seats_taken", "is_full", "speaker", "speaker_role", "speaker_photo_url", "speaker_photo_alt", "agenda", "cover_image_url", "cover_image_alt", "status", "is_featured", "is_published", "sort_order", "recording_url", "created_at", "updated_at", "updated_by" ], "title": "Event" }, "EventCollection": { "anyOf": [ { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/EventResource" } }, "meta": { "type": "object", "properties": { "total": { "type": "string" } }, "required": [ "total" ] } }, "required": [ "success", "data", "meta" ] }, { "type": "object", "properties": { "success": { "type": "boolean" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/EventResource" } }, "meta": { "type": "object", "properties": { "current_page": { "type": "string" }, "per_page": { "type": "string" }, "total": { "type": "string" }, "last_page": { "type": "string" } }, "required": [ "current_page", "per_page", "total", "last_page" ] } }, "required": [ "success", "data", "meta" ] } ], "title": "EventCollection" }, "EventResource": { "type": "object", "properties": { "id": { "type": "string" }, "slug": { "type": "string" }, "title": { "type": "string" }, "description": { "type": "string" }, "shortDesc": { "type": "string" }, "date": { "type": "string" }, "time": { "type": "string" }, "endTime": { "type": [ "string", "null" ] }, "locationType": { "type": "string" }, "place": { "type": "string" }, "meetingUrl": { "type": [ "string", "null" ] }, "seats": { "type": "integer" }, "seatsTaken": { "type": "integer" }, "isFull": { "type": "boolean" }, "speaker": { "type": "string" }, "speakerRole": { "type": [ "string", "null" ] }, "speakerPhoto": { "type": [ "object", "null" ], "properties": { "url": { "type": [ "string", "null" ] }, "alt": { "type": "string" } }, "required": [ "url", "alt" ] }, "agenda": { "type": "array", "items": {} }, "coverImage": { "type": [ "object", "null" ], "properties": { "url": { "type": [ "string", "null" ] }, "alt": { "type": "string" } }, "required": [ "url", "alt" ] }, "status": { "type": "string" }, "isFeatured": { "type": "boolean" }, "recordingUrl": { "type": [ "string", "null" ] }, "createdAt": { "type": [ "string", "null" ] } }, "required": [ "id", "slug", "title", "description", "shortDesc", "date", "time", "endTime", "locationType", "place", "meetingUrl", "seats", "seatsTaken", "isFull", "speaker", "speakerRole", "speakerPhoto", "agenda", "coverImage", "status", "isFeatured", "recordingUrl", "createdAt" ], "title": "EventResource" }, "Media": { "type": "object", "properties": { "id": { "type": "string" }, "filename": { "type": "string" }, "original_name": { "type": "string" }, "url": { "type": "string" }, "mime_type": { "type": "string" }, "size": { "type": "integer" }, "width": { "type": [ "integer", "null" ] }, "height": { "type": [ "integer", "null" ] }, "alt": { "type": [ "string", "null" ] }, "uploaded_by": { "type": [ "string", "null" ] }, "created_at": { "type": [ "string", "null" ], "format": "date-time" }, "updated_at": { "type": [ "string", "null" ], "format": "date-time" }, "resized_url": { "type": [ "string", "null" ] }, "thumbnail_url": { "type": [ "string", "null" ] } }, "required": [ "id", "filename", "original_name", "url", "mime_type", "size", "width", "height", "alt", "uploaded_by", "created_at", "updated_at", "resized_url", "thumbnail_url" ], "title": "Media" } }, "responses": { "ValidationException": { "description": "Validation error", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "description": "Errors overview." }, "errors": { "type": "object", "description": "A detailed description of each field that failed validation.", "additionalProperties": { "type": "array", "items": { "type": "string" } } } }, "required": [ "message", "errors" ] } } } }, "AuthenticationException": { "description": "Unauthenticated", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "description": "Error overview." } }, "required": [ "message" ] } } } } } } }