{"openapi":"3.1.0","info":{"title":"Hallelujah Challenge App API","description":"Backend Service API for Hallelujah Challenge App. All API endpoints require the x-timezone header for proper timezone conversion.","contact":{"name":"HC Development Team","email":"support@hcapp.com"},"license":{"name":"MIT License","url":"https://opensource.org/licenses/MIT"},"version":"1.0.0"},"servers":[{"url":"http://localhost:8080","description":"Development Server"},{"url":"https://api-staging-hc.softloom.com.ng/","description":"Staging Server"}],"security":[{"bearerAuth":[]}],"tags":[{"name":"Course Management","description":"Progressive course and module creation workflow"},{"name":"User","description":"Authenticated user endpoints"},{"name":"Milestones","description":"User-facing milestone operations"},{"name":"Admin Management","description":"Listing/lookup of admin accounts"},{"name":"Profile","description":"Current user profile operations"},{"name":"Daily Scripture","description":"Daily scripture endpoints"},{"name":"Dashboard","description":"Admin dashboard metrics"},{"name":"Testimony Management","description":"Admin CRUD for testimonies"},{"name":"Challenges","description":"User-facing challenge v2 browsing and completion"},{"name":"Challenge Management","description":"Challenge CRUD operations"},{"name":"Metadata","description":"Public metadata endpoints"},{"name":"Courses","description":"User-facing course actions"},{"name":"User Auth","description":"Public endpoints for user authentication and signup"},{"name":"Bible","description":"Endpoints to browse local Bible data and manage user blacklists"},{"name":"Achievements","description":"User-facing achievement operations"},{"name":"Devotional Management","description":"Daily devotional CRUD operations"},{"name":"Devotional","description":"Devotional content sourced from the Wonders API"},{"name":"Media","description":"Browse media items"},{"name":"Testimonies","description":"Browse testimonies"},{"name":"Address","description":"Authenticated user address endpoints"},{"name":"Daily Scripture Management","description":"Daily scripture CRUD operations"},{"name":"Enquiries","description":"Authenticated enquiry endpoints"},{"name":"Bible Plan Management","description":"Multi-day bible plan workflow"},{"name":"Challenge Management","description":"Multi-day challenge workflow"},{"name":"Scriptures","description":"User-facing saved scripture operations"},{"name":"Devotionals","description":"User-facing daily devotional browsing"},{"name":"Challenges","description":"User-facing challenge browsing"},{"name":"Event Management","description":"Event CRUD operations"},{"name":"Bible Plans","description":"User-facing bible plan browsing and impact"},{"name":"Media Management","description":"Admin CRUD for media"},{"name":"Admin Authentication","description":"APIs for admin user authentication and management"},{"name":"Role Management","description":"Admin roles and privileges"},{"name":"Events","description":"User-facing event browsing"}],"paths":{"/api/v1/user":{"put":{"tags":["User"],"summary":"Update current user's profile (firstName, lastName, phoneNumber)","operationId":"updateProfile","parameters":[{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateProfileRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseString"}}}}}},"delete":{"tags":["User"],"summary":"Delete the authenticated user's account","operationId":"deleteAccount","parameters":[{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseString"}}}}}}},"/api/v1/testimonies/{testimonyId}/like":{"put":{"tags":["Testimonies"],"summary":"Like a testimony (idempotent)","operationId":"likeTestimony","parameters":[{"name":"testimonyId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"securityContext","in":"query","required":true,"schema":{"$ref":"#/components/schemas/SecurityContext"}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseLong"}}}}}},"delete":{"tags":["Testimonies"],"summary":"Unlike a testimony (idempotent)","operationId":"unlikeTestimony","parameters":[{"name":"testimonyId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"securityContext","in":"query","required":true,"schema":{"$ref":"#/components/schemas/SecurityContext"}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseLong"}}}}}}},"/api/v1/bible-plans/{devotionalId}/items/{itemId}/complete":{"put":{"tags":["Bible Plans"],"summary":"Mark a bible plan item as complete","operationId":"markItemComplete","parameters":[{"name":"devotionalId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"itemId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseDevotionalV2ItemCompletionResponse"}}}}}},"delete":{"tags":["Bible Plans"],"summary":"Unmark a bible plan item as complete","operationId":"unmarkItemComplete","parameters":[{"name":"devotionalId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"itemId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseDevotionalV2ItemCompletionResponse"}}}}}}},"/api/v1/bible-plans/{devotionalId}/days/{dayNumber}/complete":{"put":{"tags":["Bible Plans"],"summary":"Mark a bible plan day as complete","operationId":"markDayComplete","parameters":[{"name":"devotionalId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"dayNumber","in":"path","required":true,"schema":{"type":"integer","format":"int32"}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseDevotionalV2ItemCompletionResponse"}}}}}},"delete":{"tags":["Bible Plans"],"summary":"Unmark a bible plan day as complete","operationId":"unmarkDayComplete","parameters":[{"name":"devotionalId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"dayNumber","in":"path","required":true,"schema":{"type":"integer","format":"int32"}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseDevotionalV2ItemCompletionResponse"}}}}}}},"/api/v1/admin/testimonies/{testimonyId}":{"put":{"tags":["Testimony Management"],"summary":"Update a testimony (admin)","operationId":"updateTestimony","parameters":[{"name":"testimonyId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateTestimonyRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseAdminTestimonyResponse"}}}}},"security":[{"bearerAuth":[]}]},"delete":{"tags":["Testimony Management"],"summary":"Delete a testimony (admin)","operationId":"deleteTestimony","parameters":[{"name":"testimonyId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseVoid"}}}}},"security":[{"bearerAuth":[]}]}},"/api/v1/admin/scriptures/{scriptureId}":{"get":{"tags":["Daily Scripture Management"],"summary":"Get scripture by ID","operationId":"getScriptureById","parameters":[{"name":"scriptureId","in":"path","description":"Scripture ID","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseAdminDailyScriptureResponse"}}}}},"security":[{"bearerAuth":[]}]},"put":{"tags":["Daily Scripture Management"],"summary":"Update a daily scripture","operationId":"updateScripture","parameters":[{"name":"scriptureId","in":"path","description":"Scripture ID","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateDailyScriptureRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseAdminDailyScriptureResponse"}}}}},"security":[{"bearerAuth":[]}]},"delete":{"tags":["Daily Scripture Management"],"summary":"Delete a scripture","operationId":"deleteScripture","parameters":[{"name":"scriptureId","in":"path","description":"Scripture ID","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseVoid"}}}}},"security":[{"bearerAuth":[]}]}},"/api/v1/admin/roles/{roleId}":{"put":{"tags":["Role Management"],"summary":"Update a role's name, description and privileges","operationId":"updateRole","parameters":[{"name":"roleId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateRoleRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseRoleResponse"}}}}},"security":[{"bearerAuth":[]}]},"delete":{"tags":["Role Management"],"summary":"Delete a role (fails if any admin still holds it)","operationId":"deleteRole","parameters":[{"name":"roleId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseVoid"}}}}},"security":[{"bearerAuth":[]}]}},"/api/v1/admin/events/{eventId}":{"get":{"tags":["Event Management"],"summary":"Get event by ID","description":"Retrieves a specific event by its ID. Event date/time will be converted to client timezone.","operationId":"getEventById","parameters":[{"name":"eventId","in":"path","description":"Event ID","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseEventResponse"}}}}},"security":[{"bearerAuth":[]}]},"put":{"tags":["Event Management"],"summary":"Update an event","description":"Updates an existing event with the provided details and optional new banner image. Event date/time will be converted from client timezone to system timezone.","operationId":"updateEvent","parameters":[{"name":"eventId","in":"path","description":"Event ID","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/UpdateEventRequest"}}}},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseEventResponse"}}}}},"security":[{"bearerAuth":[]}]},"delete":{"tags":["Event Management"],"summary":"Delete an event","description":"Deletes an event by its ID","operationId":"deleteEvent","parameters":[{"name":"eventId","in":"path","description":"Event ID","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseVoid"}}}}},"security":[{"bearerAuth":[]}]}},"/api/v1/admin/courses/{courseId}":{"get":{"tags":["Course Management"],"summary":"Get course details","operationId":"getCourseById","parameters":[{"name":"courseId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseAdminCourseResponse"}}}}},"security":[{"bearerAuth":[]}]},"put":{"tags":["Course Management"],"summary":"Update course","description":"Updates the course title, description and optionally replaces its cover image or GIF. Omit the image to keep the current one.","operationId":"updateCourse","parameters":[{"name":"courseId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/UpdateCourseRequest"}}}},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseAdminCourseResponse"}}}}},"security":[{"bearerAuth":[]}]},"delete":{"tags":["Course Management"],"summary":"Delete course","operationId":"deleteCourse","parameters":[{"name":"courseId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseVoid"}}}}},"security":[{"bearerAuth":[]}]}},"/api/v1/admin/courses/modules/{moduleId}":{"put":{"tags":["Course Management"],"summary":"Update module","operationId":"updateModule","parameters":[{"name":"moduleId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateModuleRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseAdminModuleResponse"}}}}},"security":[{"bearerAuth":[]}]},"delete":{"tags":["Course Management"],"summary":"Delete a module","operationId":"deleteModule","parameters":[{"name":"moduleId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseVoid"}}}}},"security":[{"bearerAuth":[]}]}},"/api/v1/admin/courses/modules/{moduleId}/content":{"put":{"tags":["Course Management"],"summary":"Step 3: Add content to module","operationId":"addModuleContent","parameters":[{"name":"moduleId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddModuleContentRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseAdminModuleResponse"}}}}},"security":[{"bearerAuth":[]}]}},"/api/v1/admin/courses/modules/activities/{activityId}":{"put":{"tags":["Course Management"],"summary":"Update activity","operationId":"updateModuleActivity","parameters":[{"name":"activityId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateActivityRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseAdminActivityResponse"}}}}},"security":[{"bearerAuth":[]}]},"delete":{"tags":["Course Management"],"summary":"Delete activity","operationId":"deleteModuleActivity","parameters":[{"name":"activityId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseVoid"}}}}},"security":[{"bearerAuth":[]}]}},"/api/v1/admin/challenges/{challengeId}":{"get":{"tags":["Challenge Management"],"summary":"Get challenge series with day items","operationId":"getChallengeV2ById","parameters":[{"name":"challengeId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseAdminChallengeSeriesDetailResponse"}}}}},"security":[{"bearerAuth":[]}]},"put":{"tags":["Challenge Management"],"summary":"Update challenge series details (non-item fields)","operationId":"updateChallengeV2","parameters":[{"name":"challengeId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateChallengeV2Request"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseAdminChallengeSeriesDetailResponse"}}}}},"security":[{"bearerAuth":[]}]},"delete":{"tags":["Challenge Management"],"summary":"Hard delete challenge series","operationId":"deleteChallengeV2","parameters":[{"name":"challengeId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseVoid"}}}}},"security":[{"bearerAuth":[]}]}},"/api/v1/admin/challenges/{challengeId}/items/{dayNumber}":{"put":{"tags":["Challenge Management"],"summary":"Add or replace challenge item for a day","operationId":"upsertChallengeItemV2","parameters":[{"name":"challengeId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"dayNumber","in":"path","required":true,"schema":{"type":"integer","format":"int32","minimum":1}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpsertChallengeItemRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseChallengeItemResponse"}}}}},"security":[{"bearerAuth":[]}]}},"/api/v1/admin/bible-plans/{devotionalId}/items/{dayNumber}":{"put":{"tags":["Bible Plan Management"],"summary":"Add or replace bible plan item for a day","operationId":"upsertDevotionalItemV2","parameters":[{"name":"devotionalId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"dayNumber","in":"path","required":true,"schema":{"type":"integer","format":"int32","minimum":1}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpsertDevotionalItemRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseAdminDevotionalItemResponse"}}}}},"security":[{"bearerAuth":[]}]}},"/api/v1/admin/bible-plans/{devotionalId}":{"get":{"tags":["Bible Plan Management"],"summary":"Get bible plan with day items","operationId":"getDevotionalV2ById","parameters":[{"name":"devotionalId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseAdminDevotionalDetailResponse"}}}}},"security":[{"bearerAuth":[]}]},"put":{"tags":["Bible Plan Management"],"summary":"Update bible plan details (non-item fields)","description":"Updates an existing bible plan's details. Provide a new thumbnail file to replace the existing one, or omit it to keep the current thumbnail.","operationId":"updateDevotionalV2","parameters":[{"name":"devotionalId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/UpdateDevotionalV2Request"}}}},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseAdminDevotionalDetailResponse"}}}}},"security":[{"bearerAuth":[]}]},"delete":{"tags":["Bible Plan Management"],"summary":"Hard delete bible plan","operationId":"deleteDevotionalV2","parameters":[{"name":"devotionalId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseVoid"}}}}},"security":[{"bearerAuth":[]}]}},"/api/v1/admin/auth/profile":{"put":{"tags":["Admin Authentication"],"summary":"Update profile","description":"Allows an authenticated admin to update their own email and full name. Fails if another admin already uses the given email.","operationId":"updateProfile_1","parameters":[{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateAdminProfileRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseAdminProfileResponse"}}}}}}},"/api/v1/admin/admins/{id}":{"put":{"tags":["Admin Management"],"summary":"Update admin","description":"Updates another admin's details and role assignment","operationId":"updateAdmin","parameters":[{"name":"id","in":"path","description":"Admin id to update","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateAdminRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseAdminListItemResponse"}}}}},"security":[{"bearerAuth":[]}]},"delete":{"tags":["Admin Management"],"summary":"Deactivate admin","description":"Soft-deletes an admin, preventing them from logging in. The admin record and its history are retained, and the admin is removed from admin listings.","operationId":"softDeleteAdmin","parameters":[{"name":"id","in":"path","description":"Admin id to deactivate","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseVoid"}}}}},"security":[{"bearerAuth":[]}]}},"/api/v1/address":{"get":{"tags":["Address"],"summary":"Get authenticated user's address","operationId":"getAddress","parameters":[{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseAddressResponse"}}}}},"security":[{"bearerAuth":[]}]},"put":{"tags":["Address"],"summary":"Create or update authenticated user's address","operationId":"upsertAddress","parameters":[{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddressRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseAddressResponse"}}}}},"security":[{"bearerAuth":[]}]}},"/api/v0/admin/devotionals/{devotionalId}":{"get":{"tags":["Devotional Management"],"summary":"Get devotional by ID","operationId":"getDevotionalById","parameters":[{"name":"devotionalId","in":"path","description":"Devotional ID","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseAdminDailyDevotionalResponse"}}}}},"security":[{"bearerAuth":[]}]},"put":{"tags":["Devotional Management"],"summary":"Update a daily devotional","operationId":"updateDevotional","parameters":[{"name":"devotionalId","in":"path","description":"Devotional ID","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateDailyDevotionalRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseAdminDailyDevotionalResponse"}}}}},"security":[{"bearerAuth":[]}]},"delete":{"tags":["Devotional Management"],"summary":"Delete a devotional","operationId":"deleteDevotional","parameters":[{"name":"devotionalId","in":"path","description":"Devotional ID","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseVoid"}}}}},"security":[{"bearerAuth":[]}]}},"/api/v0/admin/challenges/{challengeId}":{"get":{"tags":["Challenge Management"],"summary":"Get challenge by ID","operationId":"getChallengeById","parameters":[{"name":"challengeId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseAdminChallengeResponse"}}}}},"security":[{"bearerAuth":[]}]},"put":{"tags":["Challenge Management"],"summary":"Update a challenge","operationId":"updateChallenge","parameters":[{"name":"challengeId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateChallengeRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseAdminChallengeResponse"}}}}},"security":[{"bearerAuth":[]}]},"delete":{"tags":["Challenge Management"],"summary":"Delete a challenge","description":"Deletes a challenge by its ID","operationId":"deleteChallenge","parameters":[{"name":"challengeId","in":"path","description":"Challenge ID","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseVoid"}}}}},"security":[{"bearerAuth":[]}]}},"/api/v1/user/path":{"post":{"tags":["User"],"summary":"Add a path to the authenticated user","operationId":"addPath","parameters":[{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddPathRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseString"}}}}}}},"/api/v1/user/image":{"post":{"tags":["User"],"summary":"Upload or update profile image","operationId":"uploadProfileImage","parameters":[{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"requestBody":{"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"image":{"type":"string","format":"binary","description":"Image file"}},"required":["image"]}}}},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseString"}}}}}}},"/api/v1/user-auth/signup":{"post":{"tags":["User Auth"],"summary":"Create app user","operationId":"createUser","parameters":[{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AppUserSignupRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseAppUserLoginResponse"}}}}}}},"/api/v1/user-auth/refresh-token":{"post":{"tags":["User Auth"],"summary":"Refresh access token","description":"Generate new access token using refresh token","operationId":"refreshToken","parameters":[{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RefreshTokenRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseAuthTokenResponse"}}}}}}},"/api/v1/user-auth/login":{"post":{"tags":["User Auth"],"summary":"App user login by email","operationId":"login","parameters":[{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AppUserLoginRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseAppUserLoginResponse"}}}}}}},"/api/v1/user-auth/google":{"post":{"tags":["User Auth"],"summary":"Login/Signup using Google access token (SPA flow)","operationId":"loginWithGoogle","parameters":[{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AppUserGoogleAuthRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseAppUserLoginResponse"}}}}}}},"/api/v1/testimonies":{"get":{"tags":["Testimonies"],"summary":"Get testimonies (paged)","operationId":"getTestimonies","parameters":[{"name":"page","in":"query","description":"Page number (0-based)","required":false,"schema":{"type":"integer","format":"int32","default":0,"minimum":0}},{"name":"size","in":"query","description":"Page size","required":false,"schema":{"type":"integer","format":"int32","default":10,"maximum":50}},{"name":"category","in":"query","description":"Category filter (optional)","required":false,"schema":{"type":"string","enum":["SALVATION","SPIRITUAL_GROWTH","OTHERS"]}},{"name":"countryId","in":"query","description":"Country ID filter (optional)","required":false,"schema":{"type":"integer","format":"int64"}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponsePagedResponseTestimonyResponse"}}}}}},"post":{"tags":["Testimonies"],"summary":"Submit a testimony (authenticated users only)","operationId":"submitTestimony","parameters":[{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateTestimonyByUserRequest"}}},"required":true},"responses":{"201":{"description":"Created","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseTestimonyResponse"}}}}}}},"/api/v1/scriptures":{"get":{"tags":["Scriptures"],"summary":"Get saved scriptures","description":"Lists the authenticated user's saved scriptures, most recently saved first.","operationId":"getSavedScriptures","parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":0,"minimum":0}},{"name":"size","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":10,"exclusiveMinimum":0,"maximum":50}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponsePagedResponseSavedScriptureResponse"}}}}}},"post":{"tags":["Scriptures"],"summary":"Save scriptures","description":"Saves one or more bible references (e.g. 'John 1:30' or 'John 1:30-31') with a bible version to the authenticated user's saved scriptures.","operationId":"saveScriptures","parameters":[{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SaveScripturesRequest"}}},"required":true},"responses":{"201":{"description":"Created","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseListSavedScriptureResponse"}}}}}}},"/api/v1/enquiries/send":{"post":{"tags":["Enquiries"],"summary":"Send an enquiry from the authenticated user","operationId":"send","parameters":[{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EnquiryRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseString"}}}}}}},"/api/v1/courses/{id}/modules/{moduleId}/start":{"post":{"tags":["Courses"],"summary":"Mark a module as started for the authenticated user","operationId":"startModule","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"moduleId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"201":{"description":"Created","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseVoid"}}}}}}},"/api/v1/courses/{id}/modules/{moduleId}/complete":{"post":{"tags":["Courses"],"summary":"Mark a module as completed for the authenticated user","operationId":"completeModule","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"moduleId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"201":{"description":"Created","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseVoid"}}}}}}},"/api/v1/courses/{id}/modules/{moduleId}/activities/{activityId}/complete":{"post":{"tags":["Courses"],"summary":"Mark a module activity as completed for the authenticated user","operationId":"completeActivity","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"moduleId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"activityId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"201":{"description":"Created","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseVoid"}}}}}}},"/api/v1/courses/{id}/enroll":{"post":{"tags":["Courses"],"operationId":"enroll","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"201":{"description":"Created","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseVoid"}}}}}},"delete":{"tags":["Courses"],"operationId":"unenroll","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"204":{"description":"No Content","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseVoid"}}}}}}},"/api/v1/challenges/subscribe":{"post":{"tags":["Challenges"],"summary":"Subscribe to a challenge","operationId":"subscribeToChallenge","parameters":[{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChallengeV2SubscribeRequest"}}},"required":true},"responses":{"201":{"description":"Created","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseVoid"}}}}}}},"/api/v1/challenges/completion":{"post":{"tags":["Challenges"],"summary":"Mark challenge v2 day as completed","operationId":"completeDay","parameters":[{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChallengeV2CompletionRequest"}}},"required":true},"responses":{"201":{"description":"Created","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseChallengeV2CompletionResponse"}}}}}}},"/api/v1/bibles/users/blacklist":{"post":{"tags":["Bible"],"summary":"Add a version to a user's blacklist","description":"Persist a bible version id to the user's blacklist","operationId":"addToBlacklist","parameters":[{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BlacklistRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponseVoid"}}}}}}},"/api/v1/bible-plans/impact":{"post":{"tags":["Bible Plans"],"summary":"Submit bible plan impact feedback","operationId":"submitImpact","parameters":[{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DevotionalV2ImpactRequest"}}},"required":true},"responses":{"201":{"description":"Created","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseDevotionalV2ImpactResponse"}}}}}}},"/api/v1/admin/testimonies":{"get":{"tags":["Testimony Management"],"summary":"Get all testimonies (admin, paged)","operationId":"getAllTestimoniesAdmin","parameters":[{"name":"page","in":"query","description":"Page number (0-based)","required":false,"schema":{"type":"integer","format":"int32","default":0,"minimum":0}},{"name":"size","in":"query","description":"Page size","required":false,"schema":{"type":"integer","format":"int32","default":10,"maximum":50}},{"name":"category","in":"query","description":"Category filter (optional)","required":false,"schema":{"type":"string"}},{"name":"countryId","in":"query","description":"Country ID filter (optional)","required":false,"schema":{"type":"integer","format":"int64"}},{"name":"approved","in":"query","description":"Approved filter (optional)","required":false,"schema":{"type":"boolean"}},{"name":"title","in":"query","description":"Title search (contains, case-insensitive)","required":false,"schema":{"type":"string"}},{"name":"startDate","in":"query","description":"Start date filter (inclusive) in yyyy-MM-dd","required":false,"schema":{"type":"string","format":"date"}},{"name":"endDate","in":"query","description":"End date filter (inclusive) in yyyy-MM-dd","required":false,"schema":{"type":"string","format":"date"}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponsePagedResponseAdminTestimonyResponse"}}}}},"security":[{"bearerAuth":[]}]},"post":{"tags":["Testimony Management"],"summary":"Create a testimony (admin)","operationId":"createTestimony","parameters":[{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateTestimonyRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseAdminTestimonyResponse"}}}}},"security":[{"bearerAuth":[]}]}},"/api/v1/admin/testimonies/{testimonyId}/approve":{"post":{"tags":["Testimony Management"],"summary":"Approve a testimony (admin)","operationId":"approveTestimony","parameters":[{"name":"testimonyId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseAdminTestimonyResponse"}}}}},"security":[{"bearerAuth":[]}]}},"/api/v1/admin/scriptures":{"get":{"tags":["Daily Scripture Management"],"summary":"Get all scriptures with optional filters","operationId":"getAllScriptures","parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":0,"minimum":0}},{"name":"size","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":10,"maximum":50}},{"name":"book","in":"query","description":"Book name filter (contains, case-insensitive)","required":false,"schema":{"type":"string"}},{"name":"chapter","in":"query","description":"Chapter number filter","required":false,"schema":{"type":"integer","format":"int32"}},{"name":"startDateTime","in":"query","description":"Start datetime filter (ISO-8601 format)","required":false,"schema":{"type":"string","format":"date-time"}},{"name":"endDateTime","in":"query","description":"End datetime filter (ISO-8601 format)","required":false,"schema":{"type":"string","format":"date-time"}},{"name":"status","in":"query","description":"Filter by scripture status","required":false,"schema":{"type":"string","enum":["DRAFT","LIVE","OUTDATED"]}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponsePagedResponseAdminDailyScriptureResponse"}}}}},"security":[{"bearerAuth":[]}]},"post":{"tags":["Daily Scripture Management"],"summary":"Create a new daily scripture","operationId":"createScripture","parameters":[{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateDailyScriptureRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseAdminDailyScriptureResponse"}}}}},"security":[{"bearerAuth":[]}]}},"/api/v1/admin/scriptures/{scriptureId}/unpublish":{"post":{"tags":["Daily Scripture Management"],"summary":"Unpublish a scripture (set status back to DRAFT)","operationId":"unpublishScripture","parameters":[{"name":"scriptureId","in":"path","description":"Scripture ID","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseAdminDailyScriptureResponse"}}}}},"security":[{"bearerAuth":[]}]}},"/api/v1/admin/scriptures/{scriptureId}/publish":{"post":{"tags":["Daily Scripture Management"],"summary":"Publish a scripture (set status to LIVE)","operationId":"publishScripture","parameters":[{"name":"scriptureId","in":"path","description":"Scripture ID","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseAdminDailyScriptureResponse"}}}}},"security":[{"bearerAuth":[]}]}},"/api/v1/admin/roles":{"get":{"tags":["Role Management"],"summary":"List all roles, their privileges, and how many admins hold each","operationId":"listRoles","parameters":[{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseListRoleResponse"}}}}},"security":[{"bearerAuth":[]}]},"post":{"tags":["Role Management"],"summary":"Create a new role","operationId":"createRole","parameters":[{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateRoleRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseRoleResponse"}}}}},"security":[{"bearerAuth":[]}]}},"/api/v1/admin/roles/assign":{"post":{"tags":["Role Management"],"summary":"Set (or clear, with a null roleId) the role held by an admin","operationId":"assignRole","parameters":[{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssignRoleRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseVoid"}}}}},"security":[{"bearerAuth":[]}]}},"/api/v1/admin/media":{"get":{"tags":["Media Management"],"summary":"Get all media items (admin, paged)","operationId":"getAllMedia","parameters":[{"name":"page","in":"query","description":"Page number (0-based)","required":false,"schema":{"type":"integer","format":"int32","default":0,"minimum":0}},{"name":"size","in":"query","description":"Page size","required":false,"schema":{"type":"integer","format":"int32","default":10,"maximum":50}},{"name":"type","in":"query","description":"Type filter (optional)","required":false,"schema":{"type":"string","enum":["VIDEO","SERMON","PODCAST","PLAYLIST","FEATURED_VIDEO"]}},{"name":"search","in":"query","description":"Search in name or link (optional)","required":false,"schema":{"type":"string"}},{"name":"startDate","in":"query","description":"Start date filter (inclusive) in yyyy-MM-dd","required":false,"schema":{"type":"string","format":"date"}},{"name":"endDate","in":"query","description":"End date filter (inclusive) in yyyy-MM-dd","required":false,"schema":{"type":"string","format":"date"}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponsePagedResponseAdminMediaResponse"}}}}},"security":[{"bearerAuth":[]}]},"post":{"tags":["Media Management"],"summary":"Create a media item (admin)","operationId":"createMedia","parameters":[{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateMediaRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseAdminMediaResponse"}}}}},"security":[{"bearerAuth":[]}]}},"/api/v1/admin/events":{"get":{"tags":["Event Management"],"summary":"Get all events","description":"Retrieves all events with pagination support. Event date/times will be converted to client timezone.","operationId":"getAllEvents","parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":0}},{"name":"size","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":10}},{"name":"month","in":"query","description":"Month number (1-12)","required":false,"schema":{"type":"integer","format":"int32"}},{"name":"year","in":"query","description":"Year (e.g. 2026)","required":false,"schema":{"type":"integer","format":"int32"}},{"name":"title","in":"query","description":"Title substring filter (case-insensitive)","required":false,"schema":{"type":"string"}},{"name":"eventDate","in":"query","description":"Event date to filter (local date) in yyyy-MM-dd","required":false,"schema":{"type":"string","format":"date"}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponsePagedResponseEventResponse"}}}}},"security":[{"bearerAuth":[]}]},"post":{"tags":["Event Management"],"summary":"Create a new event","description":"Creates a new event with the provided details and banner image. Event date/time will be converted from client timezone to system timezone.","operationId":"createEvent","parameters":[{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/CreateEventRequest"}}}},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseEventResponse"}}}}},"security":[{"bearerAuth":[]}]}},"/api/v1/admin/courses/{courseId}/launch":{"post":{"tags":["Course Management"],"summary":"Step 4: Launch course to LIVE","operationId":"launchCourse","parameters":[{"name":"courseId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseAdminCourseResponse"}}}}},"security":[{"bearerAuth":[]}]}},"/api/v1/admin/courses/modules":{"post":{"tags":["Course Management"],"summary":"Step 2: Create module in course","operationId":"createModule","parameters":[{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateModuleRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseAdminModuleResponse"}}}}},"security":[{"bearerAuth":[]}]}},"/api/v1/admin/courses/modules/{moduleId}/activities":{"post":{"tags":["Course Management"],"summary":"Create activity","operationId":"createModuleActivity","parameters":[{"name":"moduleId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActivityData"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseAdminActivityResponse"}}}}},"security":[{"bearerAuth":[]}]}},"/api/v1/admin/courses/modules/bulk":{"post":{"tags":["Course Management"],"summary":"Step 2 (Bulk): Create multiple modules in course","operationId":"createModules","parameters":[{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateModulesRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseListAdminModuleResponse"}}}}},"security":[{"bearerAuth":[]}]}},"/api/v1/admin/courses":{"get":{"tags":["Course Management"],"summary":"Get all courses (paginated)","operationId":"getAllCourses","parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":0}},{"name":"size","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":10}},{"name":"status","in":"query","required":false,"schema":{"type":"string","pattern":"DRAFT|LIVE"}},{"name":"text","in":"query","required":false,"schema":{"type":"string"}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponsePagedResponseAdminCourseResponse"}}}}},"security":[{"bearerAuth":[]}]},"post":{"tags":["Course Management"],"summary":"Step 1: Create course curriculum","description":"Creates a new course curriculum with the provided details and optional cover image or GIF.","operationId":"createCourse","parameters":[{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/CreateCourseRequest"}}}},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseAdminCourseResponse"}}}}},"security":[{"bearerAuth":[]}]}},"/api/v1/admin/challenges":{"get":{"tags":["Challenge Management"],"summary":"Get all challenge series (basic view) with optional filters","operationId":"getAllChallengesV2","parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":0,"minimum":0}},{"name":"size","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":10,"maximum":50}},{"name":"title","in":"query","description":"Title search (contains, case-insensitive)","required":false,"schema":{"type":"string"}},{"name":"status","in":"query","description":"Filter by challenge status","required":false,"schema":{"type":"string","enum":["DRAFT","LIVE"]}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponsePagedResponseAdminChallengeSeriesResponse"}}}}},"security":[{"bearerAuth":[]}]},"post":{"tags":["Challenge Management"],"summary":"Create challenge series","operationId":"createChallengeV2","parameters":[{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateChallengeV2Request"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseAdminChallengeSeriesResponse"}}}}},"security":[{"bearerAuth":[]}]}},"/api/v1/admin/challenges/{challengeId}/publish":{"post":{"tags":["Challenge Management"],"summary":"Publish challenge series to LIVE","operationId":"publishChallengeV2","parameters":[{"name":"challengeId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseAdminChallengeSeriesDetailResponse"}}}}},"security":[{"bearerAuth":[]}]}},"/api/v1/admin/bible-plans/{devotionalId}/publish":{"post":{"tags":["Bible Plan Management"],"summary":"Publish bible plan to LIVE","operationId":"publishDevotionalV2","parameters":[{"name":"devotionalId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseAdminDevotionalDetailResponse"}}}}},"security":[{"bearerAuth":[]}]}},"/api/v1/admin/bible-plans":{"get":{"tags":["Bible Plan Management"],"summary":"Get all bible plans (basic view) with optional filters","operationId":"getAllDevotionalsV2","parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":0,"minimum":0}},{"name":"size","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":10,"maximum":50}},{"name":"title","in":"query","description":"Title search (contains, case-insensitive)","required":false,"schema":{"type":"string"}},{"name":"status","in":"query","description":"Filter by devotional status","required":false,"schema":{"type":"string","enum":["DRAFT","LIVE"]}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponsePagedResponseAdminDevotionalResponse"}}}}},"security":[{"bearerAuth":[]}]},"post":{"tags":["Bible Plan Management"],"summary":"Create bible plan","description":"Creates a new bible plan with the provided details and optional thumbnail image.","operationId":"createDevotionalV2","parameters":[{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/CreateDevotionalV2Request"}}}},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseAdminDevotionalResponse"}}}}},"security":[{"bearerAuth":[]}]}},"/api/v1/admin/auth/verify-2fa":{"post":{"tags":["Admin Authentication"],"summary":"Admin login — step 2","description":"Verifies the 2FA code and returns authentication tokens.","operationId":"verifyTwoFactor","parameters":[{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifyTwoFactorRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseAdminLoginResponse"}}}}}}},"/api/v1/admin/auth/update-password":{"post":{"tags":["Admin Authentication"],"summary":"Update password","description":"Allows an authenticated admin to change their own password by providing their current and new password","operationId":"updatePassword","parameters":[{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminUpdatePasswordRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseString"}}}}}}},"/api/v1/admin/auth/signup":{"post":{"tags":["Admin Authentication"],"summary":"Create new admin","description":"Creates a new admin user with a temporary password that must be changed on first login","operationId":"createAdmin","parameters":[{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminSignupRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseAdminSignupResponse"}}}}}}},"/api/v1/admin/auth/refresh-token":{"post":{"tags":["Admin Authentication"],"summary":"Refresh access token","description":"Generate new access token using refresh token","operationId":"refreshToken_1","parameters":[{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RefreshTokenRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseAuthTokenResponse"}}}}}}},"/api/v1/admin/auth/login":{"post":{"tags":["Admin Authentication"],"summary":"Admin login — step 1","description":"Validates credentials and sends a 2FA code. Use the returned sessionId with /verify-2fa to complete login.","operationId":"login_1","parameters":[{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminLoginRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseAdminLoginInitiateResponse"}}}}}}},"/api/v1/admin/auth/image":{"post":{"tags":["Admin Authentication"],"summary":"Update profile image","description":"Allows an authenticated admin to upload/replace their own profile image","operationId":"updateProfileImage","parameters":[{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"requestBody":{"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"image":{"type":"string","format":"binary","description":"Profile image file"}},"required":["image"]}}}},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseAdminProfileResponse"}}}}}}},"/api/v1/admin/auth/change-password":{"post":{"tags":["Admin Authentication"],"summary":"Change password","description":"Changes the admin password using a valid session ID from first login","operationId":"changePassword","parameters":[{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChangePasswordRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseString"}}}}}}},"/api/v0/devotionals/impact":{"post":{"tags":["Devotionals"],"summary":"Submit devotional impact feedback","description":"Submits how the devotional impacted the user. Multiple impacts can be selected. Replaces any previous feedback for the same devotional.","operationId":"submitImpact_1","parameters":[{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DevotionalImpactRequest"}}},"required":true},"responses":{"201":{"description":"Created","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseDevotionalImpactResponse"}}}}}}},"/api/v0/challenges/{id}/subscribe":{"post":{"tags":["Challenges"],"summary":"Subscribe to a challenge","operationId":"subscribe","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"201":{"description":"Created","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseVoid"}}}}}}},"/api/v0/challenges/{id}/stamped":{"get":{"tags":["Challenges"],"summary":"Check if user has stamped challenge today","operationId":"stamped","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseChallengeStampResponse"}}}}}},"post":{"tags":["Challenges"],"summary":"Stamp a challenge for today","operationId":"stamp","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"201":{"description":"Created","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseChallengeStampResponse"}}}}}}},"/api/v0/admin/devotionals":{"get":{"tags":["Devotional Management"],"summary":"Get all devotionals with optional date-range filters","operationId":"getAllDevotionals","parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":0,"minimum":0}},{"name":"size","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":10,"maximum":50}},{"name":"startDate","in":"query","description":"Start date filter (inclusive) in yyyy-MM-dd","required":false,"schema":{"type":"string","format":"date"}},{"name":"endDate","in":"query","description":"End date filter (inclusive) in yyyy-MM-dd","required":false,"schema":{"type":"string","format":"date"}},{"name":"title","in":"query","description":"Title search (contains, case-insensitive)","required":false,"schema":{"type":"string"}},{"name":"status","in":"query","description":"Filter by devotional status","required":false,"schema":{"type":"string","enum":["DRAFT","LIVE"]}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponsePagedResponseAdminDailyDevotionalResponse"}}}}},"security":[{"bearerAuth":[]}]},"post":{"tags":["Devotional Management"],"summary":"Create a new daily devotional","operationId":"createDevotional","parameters":[{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateDailyDevotionalRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseAdminDailyDevotionalResponse"}}}}},"security":[{"bearerAuth":[]}]}},"/api/v0/admin/challenges":{"get":{"tags":["Challenge Management"],"summary":"Get all challenges","operationId":"getAllChallenges","parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":0,"minimum":0}},{"name":"size","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":10,"maximum":50}},{"name":"challengeName","in":"query","required":false,"schema":{"type":"string"}},{"name":"startDate","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"endDate","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponsePagedResponseAdminChallengeResponse"}}}}},"security":[{"bearerAuth":[]}]},"post":{"tags":["Challenge Management"],"summary":"Create a new challenge","operationId":"createChallenge","parameters":[{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateChallengeRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseAdminChallengeResponse"}}}}},"security":[{"bearerAuth":[]}]}},"/api/v1/courses/unenrolled":{"get":{"tags":["Courses"],"summary":"Get unenrolled courses (paginated)","description":"Retrieve a paginated list of courses the authenticated user is NOT enrolled in.","operationId":"getUnenrolledCourses","parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":0}},{"name":"size","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":10}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponsePagedResponseCourseResponse"}}}}}}},"/api/v1/courses":{"get":{"tags":["Courses"],"summary":"Get unenrolled courses (paginated)","description":"Retrieve a paginated list of courses the authenticated user is NOT enrolled in.","operationId":"getUnenrolledCourses_1","parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":0}},{"name":"size","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":10}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponsePagedResponseCourseResponse"}}}}}}},"/api/v1/user-auth/check-username":{"get":{"tags":["User Auth"],"summary":"Check username availability","operationId":"checkUsernameAvailability","parameters":[{"name":"username","in":"query","description":"Username to check","required":true,"schema":{"type":"string"}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseString"}}}}}}},"/api/v1/user-auth/check-email":{"get":{"tags":["User Auth"],"summary":"Check email availability","operationId":"checkEmailAvailability","parameters":[{"name":"email","in":"query","description":"Email to check","required":true,"schema":{"type":"string"}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseString"}}}}}}},"/api/v1/scriptures/recent":{"get":{"tags":["Daily Scripture"],"summary":"Get the most recent daily scripture","operationId":"getRecentScripture","parameters":[{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseDailyScriptureResponse"}}}}}}},"/api/v1/milestones":{"get":{"tags":["Milestones"],"summary":"Get milestones","description":"Lists every milestone and the authenticated user's unlock status for each.","operationId":"getMilestones","parameters":[{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseListMilestoneResponse"}}}}}}},"/api/v1/me":{"get":{"tags":["Profile"],"summary":"Get current user profile","description":"Get current authenticated user's profile information","operationId":"getProfile","parameters":[{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseProfileData"}}}}},"security":[{"bearerAuth":[]}]}},"/api/v1/metadata/testimony-categories":{"get":{"tags":["Metadata"],"summary":"List testimony categories (code + value)","operationId":"testimonyCategories","parameters":[{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseListTestimonyCategoryResponse"}}}}}}},"/api/v1/metadata/paths":{"get":{"tags":["Metadata"],"summary":"List available HC paths (public)","operationId":"paths","parameters":[{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseListHCPathResponse"}}}}}}},"/api/v1/metadata/media-types":{"get":{"tags":["Metadata"],"summary":"List media types (code + value)","operationId":"mediaTypes","parameters":[{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseListMediaTypeResponse"}}}}}}},"/api/v1/metadata/countries":{"get":{"tags":["Metadata"],"summary":"List countries","operationId":"countries","parameters":[{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseListCountryResponse"}}}}}}},"/api/v1/metadata/countries/{countryId}/provinces":{"get":{"tags":["Metadata"],"summary":"List provinces for a given country","operationId":"provincesByCountryId","parameters":[{"name":"countryId","in":"path","required":true,"schema":{"type":"integer","format":"int64","exclusiveMinimum":0}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseListProvinceResponse"}}}}}}},"/api/v1/media":{"get":{"tags":["Media"],"summary":"List media items (paged)","operationId":"getMedia","parameters":[{"name":"page","in":"query","description":"Page number (0-based)","required":false,"schema":{"type":"integer","format":"int32","default":0,"minimum":0}},{"name":"limit","in":"query","description":"Page size","required":false,"schema":{"type":"integer","format":"int32","default":10,"maximum":50}},{"name":"type","in":"query","description":"Type filter (optional)","required":false,"schema":{"type":"string","enum":["VIDEO","SERMON","PODCAST","PLAYLIST","FEATURED_VIDEO"]}},{"name":"search","in":"query","description":"Search in name or link (optional)","required":false,"schema":{"type":"string"}},{"name":"startDate","in":"query","description":"Start date filter (inclusive) in yyyy-MM-dd","required":false,"schema":{"type":"string","format":"date"}},{"name":"endDate","in":"query","description":"End date filter (inclusive) in yyyy-MM-dd","required":false,"schema":{"type":"string","format":"date"}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponsePagedResponseAdminMediaResponse"}}}}}}},"/api/v1/media/{mediaId}":{"get":{"tags":["Media"],"summary":"Get media by ID","operationId":"getMediaById","parameters":[{"name":"mediaId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseAdminMediaResponse"}}}}}}},"/api/v1/media/latest/{mediaType}":{"get":{"tags":["Media"],"summary":"Get latest media by media type","operationId":"getLatestMediaType","parameters":[{"name":"mediaType","in":"path","required":true,"schema":{"type":"string","enum":["VIDEO","SERMON","PODCAST","PLAYLIST","FEATURED_VIDEO"]}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseAdminMediaResponse"}}}}}}},"/api/v1/events":{"get":{"tags":["Events"],"summary":"Get events (paged)","description":"Returns a page of events; optionally filter by month (1-12) and year (e.g. 2026), title (substring), or a single eventDate in yyyy-MM-dd format.","operationId":"getEvents","parameters":[{"name":"page","in":"query","description":"Page number (0-based)","required":false,"schema":{"type":"integer","format":"int32","default":0,"minimum":0}},{"name":"size","in":"query","description":"Page size","required":false,"schema":{"type":"integer","format":"int32","default":10,"maximum":50}},{"name":"month","in":"query","description":"Month number (1-12)","required":false,"schema":{"type":"integer","format":"int32","maximum":12,"minimum":1}},{"name":"year","in":"query","description":"Year (e.g. 2026)","required":false,"schema":{"type":"integer","format":"int32"}},{"name":"title","in":"query","description":"Title substring filter (case-insensitive)","required":false,"schema":{"type":"string"}},{"name":"eventDate","in":"query","description":"Event date to filter (local date) in yyyy-MM-dd","required":false,"schema":{"type":"string","format":"date"}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponsePagedResponseEventResponse"}}}}}}},"/api/v1/events/monthly-counts":{"get":{"tags":["Events"],"summary":"Get event counts per month","description":"Returns the number of events for each month over a 12-month window starting from startMonthYear (format: yyyy-MM). Months with zero events are omitted. Defaults to the current month when startMonthYear is not provided.","operationId":"getMonthlyEventCounts","parameters":[{"name":"startMonthYear","in":"query","description":"Start month in yyyy-MM format (e.g. 2026-03). Defaults to current month.","required":false,"schema":{"type":"string"}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseListEventMonthlyCountResponse"}}}}}}},"/api/v1/devotional":{"get":{"tags":["Devotional"],"summary":"Get devotional for a day and month","description":"Fetches the devotional entry matching the given day and month from Wonders.","operationId":"getDevotional","parameters":[{"name":"day","in":"query","description":"Day of month (1-31)","required":true,"schema":{"type":"integer","format":"int32","maximum":31,"minimum":1}},{"name":"month","in":"query","description":"Month (1-12)","required":true,"schema":{"type":"integer","format":"int32","maximum":12,"minimum":1}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseWondersDevotionalResponse"}}}}}}},"/api/v1/courses/{id}":{"get":{"tags":["Courses"],"summary":"Get course by id","description":"Retrieve a single course by id including enrollment and progress info for the authenticated user","operationId":"getCourseById_1","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseCourseResponse"}}}}}}},"/api/v1/courses/{courseId}/modules":{"get":{"tags":["Courses"],"summary":"Get modules for a course","description":"Retrieve all modules for a given course with per-activity completion status","operationId":"getModulesByCourseId","parameters":[{"name":"courseId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseListModuleResponse"}}}}}}},"/api/v1/courses/{courseId}/modules/{moduleId}":{"get":{"tags":["Courses"],"summary":"Get module by id","description":"Retrieve a single module by id for the given course","operationId":"getModuleById","parameters":[{"name":"courseId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"moduleId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseModuleResponse"}}}}}}},"/api/v1/courses/enrolled":{"get":{"tags":["Courses"],"summary":"Get courses the user is enrolled in with progress (paginated)","operationId":"getEnrolled","parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":0}},{"name":"size","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":10}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponsePagedResponseCourseResponse"}}}}}}},"/api/v1/challenges":{"get":{"tags":["Challenges"],"summary":"List challenges with participation (ALL|SUBSCRIBED|NOT_SUBSCRIBED)","operationId":"getChallenges","parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":0,"minimum":0}},{"name":"size","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":10,"exclusiveMinimum":0,"maximum":50}},{"name":"filter","in":"query","description":"ALL|SUBSCRIBED|NOT_SUBSCRIBED","required":false,"schema":{"type":"string","default":"ALL","pattern":"ALL|SUBSCRIBED|NOT_SUBSCRIBED"}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponsePagedResponseChallengeV2ListItemResponse"}}}}}}},"/api/v1/challenges/{challengeId}/days/{dayNumber}":{"get":{"tags":["Challenges"],"summary":"Get challenge details for a given day","operationId":"getChallengeDayDetails","parameters":[{"name":"challengeId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"dayNumber","in":"path","required":true,"schema":{"type":"integer","format":"int32","exclusiveMinimum":0}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseChallengeItemResponse"}}}}}}},"/api/v1/challenges/{challengeId}/days/{dayNumber}/completion":{"get":{"tags":["Challenges"],"summary":"Get user's completion for challenge day","operationId":"getCompletion","parameters":[{"name":"challengeId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"dayNumber","in":"path","required":true,"schema":{"type":"integer","format":"int32"}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseChallengeV2CompletionResponse"}}}}}}},"/api/v1/bibles/versions/{version}/books/{book}/chapters/{chapter}/verses":{"get":{"tags":["Bible"],"summary":"Get verses for a chapter","description":"Returns the verses object for a given chapter file","operationId":"getVerses","parameters":[{"name":"version","in":"path","required":true,"schema":{"type":"string"}},{"name":"book","in":"path","required":true,"schema":{"type":"string"}},{"name":"chapter","in":"path","required":true,"schema":{"type":"string"}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponseChapterFile"}}}}}}},"/api/v1/bibles/versions/{version}/books/{book}/chapters":{"get":{"tags":["Bible"],"summary":"List chapters for a book","description":"Returns chapter numbers available for a book","operationId":"getChapters","parameters":[{"name":"version","in":"path","required":true,"schema":{"type":"string"}},{"name":"book","in":"path","required":true,"schema":{"type":"string"}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponseChaptersResponse"}}}}}}},"/api/v1/bibles/versions/{version}/books":{"get":{"tags":["Bible"],"summary":"List books for a version","description":"Returns books (id and beautified name) for a Bible version. Use query param 'deutro=true' to include deuterocanonical books.","operationId":"getBooks","parameters":[{"name":"version","in":"path","required":true,"schema":{"type":"string"}},{"name":"deutro","in":"query","description":"Include deuterocanonical books","required":false,"schema":{"type":"boolean","default":false}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponseListBookInfo"}}}}}}},"/api/v1/bibles/versions":{"get":{"tags":["Bible"],"summary":"List Bible versions","description":"Returns available Bible versions, filtered by the authenticated user's blacklist if present. Optionally filter by the 'language' query param (language code, e.g. 'eng') - see GET /languages for available codes.","operationId":"getVersions","parameters":[{"name":"language","in":"query","description":"Filter versions by language code, e.g. 'eng'","required":false,"schema":{"type":"string"}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponseListBibleVersion"}}}}}}},"/api/v1/bibles/top-openings":{"get":{"tags":["Bible"],"summary":"Top openings","description":"Return the top opened references in memory. Query params: version (optional), limit (default 10)","operationId":"topOpenings","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":10}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponseListTopOpening"}}}}}}},"/api/v1/bibles/search":{"get":{"tags":["Bible"],"summary":"Search verse text","description":"Search within verse text for a given version. Query params: version, text, deutro","operationId":"search","parameters":[{"name":"version","in":"query","required":true,"schema":{"type":"string"}},{"name":"text","in":"query","required":true,"schema":{"type":"string"}},{"name":"deutro","in":"query","required":false,"schema":{"type":"boolean","default":false}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponseListSearchResult"}}}}}}},"/api/v1/bibles/open":{"get":{"tags":["Bible"],"summary":"Open a reference","description":"Open a Bible reference like 'Genesis 1:1-20' or 'Genesis 1:1'. Query params: version, ref, deutro","operationId":"open","parameters":[{"name":"version","in":"query","required":true,"schema":{"type":"string"}},{"name":"ref","in":"query","required":true,"schema":{"type":"string"}},{"name":"deutro","in":"query","required":false,"schema":{"type":"boolean","default":false}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponseChapterFile"}}}}}}},"/api/v1/bibles/languages":{"get":{"tags":["Bible"],"summary":"List available languages","description":"Returns the distinct languages available across Bible versions, with the number of versions available in each","operationId":"getLanguages","parameters":[{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponseListBibleLanguage"}}}}}}},"/api/v1/bible-plans":{"get":{"tags":["Bible Plans"],"summary":"List all bible plans with participation","operationId":"getDevotionals","parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":0,"minimum":0}},{"name":"size","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":10,"exclusiveMinimum":0,"maximum":50}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponsePagedResponseDevotionalV2ListItemResponse"}}}}}}},"/api/v1/bible-plans/{devotionalId}":{"get":{"tags":["Bible Plans"],"summary":"Get details of a bible plan (user view)","operationId":"getDevotionalById_1","parameters":[{"name":"devotionalId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseDevotionalV2DetailResponse"}}}}}}},"/api/v1/bible-plans/{devotionalId}/days/{dayNumber}/impact":{"get":{"tags":["Bible Plans"],"summary":"Get user's impact feedback for bible plan day","operationId":"getImpact","parameters":[{"name":"devotionalId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"dayNumber","in":"path","required":true,"schema":{"type":"integer","format":"int32"}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseDevotionalV2ImpactResponse"}}}}}}},"/api/v1/admin/roles/privileges":{"get":{"tags":["Role Management"],"summary":"List the fixed set of privileges roles can be built from","operationId":"listPrivileges","parameters":[{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseListPrivilegeResponse"}}}}},"security":[{"bearerAuth":[]}]}},"/api/v1/admin/roles/admins/{adminId}":{"get":{"tags":["Role Management"],"summary":"Get the role and effective privileges held by an admin","operationId":"getAdminRole","parameters":[{"name":"adminId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseAdminRoleResponse"}}}}},"security":[{"bearerAuth":[]}]}},"/api/v1/admin/media/{mediaId}":{"get":{"tags":["Media Management"],"summary":"Get media by ID (admin)","operationId":"getMediaById_1","parameters":[{"name":"mediaId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseAdminMediaResponse"}}}}},"security":[{"bearerAuth":[]}]},"delete":{"tags":["Media Management"],"summary":"Delete a media item (admin)","operationId":"deleteMedia","parameters":[{"name":"mediaId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseVoid"}}}}},"security":[{"bearerAuth":[]}]}},"/api/v1/admin/dashboard/members/{userId}":{"get":{"tags":["Dashboard"],"summary":"Get detailed information for a specific user by ID","operationId":"getUserDetailsById","parameters":[{"name":"userId","in":"path","required":true,"schema":{"type":"integer","format":"int64","exclusiveMinimum":0}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseDashboardUser"}}}}},"security":[{"bearerAuth":[]}]}},"/api/v1/admin/dashboard/members/{userId}/courses":{"get":{"tags":["Dashboard"],"summary":"Get course activity details for a specific user by ID","operationId":"getUserCourseActivityById","parameters":[{"name":"userId","in":"path","required":true,"schema":{"type":"integer","format":"int64","exclusiveMinimum":0}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseUserCourseActivity"}}}}},"security":[{"bearerAuth":[]}]}},"/api/v1/admin/dashboard/members/{userId}/challenges":{"get":{"tags":["Dashboard"],"summary":"Get challenge V2 activity details for a specific user by ID","operationId":"getUserChallengeActivityById","parameters":[{"name":"userId","in":"path","required":true,"schema":{"type":"integer","format":"int64","exclusiveMinimum":0}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseUserChallengeActivity"}}}}},"security":[{"bearerAuth":[]}]}},"/api/v1/admin/dashboard/members/summary":{"get":{"tags":["Dashboard"],"summary":"Total, active and inactive members within a date range","operationId":"getMembersSummary","parameters":[{"name":"start","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"end","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseMembersSummary"}}}}},"security":[{"bearerAuth":[]}]}},"/api/v1/admin/dashboard/members/recent":{"get":{"tags":["Dashboard"],"summary":"List of N most recent members within a date range","operationId":"getRecentMembers","parameters":[{"name":"start","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"end","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"top","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":10,"exclusiveMinimum":0,"maximum":10}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseListRecentMember"}}}}},"security":[{"bearerAuth":[]}]}},"/api/v1/admin/dashboard/members/list":{"get":{"tags":["Dashboard"],"summary":"List members with optional filters: countryId and emailAddress","operationId":"getUsersList","parameters":[{"name":"start","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"end","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"countryId","in":"query","required":false,"schema":{"type":"integer","format":"int64"}},{"name":"emailAddress","in":"query","required":false,"schema":{"type":"string"}},{"name":"gender","in":"query","required":false,"schema":{"type":"string","pattern":"MALE|FEMALE|UNKNOWN"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":0,"minimum":0}},{"name":"size","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":50,"exclusiveMinimum":0,"maximum":200}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponsePagedResponseDashboardUser"}}}}},"security":[{"bearerAuth":[]}]}},"/api/v1/admin/dashboard/members/export":{"get":{"tags":["Dashboard"],"summary":"Download members matching the given filters as a CSV file","operationId":"exportMembers","parameters":[{"name":"start","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"end","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"countryId","in":"query","required":false,"schema":{"type":"integer","format":"int64"}},{"name":"emailAddress","in":"query","required":false,"schema":{"type":"string"}},{"name":"gender","in":"query","required":false,"schema":{"type":"string","pattern":"MALE|FEMALE|UNKNOWN"}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"text/csv":{"schema":{"type":"string","format":"byte"}}}}},"security":[{"bearerAuth":[]}]}},"/api/v1/admin/dashboard/members/by-gender":{"get":{"tags":["Dashboard"],"summary":"Count of members grouped by gender (MALE, FEMALE, UNKNOWN) within a date range","operationId":"getMembersByGender","parameters":[{"name":"start","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"end","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseListGenderCount"}}}}},"security":[{"bearerAuth":[]}]}},"/api/v1/admin/dashboard/members/by-country":{"get":{"tags":["Dashboard"],"summary":"Top N countries by member count within a date range (0 < N <= 10)","operationId":"getMembersByCountry","parameters":[{"name":"start","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"end","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"top","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":10,"exclusiveMinimum":0,"maximum":10}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseListCountryCount"}}}}},"security":[{"bearerAuth":[]}]}},"/api/v1/admin/dashboard/members/by-country/list":{"get":{"tags":["Dashboard"],"summary":"Paginated countries by member count within a date range","operationId":"getMembersByCountryPaged","parameters":[{"name":"start","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"end","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":0,"minimum":0}},{"name":"size","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":50,"exclusiveMinimum":0,"maximum":200}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponsePagedResponseCountryCount"}}}}},"security":[{"bearerAuth":[]}]}},"/api/v1/admin/dashboard/courses/enrollments/list":{"get":{"tags":["Dashboard"],"summary":"Paginated member-course enrollments with optional filters: search, category(path), and status","operationId":"getCourseEnrollmentsList","parameters":[{"name":"start","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"end","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"search","in":"query","required":false,"schema":{"type":"string"}},{"name":"category","in":"query","required":false,"schema":{"type":"string"}},{"name":"status","in":"query","required":false,"schema":{"type":"string"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":0,"minimum":0}},{"name":"size","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":10,"exclusiveMinimum":0,"maximum":50}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponsePagedResponseDashboardCourseEnrollment"}}}}},"security":[{"bearerAuth":[]}]}},"/api/v1/admin/dashboard/courses/by-path":{"get":{"tags":["Dashboard"],"summary":"Count of users taking at least one course, grouped by HC path within a date range","operationId":"getUsersByPathForEnrollments","parameters":[{"name":"start","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"end","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseListPathEnrollmentCount"}}}}},"security":[{"bearerAuth":[]}]}},"/api/v1/admin/dashboard/challenges/participation":{"get":{"tags":["Dashboard"],"summary":"Distinct users who joined a challenge and their percentage of total active members, within a date range","operationId":"getChallengeParticipationStats","parameters":[{"name":"start","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"end","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseChallengeParticipationStats"}}}}},"security":[{"bearerAuth":[]}]}},"/api/v1/admin/dashboard/challenges/enrollments/list":{"get":{"tags":["Dashboard"],"summary":"Paginated member-challenge enrollments with optional filters: search, challengeStatus, and status","operationId":"getChallengeEnrollmentsList","parameters":[{"name":"start","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"end","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"search","in":"query","required":false,"schema":{"type":"string"}},{"name":"challengeStatus","in":"query","required":false,"schema":{"type":"string"}},{"name":"status","in":"query","required":false,"schema":{"type":"string"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":0,"minimum":0}},{"name":"size","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":10,"exclusiveMinimum":0,"maximum":50}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponsePagedResponseDashboardChallengeEnrollment"}}}}},"security":[{"bearerAuth":[]}]}},"/api/v1/admin/dashboard/challenges/completion":{"get":{"tags":["Dashboard"],"summary":"Total users subscribed to a challenge vs those who completed it (stamped every day), with completion percentage, within a date range","operationId":"getChallengeCompletionStats","parameters":[{"name":"start","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"end","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseChallengeCompletionStats"}}}}},"security":[{"bearerAuth":[]}]}},"/api/v1/admin/courses/{courseId}/modules":{"get":{"tags":["Course Management"],"summary":"Get course modules","operationId":"getCourseModules","parameters":[{"name":"courseId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseListAdminModuleResponse"}}}}},"security":[{"bearerAuth":[]}]}},"/api/v1/admin/admins":{"get":{"tags":["Admin Management"],"summary":"List admins","description":"Paginated list of admins (name, email, roles, date joined), filterable by name, email and roleId","operationId":"listAdmins","parameters":[{"name":"name","in":"query","description":"Filter by first/last name (partial match)","required":false,"schema":{"type":"string"}},{"name":"email","in":"query","description":"Filter by email (partial match)","required":false,"schema":{"type":"string"}},{"name":"roleId","in":"query","description":"Filter to admins holding this role id","required":false,"schema":{"type":"integer","format":"int64"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":0,"minimum":0}},{"name":"size","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":50,"exclusiveMinimum":0,"maximum":200}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponsePagedResponseAdminListItemResponse"}}}}},"security":[{"bearerAuth":[]}]}},"/api/v1/achievements":{"get":{"tags":["Achievements"],"summary":"Get achievements","description":"Lists every achievement and the authenticated user's unlock status for each.","operationId":"getAchievements","parameters":[{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseListAchievementResponse"}}}}}}},"/api/v0/devotionals":{"get":{"tags":["Devotionals"],"summary":"Get devotional for a date","description":"Returns the LIVE devotional for the given date.","operationId":"getDevotionalForDate","parameters":[{"name":"date","in":"query","description":"Date in yyyy-MM-dd","required":false,"schema":{"type":"string","format":"date"}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseDailyDevotionalResponse"}}}}}}},"/api/v0/devotionals/{devotionalId}/impact":{"get":{"tags":["Devotionals"],"summary":"Get user's impact feedback for a devotional","description":"Returns the impact selections the current user has made for a given devotional.","operationId":"getImpact_1","parameters":[{"name":"devotionalId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseDevotionalImpactResponse"}}}}}}},"/api/v0/devotionals/between":{"get":{"tags":["Devotionals"],"summary":"Get devotionals between two dates","description":"Returns LIVE devotionals between the given start and end dates (inclusive), ordered by date descending (newest first).","operationId":"getDevotionalsBetween","parameters":[{"name":"startDate","in":"query","description":"Start date in yyyy-MM-dd","required":true,"schema":{"type":"string","format":"date"}},{"name":"endDate","in":"query","description":"End date in yyyy-MM-dd","required":true,"schema":{"type":"string","format":"date"}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseListDailyDevotionalResponse"}}}}}}},"/api/v0/challenges":{"get":{"tags":["Challenges"],"summary":"Get all challenges","operationId":"getAllChallenges_1","parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":0,"minimum":0}},{"name":"size","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":10,"maximum":50}},{"name":"challengeName","in":"query","required":false,"schema":{"type":"string"}},{"name":"startDate","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"endDate","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponsePagedResponseChallengeResponse"}}}}}}},"/api/v0/challenges/{id}":{"get":{"tags":["Challenges"],"summary":"Get challenge by ID","operationId":"getChallengeById_1","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseChallengeResponse"}}}}}}},"/api/v0/challenges/subscriptions":{"get":{"tags":["Challenges"],"summary":"Get user challenge subscriptions","operationId":"subscriptions","parameters":[{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseListChallengeResponse"}}}}}}},"/":{"get":{"tags":["index-controller"],"operationId":"index","parameters":[{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/api/v1/scriptures/{scriptureId}":{"delete":{"tags":["Scriptures"],"summary":"Delete a saved scripture","operationId":"deleteScripture_1","parameters":[{"name":"scriptureId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseVoid"}}}}}}},"/api/v1/bibles/users/blacklist/{versionId}":{"delete":{"tags":["Bible"],"summary":"Remove a version from a user's blacklist","description":"Delete a stored bible version id from the user's blacklist","operationId":"removeFromBlacklist","parameters":[{"name":"versionId","in":"path","required":true,"schema":{"type":"string"}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponseVoid"}}}}}}},"/api/v0/challenges/{id}/unsubscribe":{"delete":{"tags":["Challenges"],"summary":"Unsubscribe from a challenge","operationId":"unsubscribe","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"x-timezone","in":"header","description":"Client timezone (e.g., 'America/New_York', 'Europe/London', 'Africa/Lagos')","required":true,"schema":{"type":"string","default":"Africa/Lagos","example":"Africa/Lagos"}}],"responses":{"204":{"description":"No Content","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseVoid"}}}}}}}},"components":{"schemas":{"UpdateProfileRequest":{"type":"object","description":"Profile update request","properties":{"firstName":{"type":"string","description":"First name"},"lastName":{"type":"string","description":"Last name"},"phoneNumber":{"type":"string","description":"Phone number"},"gender":{"type":"string","description":"Gender: MALE or FEMALE","pattern":"MALE|FEMALE"}}},"ApiResponseString":{"type":"object","description":"Standard HC API response wrapper for all endpoints","properties":{"success":{"type":"boolean","description":"Indicates if the request was successful"},"message":{"type":"string","description":"Response message describing the result"},"timestamp":{"type":"string","format":"date-time","description":"Response timestamp"},"data":{"type":"string","description":"Response data payload"}}},"SecurityContext":{"type":"object","properties":{"userId":{"type":"integer","format":"int64"},"email":{"type":"string"},"role":{"type":"string"},"userType":{"type":"string"},"firstName":{"type":"string"},"lastName":{"type":"string"},"authenticated":{"type":"boolean"},"privileges":{"type":"array","items":{"type":"string"},"uniqueItems":true},"admin":{"type":"boolean"},"appUser":{"type":"boolean"}}},"ApiResponseLong":{"type":"object","description":"Standard HC API response wrapper for all endpoints","properties":{"success":{"type":"boolean","description":"Indicates if the request was successful"},"message":{"type":"string","description":"Response message describing the result"},"timestamp":{"type":"string","format":"date-time","description":"Response timestamp"},"data":{"type":"integer","format":"int64","description":"Response data payload"}}},"ApiResponseDevotionalV2ItemCompletionResponse":{"type":"object","description":"Standard HC API response wrapper for all endpoints","properties":{"success":{"type":"boolean","description":"Indicates if the request was successful"},"message":{"type":"string","description":"Response message describing the result"},"timestamp":{"type":"string","format":"date-time","description":"Response timestamp"},"data":{"$ref":"#/components/schemas/DevotionalV2ItemCompletionResponse","description":"Response data payload"}}},"DevotionalV2ItemCompletionResponse":{"type":"object","description":"Bible plan day completion response","properties":{"devotionalId":{"type":"integer","format":"int64","description":"Bible plan ID"},"dayNumber":{"type":"integer","format":"int32","description":"Day number"},"completed":{"type":"boolean","description":"Whether this day is currently marked complete"},"participation":{"$ref":"#/components/schemas/DevotionalV2ParticipationResponse","description":"Updated participation progress for the bible plan"}}},"DevotionalV2ParticipationResponse":{"type":"object","description":"User participation metadata for a bible plan","properties":{"status":{"type":"string","description":"Participation status","enum":["NOT_STARTED","STARTED","COMPLETED"]},"startDate":{"type":"string","format":"date","description":"Date user started this bible plan"},"nextDayNumber":{"type":"integer","format":"int32","description":"Next day the user should read"},"progressPercentage":{"type":"integer","format":"int32","description":"Percentage of the plan completed so far, capped at 100"}}},"UpdateTestimonyRequest":{"type":"object","description":"Request to update a testimony (admin)","properties":{"title":{"type":"string","description":"Title","minLength":1},"content":{"type":"string","description":"Content","minLength":1},"submitterName":{"type":"string","description":"Submitter name"},"submitterEmail":{"type":"string","description":"Submitter email"},"countryId":{"type":"integer","format":"int64","description":"Country ID"},"category":{"type":"string","description":"Category","enum":["SALVATION","SPIRITUAL_GROWTH","OTHERS"]}},"required":["category","content","countryId","title"]},"AdminTestimonyResponse":{"type":"object","description":"Admin view of a testimony (enriched)","properties":{"id":{"type":"integer","format":"int64"},"title":{"type":"string"},"content":{"type":"string"},"category":{"type":"string"},"approved":{"type":"boolean"},"author":{"$ref":"#/components/schemas/Author"},"publishedAt":{"type":"string","format":"date-time"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"likeCount":{"type":"integer","format":"int64"}}},"ApiResponseAdminTestimonyResponse":{"type":"object","description":"Standard HC API response wrapper for all endpoints","properties":{"success":{"type":"boolean","description":"Indicates if the request was successful"},"message":{"type":"string","description":"Response message describing the result"},"timestamp":{"type":"string","format":"date-time","description":"Response timestamp"},"data":{"$ref":"#/components/schemas/AdminTestimonyResponse","description":"Response data payload"}}},"Author":{"type":"object","properties":{"name":{"type":"string"},"emailAddress":{"type":"string"},"avatar":{"type":"string"},"country":{"type":"string"},"countryFlag":{"type":"string"},"countryId":{"type":"integer","format":"int64"}}},"UpdateDailyScriptureRequest":{"type":"object","description":"Request to update a daily scripture","properties":{"book":{"type":"string","description":"Bible book name"},"chapter":{"type":"integer","format":"int32","description":"Chapter number"},"verseStart":{"type":"integer","format":"int32","description":"Starting verse number"},"verseEnd":{"type":"integer","format":"int32","description":"Ending verse number (optional)"},"text":{"type":"string","description":"Scripture text"},"scheduledDatetime":{"type":"string","format":"date-time","description":"Scheduled datetime for publication"}}},"AdminDailyScriptureResponse":{"type":"object","description":"Daily scripture details response (admin view)","properties":{"id":{"type":"integer","format":"int64","description":"Scripture ID"},"book":{"type":"string","description":"Bible book name"},"chapter":{"type":"integer","format":"int32","description":"Chapter number"},"verseStart":{"type":"integer","format":"int32","description":"Starting verse number"},"verseEnd":{"type":"integer","format":"int32","description":"Ending verse number"},"text":{"type":"string","description":"Scripture text"},"scheduledDatetime":{"type":"string","format":"date-time","description":"Scheduled datetime for publication"},"status":{"type":"string","description":"Scripture status","enum":["DRAFT","LIVE","OUTDATED"]},"createdBy":{"type":"string","description":"Full name of admin who created the scripture"},"dateCreated":{"type":"string","format":"date-time","description":"When the scripture was created"},"dateModified":{"type":"string","format":"date-time","description":"When the scripture was last modified"}}},"ApiResponseAdminDailyScriptureResponse":{"type":"object","description":"Standard HC API response wrapper for all endpoints","properties":{"success":{"type":"boolean","description":"Indicates if the request was successful"},"message":{"type":"string","description":"Response message describing the result"},"timestamp":{"type":"string","format":"date-time","description":"Response timestamp"},"data":{"$ref":"#/components/schemas/AdminDailyScriptureResponse","description":"Response data payload"}}},"UpdateRoleRequest":{"type":"object","description":"Request to update an existing admin role","properties":{"name":{"type":"string","description":"Role name","minLength":1},"description":{"type":"string","description":"Role description"},"privilegeCodes":{"type":"array","description":"Privilege codes granted to this role","items":{"type":"string"},"minItems":1}},"required":["name","privilegeCodes"]},"ApiResponseRoleResponse":{"type":"object","description":"Standard HC API response wrapper for all endpoints","properties":{"success":{"type":"boolean","description":"Indicates if the request was successful"},"message":{"type":"string","description":"Response message describing the result"},"timestamp":{"type":"string","format":"date-time","description":"Response timestamp"},"data":{"$ref":"#/components/schemas/RoleResponse","description":"Response data payload"}}},"PrivilegeResponse":{"type":"object","description":"A fixed privilege that a role can be granted","properties":{"code":{"type":"string","description":"Privilege code, used in CreateRoleRequest/UpdateRoleRequest"},"name":{"type":"string","description":"Human readable name"},"description":{"type":"string","description":"Description of what this privilege allows"}}},"RoleResponse":{"type":"object","description":"An admin role and the privileges it grants","properties":{"id":{"type":"integer","format":"int64","description":"Role id"},"name":{"type":"string","description":"Role name"},"description":{"type":"string","description":"Role description"},"privileges":{"type":"array","description":"Privileges granted by this role","items":{"$ref":"#/components/schemas/PrivilegeResponse"}},"adminCount":{"type":"integer","format":"int64","description":"Number of admins currently holding this role"},"dateCreated":{"type":"string","format":"date-time","description":"When the role was created"}}},"UpdateEventRequest":{"type":"object","description":"Event update details","properties":{"eventName":{"type":"string","description":"Event name","minLength":1},"aboutEvent":{"type":"string","description":"About event","minLength":1},"eventBanner":{"type":"string","format":"binary","description":"Event banner image file (optional)"},"eventDateTime":{"type":"string","format":"date-time","description":"Event date and time"},"eventUrl":{"type":"string","description":"Event Url"}},"required":["aboutEvent","eventDateTime","eventName"]},"ApiResponseEventResponse":{"type":"object","description":"Standard HC API response wrapper for all endpoints","properties":{"success":{"type":"boolean","description":"Indicates if the request was successful"},"message":{"type":"string","description":"Response message describing the result"},"timestamp":{"type":"string","format":"date-time","description":"Response timestamp"},"data":{"$ref":"#/components/schemas/EventResponse","description":"Response data payload"}}},"EventResponse":{"type":"object","description":"Event details response","properties":{"id":{"type":"integer","format":"int64","description":"Event ID"},"eventName":{"type":"string","description":"Event name"},"aboutEvent":{"type":"string","description":"About event"},"eventBannerUrl":{"type":"string","description":"Event banner URL"},"eventUrl":{"type":"string","description":"Event URL"},"eventDateTime":{"type":"string","format":"date-time","description":"Event date and time"},"createdBy":{"type":"string","description":"Full name of admin who created the event"},"dateCreated":{"type":"string","format":"date-time","description":"When the event was created"},"dateModified":{"type":"string","format":"date-time","description":"When the event was last modified"}}},"UpdateCourseRequest":{"type":"object","description":"Request to update course title and description","properties":{"title":{"type":"string","description":"Course title","minLength":1},"description":{"type":"string","description":"Course description","minLength":1},"image":{"type":"string","format":"binary","description":"Course cover image or GIF file (omit to keep existing image)"}},"required":["description","title"]},"AdminCourseResponse":{"type":"object","description":"Course details response (admin view)","properties":{"id":{"type":"integer","format":"int64","description":"Course ID"},"title":{"type":"string","description":"Course title"},"description":{"type":"string","description":"Course description"},"courseStatus":{"type":"string","description":"Course status","enum":["DRAFT","LIVE"]},"moduleCount":{"type":"integer","format":"int32","description":"Number of modules in the course"},"mediaCount":{"type":"integer","format":"int32","description":"Number of media in the course"},"activityCount":{"type":"integer","format":"int32","description":"Number of activities in the course"},"createdBy":{"type":"string","description":"Full name of admin who created the course"},"dateCreated":{"type":"string","format":"date-time","description":"When the course was created"},"dateModified":{"type":"string","format":"date-time","description":"When the course was last modified"},"imageUrl":{"type":"string","description":"Course cover image or GIF URL, empty if none set"},"detailLevel":{"type":"string","description":"Detail level of the response (BASIC for listing, FULL for detailed view)","enum":["BASIC","FULL"]}}},"ApiResponseAdminCourseResponse":{"type":"object","description":"Standard HC API response wrapper for all endpoints","properties":{"success":{"type":"boolean","description":"Indicates if the request was successful"},"message":{"type":"string","description":"Response message describing the result"},"timestamp":{"type":"string","format":"date-time","description":"Response timestamp"},"data":{"$ref":"#/components/schemas/AdminCourseResponse","description":"Response data payload"}}},"ActivityEdit":{"type":"object","description":"Activity edit data used to add, update or remove activities","properties":{"id":{"type":"integer","format":"int64","description":"Existing activity id (required for UPDATE and REMOVE)"},"content":{"type":"string","description":"Activity content (required for ADD/UPDATE)","minLength":1},"order":{"type":"integer","format":"int32","description":"Activity order/sequence number (required for ADD/UPDATE)"},"operation":{"type":"string","description":"Operation to perform: ADD, UPDATE, REMOVE","enum":["ADD","UPDATE","REMOVE"]}},"required":["content","operation","order"]},"UpdateModuleRequest":{"type":"object","description":"Request to update module title, content and media links. Null fields will be applied to the entity as-is (allow clearing).","properties":{"title":{"type":"string","description":"Module title","minLength":1},"content":{"type":"string","description":"Module content (HTML)"},"mediaLinks":{"type":"array","description":"List of media URLs (videos, images, documents)","items":{"type":"string"}},"activities":{"type":"array","description":"Optional list of activity edits to apply as part of this module update","items":{"$ref":"#/components/schemas/ActivityEdit"}}},"required":["mediaLinks","title"]},"AdminActivityResponse":{"type":"object","description":"Course activity details response (admin view)","properties":{"id":{"type":"integer","format":"int64","description":"Activity ID"},"moduleId":{"type":"integer","format":"int64","description":"Module ID"},"content":{"type":"string","description":"Activity content"},"order":{"type":"integer","format":"int32","description":"Activity order/sequence number"},"createdBy":{"type":"string","description":"Full name of admin who created the activity"},"dateCreated":{"type":"string","format":"date-time","description":"When the activity was created"}}},"AdminModuleResponse":{"type":"object","description":"Module details response (admin view)","properties":{"id":{"type":"integer","format":"int64","description":"Module ID"},"courseId":{"type":"integer","format":"int64","description":"Course ID"},"title":{"type":"string","description":"Module title"},"content":{"type":"string","description":"Module HTML content"},"mediaLinks":{"type":"array","description":"Media links (videos, images, documents)","items":{"type":"string"}},"order":{"type":"integer","format":"int32","description":"Module order/sequence number"},"activities":{"type":"array","description":"Module activities","items":{"$ref":"#/components/schemas/AdminActivityResponse"}},"hasContent":{"type":"boolean","description":"Has content been added"},"createdBy":{"type":"string","description":"Full name of admin who created the module"},"dateCreated":{"type":"string","format":"date-time","description":"When the module was created"}}},"ApiResponseAdminModuleResponse":{"type":"object","description":"Standard HC API response wrapper for all endpoints","properties":{"success":{"type":"boolean","description":"Indicates if the request was successful"},"message":{"type":"string","description":"Response message describing the result"},"timestamp":{"type":"string","format":"date-time","description":"Response timestamp"},"data":{"$ref":"#/components/schemas/AdminModuleResponse","description":"Response data payload"}}},"ActivityData":{"type":"object","description":"Activity data","properties":{"content":{"type":"string","description":"Activity content","minLength":1},"order":{"type":"integer","format":"int32","description":"Activity order/sequence number","minimum":1}},"required":["content","order"]},"AddModuleContentRequest":{"type":"object","description":"Request to add content to a module","properties":{"content":{"type":"string","description":"HTML content for the module","minLength":1},"mediaLinks":{"type":"array","description":"List of media URLs (videos, images, documents)","items":{"type":"string"}},"activities":{"type":"array","description":"List of activities for this module (ordered)","items":{"$ref":"#/components/schemas/ActivityData"}}},"required":["content"]},"UpdateActivityRequest":{"type":"object","description":"Request to update a module activity (partial update supported)","properties":{"content":{"type":"string","description":"Activity content (HTML)"},"order":{"type":"integer","format":"int32","description":"Activity order/sequence number (>=1)"}}},"ApiResponseAdminActivityResponse":{"type":"object","description":"Standard HC API response wrapper for all endpoints","properties":{"success":{"type":"boolean","description":"Indicates if the request was successful"},"message":{"type":"string","description":"Response message describing the result"},"timestamp":{"type":"string","format":"date-time","description":"Response timestamp"},"data":{"$ref":"#/components/schemas/AdminActivityResponse","description":"Response data payload"}}},"UpdateChallengeV2Request":{"type":"object","description":"Request to update challenge series details","properties":{"title":{"type":"string","description":"Challenge series title","minLength":1},"numberOfDays":{"type":"integer","format":"int32","description":"Total number of days in challenge"}},"required":["numberOfDays","title"]},"AdminChallengeSeriesDetailResponse":{"type":"object","description":"Challenge series with all day items (admin view)","properties":{"challenge":{"$ref":"#/components/schemas/AdminChallengeSeriesResponse","description":"Challenge series metadata"},"items":{"type":"array","description":"Challenge day items","items":{"$ref":"#/components/schemas/ChallengeItemResponse"}}}},"AdminChallengeSeriesResponse":{"type":"object","description":"Challenge series details response (admin view)","properties":{"id":{"type":"integer","format":"int64","description":"Challenge series ID"},"title":{"type":"string","description":"Title of challenge series"},"numberOfDays":{"type":"integer","format":"int32","description":"Total number of days"},"completedDays":{"type":"integer","format":"int32","description":"Number of day items currently filled"},"status":{"type":"string","description":"Challenge series status","enum":["DRAFT","LIVE"]},"dateCreated":{"type":"string","format":"date-time","description":"When challenge series was created"},"dateModified":{"type":"string","format":"date-time","description":"When challenge series was last modified"}}},"ApiResponseAdminChallengeSeriesDetailResponse":{"type":"object","description":"Standard HC API response wrapper for all endpoints","properties":{"success":{"type":"boolean","description":"Indicates if the request was successful"},"message":{"type":"string","description":"Response message describing the result"},"timestamp":{"type":"string","format":"date-time","description":"Response timestamp"},"data":{"$ref":"#/components/schemas/AdminChallengeSeriesDetailResponse","description":"Response data payload"}}},"ChallengeItemResponse":{"type":"object","description":"Challenge item response","properties":{"id":{"type":"integer","format":"int64","description":"Challenge item ID"},"challengeId":{"type":"integer","format":"int64","description":"Challenge series ID"},"dayNumber":{"type":"integer","format":"int32","description":"Challenge day number"},"title":{"type":"string","description":"Challenge item title"},"content":{"type":"string","description":"Challenge item content"},"activities":{"type":"array","description":"Activities for this day","items":{"type":"string"}},"dateCreated":{"type":"string","format":"date-time","description":"When challenge item was created"},"dateModified":{"type":"string","format":"date-time","description":"When challenge item was last modified"}}},"UpsertChallengeItemRequest":{"type":"object","description":"Request to add or update a challenge day item","properties":{"title":{"type":"string","description":"Challenge item title","minLength":1},"content":{"type":"string","description":"Challenge item content (HTML)","minLength":1},"activities":{"type":"array","description":"Activities for this challenge day","items":{"type":"string","minLength":1},"minItems":1}},"required":["activities","content","title"]},"ApiResponseChallengeItemResponse":{"type":"object","description":"Standard HC API response wrapper for all endpoints","properties":{"success":{"type":"boolean","description":"Indicates if the request was successful"},"message":{"type":"string","description":"Response message describing the result"},"timestamp":{"type":"string","format":"date-time","description":"Response timestamp"},"data":{"$ref":"#/components/schemas/ChallengeItemResponse","description":"Response data payload"}}},"BibleReferenceDto":{"type":"object","description":"Bible reference details","properties":{"name":{"type":"string","description":"Book name","example":"John","minLength":1},"chapter":{"type":"integer","format":"int32","description":"Chapter number","example":3},"verse":{"type":"string","description":"Verse number or range","example":"16-18","minLength":1,"pattern":"^\\d+(?:-\\d+)?$"}},"required":["chapter","name","verse"]},"UpsertDevotionalItemRequest":{"type":"object","description":"Request to add or update a bible plan day item","properties":{"title":{"type":"string","description":"Bible plan item title (optional)"},"content":{"type":"string","description":"Bible plan item content (HTML). Optional while the plan is in draft; required before publishing."},"bibleReferences":{"type":"array","description":"Bible references for this bible plan day","items":{"$ref":"#/components/schemas/BibleReferenceDto"},"minItems":1}},"required":["bibleReferences"]},"AdminDevotionalItemResponse":{"type":"object","description":"Bible plan item details response (admin view)","properties":{"id":{"type":"integer","format":"int64","description":"Bible plan item ID"},"devotionalId":{"type":"integer","format":"int64","description":"Parent bible plan ID"},"dayNumber":{"type":"integer","format":"int32","description":"Day number"},"title":{"type":"string","description":"Bible plan item title"},"content":{"type":"string","description":"Bible plan item content"},"bibleReferences":{"type":"array","description":"Bible references","items":{"$ref":"#/components/schemas/BibleReferenceDto"}},"dateCreated":{"type":"string","format":"date-time","description":"When item was created"},"dateModified":{"type":"string","format":"date-time","description":"When item was last modified"}}},"ApiResponseAdminDevotionalItemResponse":{"type":"object","description":"Standard HC API response wrapper for all endpoints","properties":{"success":{"type":"boolean","description":"Indicates if the request was successful"},"message":{"type":"string","description":"Response message describing the result"},"timestamp":{"type":"string","format":"date-time","description":"Response timestamp"},"data":{"$ref":"#/components/schemas/AdminDevotionalItemResponse","description":"Response data payload"}}},"UpdateDevotionalV2Request":{"type":"object","description":"Request to update bible plan details","properties":{"title":{"type":"string","description":"Bible plan title","minLength":1},"numberOfDays":{"type":"integer","format":"int32","description":"Total number of days in bible plan"},"thumbnail":{"type":"string","format":"binary","description":"Bible plan thumbnail image file (omit to keep existing thumbnail)"}},"required":["numberOfDays","title"]},"AdminDevotionalDetailResponse":{"type":"object","description":"Bible plan with all day items (admin view)","properties":{"devotional":{"$ref":"#/components/schemas/AdminDevotionalResponse","description":"Bible plan metadata"},"items":{"type":"array","description":"Day items sorted by day number","items":{"$ref":"#/components/schemas/AdminDevotionalItemResponse"}}}},"AdminDevotionalResponse":{"type":"object","description":"Bible plan details response (admin view)","properties":{"id":{"type":"integer","format":"int64","description":"Bible plan ID"},"title":{"type":"string","description":"Title of bible plan"},"thumbnailUrl":{"type":"string","description":"Thumbnail image URL"},"numberOfDays":{"type":"integer","format":"int32","description":"Total number of days"},"completedDays":{"type":"integer","format":"int32","description":"Number of day items currently filled"},"status":{"type":"string","description":"Bible plan status","enum":["DRAFT","LIVE"]},"dateCreated":{"type":"string","format":"date-time","description":"When bible plan was created"},"dateModified":{"type":"string","format":"date-time","description":"When bible plan was last modified"}}},"ApiResponseAdminDevotionalDetailResponse":{"type":"object","description":"Standard HC API response wrapper for all endpoints","properties":{"success":{"type":"boolean","description":"Indicates if the request was successful"},"message":{"type":"string","description":"Response message describing the result"},"timestamp":{"type":"string","format":"date-time","description":"Response timestamp"},"data":{"$ref":"#/components/schemas/AdminDevotionalDetailResponse","description":"Response data payload"}}},"UpdateAdminProfileRequest":{"type":"object","description":"New email and full name","properties":{"email":{"type":"string","format":"email","description":"New email address","minLength":1},"firstName":{"type":"string","description":"New first name","minLength":1},"lastName":{"type":"string","description":"New last name","minLength":1}},"required":["email","firstName","lastName"]},"AdminProfileResponse":{"type":"object","description":"An admin's own profile details","properties":{"id":{"type":"integer","format":"int64","description":"Admin id"},"email":{"type":"string","description":"Email address"},"firstName":{"type":"string","description":"First name"},"lastName":{"type":"string","description":"Last name"},"imageUrl":{"type":"string","description":"Profile image URL, or null if none set"}}},"ApiResponseAdminProfileResponse":{"type":"object","description":"Standard HC API response wrapper for all endpoints","properties":{"success":{"type":"boolean","description":"Indicates if the request was successful"},"message":{"type":"string","description":"Response message describing the result"},"timestamp":{"type":"string","format":"date-time","description":"Response timestamp"},"data":{"$ref":"#/components/schemas/AdminProfileResponse","description":"Response data payload"}}},"UpdateAdminRequest":{"type":"object","description":"New admin details","properties":{"email":{"type":"string","format":"email","description":"New email address","minLength":1},"firstName":{"type":"string","description":"New first name","minLength":1},"lastName":{"type":"string","description":"New last name","minLength":1},"phoneNumber":{"type":"string","description":"New phone number (optional)"},"roleId":{"type":"integer","format":"int64","description":"Role id to assign (null = remove role)"}},"required":["email","firstName","lastName"]},"AdminListItemResponse":{"type":"object","description":"An admin row in a filtered/paginated admin listing","properties":{"id":{"type":"integer","format":"int64","description":"Admin id"},"name":{"type":"string","description":"Full name"},"email":{"type":"string","description":"Email address"},"roleId":{"type":"integer","format":"int64","description":"Id of the role held by this admin, or null if none"},"role":{"type":"string","description":"Name of the role held by this admin, or null if none"},"dateJoined":{"type":"string","format":"date","description":"When the admin was created"}}},"ApiResponseAdminListItemResponse":{"type":"object","description":"Standard HC API response wrapper for all endpoints","properties":{"success":{"type":"boolean","description":"Indicates if the request was successful"},"message":{"type":"string","description":"Response message describing the result"},"timestamp":{"type":"string","format":"date-time","description":"Response timestamp"},"data":{"$ref":"#/components/schemas/AdminListItemResponse","description":"Response data payload"}}},"AddressRequest":{"type":"object","properties":{"countryId":{"type":"integer","format":"int64"},"provinceId":{"type":"integer","format":"int64"},"city":{"type":"string","maxLength":255,"minLength":0},"lineAddress":{"type":"string","maxLength":1024,"minLength":0}},"required":["countryId","provinceId"]},"AddressObject":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"name":{"type":"string"},"flagUrl":{"type":"string","description":"Country flag URL"}}},"AddressResponse":{"type":"object","description":"Address response DTO","properties":{"country":{"$ref":"#/components/schemas/AddressObject","description":"country"},"province":{"$ref":"#/components/schemas/AddressObject","description":"province"},"city":{"type":"string","description":"City"},"lineAddress":{"type":"string","description":"Line address"}}},"ApiResponseAddressResponse":{"type":"object","description":"Standard HC API response wrapper for all endpoints","properties":{"success":{"type":"boolean","description":"Indicates if the request was successful"},"message":{"type":"string","description":"Response message describing the result"},"timestamp":{"type":"string","format":"date-time","description":"Response timestamp"},"data":{"$ref":"#/components/schemas/AddressResponse","description":"Response data payload"}}},"UpdateDailyDevotionalRequest":{"type":"object","description":"Request to update a daily devotional","properties":{"title":{"type":"string","description":"Title of the devotional","minLength":1},"devotionalDate":{"type":"string","format":"date","description":"Date of the devotional"},"content":{"type":"string","description":"Devotional content (HTML)","minLength":1},"publishTime":{"type":"string","description":"Time the devotional should be published"},"scriptures":{"type":"array","description":"Scripture references","items":{"type":"string","pattern":"^(?:[1-3]\\s)?[A-Za-z]+(?:\\s[A-Za-z]+)*\\s\\d+(?::\\d+(?:-\\d+)?)?$"},"uniqueItems":true},"scheduled":{"type":"boolean","description":"Whether to publish immediately if date/time is missing"}},"required":["content","scheduled","title"]},"AdminDailyDevotionalResponse":{"type":"object","description":"Daily devotional details response (admin view)","properties":{"id":{"type":"integer","format":"int64","description":"Devotional ID"},"title":{"type":"string","description":"Title of the devotional"},"scheduled":{"type":"boolean","description":"scheduled devotion"},"devotionalDate":{"type":"string","format":"date","description":"Devotional date"},"content":{"type":"string","description":"Devotional content"},"publishTime":{"type":"string","description":"Publish time"},"status":{"type":"string","description":"Devotional status","enum":["DRAFT","LIVE"]},"scriptures":{"type":"array","description":"Scripture references","items":{"type":"string"},"uniqueItems":true},"createdBy":{"type":"string","description":"Full name of admin who created the devotional"},"dateCreated":{"type":"string","format":"date-time","description":"When the devotional was created"},"dateModified":{"type":"string","format":"date-time","description":"When the devotional was last modified"}}},"ApiResponseAdminDailyDevotionalResponse":{"type":"object","description":"Standard HC API response wrapper for all endpoints","properties":{"success":{"type":"boolean","description":"Indicates if the request was successful"},"message":{"type":"string","description":"Response message describing the result"},"timestamp":{"type":"string","format":"date-time","description":"Response timestamp"},"data":{"$ref":"#/components/schemas/AdminDailyDevotionalResponse","description":"Response data payload"}}},"UpdateChallengeRequest":{"type":"object","description":"Request to update a challenge","properties":{"challengeName":{"type":"string","description":"Challenge name","minLength":1},"aboutChallenge":{"type":"string","description":"About challenge","minLength":1},"startDate":{"type":"string","format":"date","description":"Challenge start date"},"endDate":{"type":"string","format":"date","description":"Challenge end date"}},"required":["aboutChallenge","challengeName","endDate","startDate"]},"AdminChallengeResponse":{"type":"object","description":"Challenge details response (admin view)","properties":{"id":{"type":"integer","format":"int64","description":"Challenge ID"},"challengeName":{"type":"string","description":"Challenge name"},"aboutChallenge":{"type":"string","description":"About challenge"},"startDate":{"type":"string","format":"date","description":"Challenge start date"},"endDate":{"type":"string","format":"date","description":"Challenge end date"},"numberOfDays":{"type":"integer","format":"int32","description":"Number of days for the challenge"},"createdBy":{"type":"string","description":"Full name of admin who created the challenge"},"dateCreated":{"type":"string","format":"date-time","description":"When the challenge was created"},"dateModified":{"type":"string","format":"date-time","description":"When the challenge was last modified"},"detailLevel":{"type":"string","description":"Detail level of the response (BASIC for listing, FULL for detailed view)","enum":["BASIC","FULL"]}}},"ApiResponseAdminChallengeResponse":{"type":"object","description":"Standard HC API response wrapper for all endpoints","properties":{"success":{"type":"boolean","description":"Indicates if the request was successful"},"message":{"type":"string","description":"Response message describing the result"},"timestamp":{"type":"string","format":"date-time","description":"Response timestamp"},"data":{"$ref":"#/components/schemas/AdminChallengeResponse","description":"Response data payload"}}},"AddPathRequest":{"type":"object","description":"Path assignment request","properties":{"path":{"type":"string","description":"Path enum name to assign (e.g. NEW_CONVERT)","minLength":1}},"required":["path"]},"AppUserSignupRequest":{"type":"object","description":"User signup details","properties":{"firstName":{"type":"string","description":"First name","minLength":1},"lastName":{"type":"string","description":"Last name","minLength":1},"email":{"type":"string","format":"email","description":"Email","minLength":1},"username":{"type":"string","description":"Username","minLength":1}},"required":["email","firstName","lastName","username"]},"ApiResponseAppUserLoginResponse":{"type":"object","description":"Standard HC API response wrapper for all endpoints","properties":{"success":{"type":"boolean","description":"Indicates if the request was successful"},"message":{"type":"string","description":"Response message describing the result"},"timestamp":{"type":"string","format":"date-time","description":"Response timestamp"},"data":{"$ref":"#/components/schemas/AppUserLoginResponse","description":"Response data payload"}}},"AppUserLoginResponse":{"type":"object","description":"App user login response containing user details and tokens","properties":{"userId":{"type":"integer","format":"int64","description":"User id"},"email":{"type":"string","description":"Email"},"firstName":{"type":"string","description":"First name"},"lastName":{"type":"string","description":"Last name"},"username":{"type":"string","description":"Username"},"tokens":{"$ref":"#/components/schemas/AuthTokenResponse","description":"Authentication tokens"}}},"AuthTokenResponse":{"type":"object","description":"Authentication response with access and refresh token data","properties":{"accessToken":{"$ref":"#/components/schemas/TokenData","description":"Access token data"},"refreshToken":{"$ref":"#/components/schemas/TokenData","description":"Refresh token data"}}},"TokenData":{"type":"object","description":"Token data containing JWT token and metadata","properties":{"token":{"type":"string","description":"JWT token (access or refresh)"},"tokenType":{"type":"string","description":"Token type ('Access' or 'Refresh')"},"expiresAt":{"type":"string","format":"date-time","description":"Token expiration time as LocalDateTime"},"expiresIn":{"type":"integer","format":"int64","description":"Token expiration in seconds from now"},"userId":{"type":"integer","format":"int64","description":"User ID associated with the token"},"email":{"type":"string","description":"User email associated with the token"},"role":{"type":"string","description":"User role"},"userType":{"type":"string","description":"User type (ADMIN, APP_USER, etc.)"}}},"RefreshTokenRequest":{"type":"object","description":"Refresh token request","properties":{"refreshToken":{"type":"string","description":"Refresh token obtained from login","minLength":1}},"required":["refreshToken"]},"ApiResponseAuthTokenResponse":{"type":"object","description":"Standard HC API response wrapper for all endpoints","properties":{"success":{"type":"boolean","description":"Indicates if the request was successful"},"message":{"type":"string","description":"Response message describing the result"},"timestamp":{"type":"string","format":"date-time","description":"Response timestamp"},"data":{"$ref":"#/components/schemas/AuthTokenResponse","description":"Response data payload"}}},"AppUserLoginRequest":{"type":"object","description":"User login (email only)","properties":{"email":{"type":"string","format":"email","description":"User email","minLength":1}},"required":["email"]},"AppUserGoogleAuthRequest":{"type":"object","description":"Google access token from client","properties":{"accessToken":{"type":"string","description":"Google OAuth access token obtained on client"}}},"CreateTestimonyByUserRequest":{"type":"object","description":"Request to create a testimony by an authenticated app user","properties":{"title":{"type":"string","description":"Title","minLength":1},"content":{"type":"string","description":"Content","minLength":1},"category":{"type":"string","description":"Category","enum":["SALVATION","SPIRITUAL_GROWTH","OTHERS"]},"anonymousSubmission":{"type":"boolean","description":"Anonymous Submission"}},"required":["category","content","title"]},"ApiResponseTestimonyResponse":{"type":"object","description":"Standard HC API response wrapper for all endpoints","properties":{"success":{"type":"boolean","description":"Indicates if the request was successful"},"message":{"type":"string","description":"Response message describing the result"},"timestamp":{"type":"string","format":"date-time","description":"Response timestamp"},"data":{"$ref":"#/components/schemas/TestimonyResponse","description":"Response data payload"}}},"TestimonyResponse":{"type":"object","description":"Public testimony response","properties":{"id":{"type":"integer","format":"int64"},"title":{"type":"string"},"content":{"type":"string"},"category":{"type":"string"},"author":{"$ref":"#/components/schemas/Author"},"publishedAt":{"type":"string","format":"date-time"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"isLiked":{"type":"boolean"},"likeCount":{"type":"integer","format":"int64"}}},"SaveScriptureItemRequest":{"type":"object","description":"A single scripture to save","properties":{"version":{"type":"string","description":"Bible version","example":"en-kjv","minLength":1},"reference":{"$ref":"#/components/schemas/BibleReferenceDto","description":"Bible reference (book, chapter, verse or verse range)"}},"required":["reference","version"]},"SaveScripturesRequest":{"type":"object","description":"Request to save one or more scriptures","properties":{"scriptures":{"type":"array","description":"Scriptures to save","items":{"$ref":"#/components/schemas/SaveScriptureItemRequest"},"minItems":1}},"required":["scriptures"]},"ApiResponseListSavedScriptureResponse":{"type":"object","description":"Standard HC API response wrapper for all endpoints","properties":{"success":{"type":"boolean","description":"Indicates if the request was successful"},"message":{"type":"string","description":"Response message describing the result"},"timestamp":{"type":"string","format":"date-time","description":"Response timestamp"},"data":{"type":"array","description":"Response data payload","items":{"$ref":"#/components/schemas/SavedScriptureResponse"}}}},"SavedScriptureResponse":{"type":"object","description":"A saved scripture","properties":{"id":{"type":"integer","format":"int64","description":"Saved scripture ID"},"version":{"type":"string","description":"Bible version"},"book":{"type":"string","description":"Book name"},"chapter":{"type":"integer","format":"int32","description":"Chapter number"},"verse":{"type":"string","description":"Verse number or range"},"dateCreated":{"type":"string","format":"date-time","description":"When this scripture was saved"}}},"EnquiryRequest":{"type":"object","description":"Enquiry request","properties":{"message":{"type":"string"}}},"ApiResponseVoid":{"type":"object","description":"Standard HC API response wrapper for all endpoints","properties":{"success":{"type":"boolean","description":"Indicates if the request was successful"},"message":{"type":"string","description":"Response message describing the result"},"timestamp":{"type":"string","format":"date-time","description":"Response timestamp"},"data":{"description":"Response data payload"}}},"ChallengeV2SubscribeRequest":{"type":"object","description":"Request to subscribe to a challenge","properties":{"challengeId":{"type":"integer","format":"int64","description":"Challenge ID to subscribe to"}},"required":["challengeId"]},"ChallengeV2CompletionRequest":{"type":"object","description":"Request to mark a challenge v2 day as completed","properties":{"challengeId":{"type":"integer","format":"int64","description":"ID of the challenge"},"dayNumber":{"type":"integer","format":"int32","description":"Day number within challenge"}},"required":["challengeId","dayNumber"]},"ApiResponseChallengeV2CompletionResponse":{"type":"object","description":"Standard HC API response wrapper for all endpoints","properties":{"success":{"type":"boolean","description":"Indicates if the request was successful"},"message":{"type":"string","description":"Response message describing the result"},"timestamp":{"type":"string","format":"date-time","description":"Response timestamp"},"data":{"$ref":"#/components/schemas/ChallengeV2CompletionResponse","description":"Response data payload"}}},"ChallengeV2CompletionResponse":{"type":"object","description":"Challenge v2 day completion response","properties":{"challengeId":{"type":"integer","format":"int64","description":"Challenge ID"},"dayNumber":{"type":"integer","format":"int32","description":"Day number"},"completedAt":{"type":"string","format":"date-time","description":"When the day was marked completed"}}},"BlacklistRequest":{"type":"object","properties":{"versionId":{"type":"string"}}},"DevotionalV2ImpactRequest":{"type":"object","description":"Request to submit bible plan impact feedback","properties":{"devotionalId":{"type":"integer","format":"int64","description":"ID of the bible plan"},"dayNumber":{"type":"integer","format":"int32","description":"Day number within bible plan"},"impacts":{"type":"array","description":"Selected impact options","items":{"type":"string","enum":["ENCOURAGED_MY_FAITH","GAVE_ME_SOMETHING_TO_REFLECT_ON","REMINDED_ME_OF_GODS_LOVE","LED_ME_TO_PRAY_OR_MEDITATE","HELPED_ME_GROW_SPIRITUALLY"]},"minItems":1,"uniqueItems":true}},"required":["dayNumber","devotionalId","impacts"]},"ApiResponseDevotionalV2ImpactResponse":{"type":"object","description":"Standard HC API response wrapper for all endpoints","properties":{"success":{"type":"boolean","description":"Indicates if the request was successful"},"message":{"type":"string","description":"Response message describing the result"},"timestamp":{"type":"string","format":"date-time","description":"Response timestamp"},"data":{"$ref":"#/components/schemas/DevotionalV2ImpactResponse","description":"Response data payload"}}},"DevotionalV2ImpactResponse":{"type":"object","description":"Bible plan impact feedback response","properties":{"devotionalId":{"type":"integer","format":"int64","description":"Bible plan ID"},"dayNumber":{"type":"integer","format":"int32","description":"Day number"},"impacts":{"type":"array","description":"Selected impact options","items":{"type":"string","enum":["ENCOURAGED_MY_FAITH","GAVE_ME_SOMETHING_TO_REFLECT_ON","REMINDED_ME_OF_GODS_LOVE","LED_ME_TO_PRAY_OR_MEDITATE","HELPED_ME_GROW_SPIRITUALLY"]},"uniqueItems":true}}},"CreateTestimonyRequest":{"type":"object","description":"Request to create a testimony (admin)","properties":{"title":{"type":"string","description":"Title","minLength":1},"content":{"type":"string","description":"Content","minLength":1},"submitterName":{"type":"string","description":"Submitter name"},"submitterEmail":{"type":"string","description":"Submitter email","minLength":1},"countryId":{"type":"integer","format":"int64","description":"Country ID"},"category":{"type":"string","description":"Category","enum":["SALVATION","SPIRITUAL_GROWTH","OTHERS"]}},"required":["category","content","countryId","submitterEmail","title"]},"CreateDailyScriptureRequest":{"type":"object","description":"Request to create a new daily scripture","properties":{"book":{"type":"string","description":"Bible book name","minLength":1},"chapter":{"type":"integer","format":"int32","description":"Chapter number"},"verseStart":{"type":"integer","format":"int32","description":"Starting verse number"},"verseEnd":{"type":"integer","format":"int32","description":"Ending verse number (optional, if same as start verse)"},"text":{"type":"string","description":"Scripture text","minLength":1},"scheduledDatetime":{"type":"string","format":"date-time","description":"Scheduled datetime for publication"}},"required":["book","chapter","text","verseStart"]},"CreateRoleRequest":{"type":"object","description":"Request to create a new admin role","properties":{"name":{"type":"string","description":"Role name","minLength":1},"description":{"type":"string","description":"Role description"},"privilegeCodes":{"type":"array","description":"Privilege codes granted to this role","items":{"type":"string"},"minItems":1}},"required":["name","privilegeCodes"]},"AssignRoleRequest":{"type":"object","description":"Request to set (or clear) the single role held by an admin","properties":{"adminId":{"type":"integer","format":"int64","description":"Admin id to assign the role to"},"roleId":{"type":"integer","format":"int64","description":"Role id to assign. Null clears the admin's role."}},"required":["adminId"]},"CreateMediaRequest":{"type":"object","description":"Request to create a media item","properties":{"name":{"type":"string","description":"Display name","minLength":1},"description":{"type":"string","description":"Media Description","minLength":1},"links":{"type":"array","items":{"type":"string","minLength":1},"maxItems":2147483647,"minItems":1},"type":{"type":"string","description":"Media type","enum":["VIDEO","SERMON","PODCAST","PLAYLIST","FEATURED_VIDEO"]}},"required":["description","links","name","type"]},"AdminMediaResponse":{"type":"object","description":"Admin view of a media item","properties":{"id":{"type":"integer","format":"int64","description":"Media id"},"name":{"type":"string","description":"Name"},"description":{"type":"string","description":"Description"},"links":{"type":"array","description":"Link","items":{"type":"string"}},"type":{"type":"string","description":"Type","enum":["VIDEO","SERMON","PODCAST","PLAYLIST","FEATURED_VIDEO"]},"createdAt":{"type":"string","format":"date-time","description":"Created at"}}},"ApiResponseAdminMediaResponse":{"type":"object","description":"Standard HC API response wrapper for all endpoints","properties":{"success":{"type":"boolean","description":"Indicates if the request was successful"},"message":{"type":"string","description":"Response message describing the result"},"timestamp":{"type":"string","format":"date-time","description":"Response timestamp"},"data":{"$ref":"#/components/schemas/AdminMediaResponse","description":"Response data payload"}}},"CreateEventRequest":{"type":"object","description":"Event creation details","properties":{"eventName":{"type":"string","description":"Event name","minLength":1},"aboutEvent":{"type":"string","description":"About event","minLength":1},"eventBanner":{"type":"string","format":"binary","description":"Event banner image file"},"eventDateTime":{"type":"string","format":"date-time","description":"Event date and time"},"eventUrl":{"type":"string","description":"Event Url"}},"required":["aboutEvent","eventBanner","eventDateTime","eventName"]},"CreateModuleRequest":{"type":"object","description":"Request to create a new module in a course","properties":{"courseId":{"type":"integer","format":"int64","description":"Course ID to add module to"},"title":{"type":"string","description":"Module title","minLength":1},"order":{"type":"integer","format":"int32","description":"Module order/sequence number","minimum":1}},"required":["courseId","order","title"]},"CreateModulesRequest":{"type":"object","description":"Request to create multiple modules in a course in a specific order","properties":{"courseId":{"type":"integer","format":"int64","description":"Course ID to add modules to"},"modules":{"type":"array","description":"List of modules to create (will be ordered by the order field)","items":{"$ref":"#/components/schemas/ModuleData"},"minItems":1}},"required":["courseId","modules"]},"ModuleData":{"type":"object","description":"Module data for bulk creation","properties":{"title":{"type":"string","description":"Module title"},"order":{"type":"integer","format":"int32","description":"Module order/sequence number","minimum":0}},"required":["order","title"]},"ApiResponseListAdminModuleResponse":{"type":"object","description":"Standard HC API response wrapper for all endpoints","properties":{"success":{"type":"boolean","description":"Indicates if the request was successful"},"message":{"type":"string","description":"Response message describing the result"},"timestamp":{"type":"string","format":"date-time","description":"Response timestamp"},"data":{"type":"array","description":"Response data payload","items":{"$ref":"#/components/schemas/AdminModuleResponse"}}}},"CreateCourseRequest":{"type":"object","description":"Request to create a new course curriculum","properties":{"title":{"type":"string","description":"Course title","minLength":1},"description":{"type":"string","description":"Course description","minLength":1},"image":{"type":"string","format":"binary","description":"Course cover image or GIF file (optional)"}},"required":["description","title"]},"CreateChallengeV2Request":{"type":"object","description":"Request to create a challenge series","properties":{"title":{"type":"string","description":"Challenge series title","minLength":1},"numberOfDays":{"type":"integer","format":"int32","description":"Total number of days in challenge"}},"required":["numberOfDays","title"]},"ApiResponseAdminChallengeSeriesResponse":{"type":"object","description":"Standard HC API response wrapper for all endpoints","properties":{"success":{"type":"boolean","description":"Indicates if the request was successful"},"message":{"type":"string","description":"Response message describing the result"},"timestamp":{"type":"string","format":"date-time","description":"Response timestamp"},"data":{"$ref":"#/components/schemas/AdminChallengeSeriesResponse","description":"Response data payload"}}},"CreateDevotionalV2Request":{"type":"object","description":"Request to create a bible plan","properties":{"title":{"type":"string","description":"Bible plan title","minLength":1},"numberOfDays":{"type":"integer","format":"int32","description":"Total number of days in bible plan"},"thumbnail":{"type":"string","format":"binary","description":"Bible plan thumbnail image file"}},"required":["numberOfDays","title"]},"ApiResponseAdminDevotionalResponse":{"type":"object","description":"Standard HC API response wrapper for all endpoints","properties":{"success":{"type":"boolean","description":"Indicates if the request was successful"},"message":{"type":"string","description":"Response message describing the result"},"timestamp":{"type":"string","format":"date-time","description":"Response timestamp"},"data":{"$ref":"#/components/schemas/AdminDevotionalResponse","description":"Response data payload"}}},"VerifyTwoFactorRequest":{"type":"object","description":"Session ID and verification code","properties":{"sessionId":{"type":"string","description":"Session ID returned from the login initiation step","minLength":1},"code":{"type":"string","description":"One-time code sent to the admin's registered contact","minLength":1}},"required":["code","sessionId"]},"AdminLoginResponse":{"type":"object","description":"Admin login response containing admin details and session information","properties":{"adminId":{"type":"integer","format":"int64","description":"Unique admin ID"},"email":{"type":"string","description":"Admin email address"},"firstName":{"type":"string","description":"Admin first name"},"lastName":{"type":"string","description":"Admin last name"},"phoneNumber":{"type":"string","description":"Admin phone number"},"imageUrl":{"type":"string","description":"Profile image URL, or null if none set"},"requiresPasswordChange":{"type":"boolean","description":"Whether admin needs to change password on first login"},"passwordChangeKey":{"type":"string","description":"Password change key (only present if requiresPasswordChange is true)"},"permissions":{"type":"array","description":"Privilege codes granted by the admin's role","items":{"type":"string"}},"tokens":{"$ref":"#/components/schemas/AuthTokenResponse","description":"Authentication tokens (access and refresh)"}}},"ApiResponseAdminLoginResponse":{"type":"object","description":"Standard HC API response wrapper for all endpoints","properties":{"success":{"type":"boolean","description":"Indicates if the request was successful"},"message":{"type":"string","description":"Response message describing the result"},"timestamp":{"type":"string","format":"date-time","description":"Response timestamp"},"data":{"$ref":"#/components/schemas/AdminLoginResponse","description":"Response data payload"}}},"AdminUpdatePasswordRequest":{"type":"object","description":"Current and new password","properties":{"currentPassword":{"type":"string","description":"The admin's current password","minLength":1},"newPassword":{"type":"string","description":"The new password","maxLength":2147483647,"minLength":8}},"required":["currentPassword","newPassword"]},"AdminSignupRequest":{"type":"object","description":"Admin signup details","properties":{"email":{"type":"string","format":"email","description":"Admin email address","minLength":1},"firstName":{"type":"string","description":"Admin first name","minLength":1},"lastName":{"type":"string","description":"Admin last name","minLength":1},"phoneNumber":{"type":"string","description":"Admin phone number (optional)"},"roleId":{"type":"integer","format":"int64","description":"Role id to grant the new admin (optional; none = no privileges)"}},"required":["email","firstName","lastName"]},"AdminSignupResponse":{"type":"object","description":"Admin signup response containing created admin details and temporary password","properties":{"adminId":{"type":"integer","format":"int64","description":"Unique admin ID"},"email":{"type":"string","description":"Admin email address"},"firstName":{"type":"string","description":"Admin first name"},"lastName":{"type":"string","description":"Admin last name"},"phoneNumber":{"type":"string","description":"Admin phone number"},"temporaryPassword":{"type":"string","description":"Temporary password that must be changed on first login"}}},"ApiResponseAdminSignupResponse":{"type":"object","description":"Standard HC API response wrapper for all endpoints","properties":{"success":{"type":"boolean","description":"Indicates if the request was successful"},"message":{"type":"string","description":"Response message describing the result"},"timestamp":{"type":"string","format":"date-time","description":"Response timestamp"},"data":{"$ref":"#/components/schemas/AdminSignupResponse","description":"Response data payload"}}},"AdminLoginRequest":{"type":"object","description":"Admin login credentials","properties":{"email":{"type":"string","format":"email","description":"Admin email address","minLength":1},"password":{"type":"string","description":"Admin password","minLength":1}},"required":["email","password"]},"AdminLoginInitiateResponse":{"type":"object","description":"Response from the first step of admin login — 2FA code has been sent","properties":{"sessionId":{"type":"string","description":"Session ID to supply when verifying the 2FA code"}}},"ApiResponseAdminLoginInitiateResponse":{"type":"object","description":"Standard HC API response wrapper for all endpoints","properties":{"success":{"type":"boolean","description":"Indicates if the request was successful"},"message":{"type":"string","description":"Response message describing the result"},"timestamp":{"type":"string","format":"date-time","description":"Response timestamp"},"data":{"$ref":"#/components/schemas/AdminLoginInitiateResponse","description":"Response data payload"}}},"ChangePasswordRequest":{"type":"object","description":"Password change request with session ID","properties":{"email":{"type":"string","format":"email","description":"Admin email address","minLength":1},"passwordChangeKey":{"type":"string","description":"Password change key obtained from first login","minLength":1},"newPassword":{"type":"string","description":"New password for the admin account","maxLength":2147483647,"minLength":8}},"required":["email","newPassword","passwordChangeKey"]},"DevotionalImpactRequest":{"type":"object","description":"Request to submit devotional impact feedback","properties":{"devotionalId":{"type":"integer","format":"int64","description":"ID of the devotional"},"impacts":{"type":"array","description":"Selected impact options","items":{"type":"string","enum":["ENCOURAGED_MY_FAITH","GAVE_ME_SOMETHING_TO_REFLECT_ON","REMINDED_ME_OF_GODS_LOVE","LED_ME_TO_PRAY_OR_MEDITATE","HELPED_ME_GROW_SPIRITUALLY"]},"minItems":1,"uniqueItems":true}},"required":["devotionalId","impacts"]},"ApiResponseDevotionalImpactResponse":{"type":"object","description":"Standard HC API response wrapper for all endpoints","properties":{"success":{"type":"boolean","description":"Indicates if the request was successful"},"message":{"type":"string","description":"Response message describing the result"},"timestamp":{"type":"string","format":"date-time","description":"Response timestamp"},"data":{"$ref":"#/components/schemas/DevotionalImpactResponse","description":"Response data payload"}}},"DevotionalImpactResponse":{"type":"object","description":"Devotional impact feedback response","properties":{"devotionalId":{"type":"integer","format":"int64","description":"Devotional ID"},"impacts":{"type":"array","description":"Selected impact options","items":{"type":"string","enum":["ENCOURAGED_MY_FAITH","GAVE_ME_SOMETHING_TO_REFLECT_ON","REMINDED_ME_OF_GODS_LOVE","LED_ME_TO_PRAY_OR_MEDITATE","HELPED_ME_GROW_SPIRITUALLY"]},"uniqueItems":true}}},"ApiResponseChallengeStampResponse":{"type":"object","description":"Standard HC API response wrapper for all endpoints","properties":{"success":{"type":"boolean","description":"Indicates if the request was successful"},"message":{"type":"string","description":"Response message describing the result"},"timestamp":{"type":"string","format":"date-time","description":"Response timestamp"},"data":{"$ref":"#/components/schemas/ChallengeStampResponse","description":"Response data payload"}}},"ChallengeStampResponse":{"type":"object","description":"Indicates whether the user has stamped the challenge for the current day and the stamp timestamp if so","properties":{"stamped":{"type":"boolean","description":"True if the user stamped the challenge today"},"stampedAt":{"type":"string","format":"date-time","description":"The timestamp when the challenge was stamped (present only when stamped = true)"}}},"CreateDailyDevotionalRequest":{"type":"object","description":"Request to create a new daily devotional","properties":{"title":{"type":"string","description":"Title of the devotional"},"devotionalDate":{"type":"string","format":"date","description":"Date of the devotional"},"content":{"type":"string","description":"Devotional content (HTML)","minLength":1},"publishTime":{"type":"string","description":"Time the devotional should be published"},"scriptures":{"type":"array","description":"Scripture references","items":{"type":"string","pattern":"^(?:[1-3]\\s)?[A-Za-z]+(?:\\s[A-Za-z]+)*\\s\\d+(?::\\d+(?:-\\d+)?)?$"},"uniqueItems":true},"scheduled":{"type":"boolean","description":"Whether to publish immediately if date/time is missing"}},"required":["content"]},"CreateChallengeRequest":{"type":"object","description":"Request to create a new challenge","properties":{"challengeName":{"type":"string","description":"Challenge name","minLength":1},"aboutChallenge":{"type":"string","description":"About challenge","minLength":1},"startDate":{"type":"string","format":"date","description":"Challenge start date"},"endDate":{"type":"string","format":"date","description":"Challenge end date"}},"required":["aboutChallenge","challengeName","endDate","startDate"]},"ApiResponsePagedResponseCourseResponse":{"type":"object","description":"Standard HC API response wrapper for all endpoints","properties":{"success":{"type":"boolean","description":"Indicates if the request was successful"},"message":{"type":"string","description":"Response message describing the result"},"timestamp":{"type":"string","format":"date-time","description":"Response timestamp"},"data":{"$ref":"#/components/schemas/PagedResponseCourseResponse","description":"Response data payload"}}},"CourseResponse":{"type":"object","description":"Course details response (user view)","properties":{"id":{"type":"integer","format":"int64","description":"Course ID"},"title":{"type":"string","description":"Course title"},"description":{"type":"string","description":"Course description"},"courseStatus":{"type":"string","description":"Course status","enum":["DRAFT","LIVE"]},"moduleCount":{"type":"integer","format":"int32","description":"Number of modules in the course"},"mediaCount":{"type":"integer","format":"int32","description":"Number of media in the course"},"activityCount":{"type":"integer","format":"int32","description":"Number of activities in the course"},"createdBy":{"type":"string","description":"Full name of admin who created the course"},"dateCreated":{"type":"string","format":"date-time","description":"When the course was created"},"dateModified":{"type":"string","format":"date-time","description":"When the course was last modified"},"imageUrl":{"type":"string","description":"Course cover image or GIF URL, empty if none set"},"enrolled":{"type":"boolean","description":"Whether the current user is enrolled in the course"},"enrollmentProgress":{"type":"string","description":"The current user's enrollment progress (null if not enrolled)","enum":["NOT_STARTED","STARTED","COMPLETED"]},"currentModuleId":{"type":"integer","format":"int64","description":"Current module id (next to complete), null if none"},"currentModuleTitle":{"type":"string","description":"Current module title (next to complete), null if none"},"completionPercentage":{"type":"integer","format":"int32","description":"Completion percentage (0-100), null if not enrolled"},"enrolledAt":{"type":"string","format":"date-time","description":"When the user enrolled, null if not enrolled"},"detailLevel":{"type":"string","description":"Detail level of the response (BASIC for listing, FULL for detailed view)","enum":["BASIC","FULL"]}}},"PagedResponseCourseResponse":{"type":"object","properties":{"totalRecords":{"type":"integer","format":"int64"},"totalPages":{"type":"integer","format":"int64"},"totalAmount":{"type":"number"},"records":{"type":"array","items":{"$ref":"#/components/schemas/CourseResponse"}}}},"ApiResponsePagedResponseTestimonyResponse":{"type":"object","description":"Standard HC API response wrapper for all endpoints","properties":{"success":{"type":"boolean","description":"Indicates if the request was successful"},"message":{"type":"string","description":"Response message describing the result"},"timestamp":{"type":"string","format":"date-time","description":"Response timestamp"},"data":{"$ref":"#/components/schemas/PagedResponseTestimonyResponse","description":"Response data payload"}}},"PagedResponseTestimonyResponse":{"type":"object","properties":{"totalRecords":{"type":"integer","format":"int64"},"totalPages":{"type":"integer","format":"int64"},"totalAmount":{"type":"number"},"records":{"type":"array","items":{"$ref":"#/components/schemas/TestimonyResponse"}}}},"ApiResponsePagedResponseSavedScriptureResponse":{"type":"object","description":"Standard HC API response wrapper for all endpoints","properties":{"success":{"type":"boolean","description":"Indicates if the request was successful"},"message":{"type":"string","description":"Response message describing the result"},"timestamp":{"type":"string","format":"date-time","description":"Response timestamp"},"data":{"$ref":"#/components/schemas/PagedResponseSavedScriptureResponse","description":"Response data payload"}}},"PagedResponseSavedScriptureResponse":{"type":"object","properties":{"totalRecords":{"type":"integer","format":"int64"},"totalPages":{"type":"integer","format":"int64"},"totalAmount":{"type":"number"},"records":{"type":"array","items":{"$ref":"#/components/schemas/SavedScriptureResponse"}}}},"ApiResponseDailyScriptureResponse":{"type":"object","description":"Standard HC API response wrapper for all endpoints","properties":{"success":{"type":"boolean","description":"Indicates if the request was successful"},"message":{"type":"string","description":"Response message describing the result"},"timestamp":{"type":"string","format":"date-time","description":"Response timestamp"},"data":{"$ref":"#/components/schemas/DailyScriptureResponse","description":"Response data payload"}}},"DailyScriptureResponse":{"type":"object","description":"Daily scripture details response (user view)","properties":{"id":{"type":"integer","format":"int64","description":"Scripture ID"},"book":{"type":"string","description":"Bible book name"},"chapter":{"type":"integer","format":"int32","description":"Chapter number"},"verseStart":{"type":"integer","format":"int32","description":"Starting verse number"},"verseEnd":{"type":"integer","format":"int32","description":"Ending verse number"},"text":{"type":"string","description":"Scripture text"}}},"ApiResponseListMilestoneResponse":{"type":"object","description":"Standard HC API response wrapper for all endpoints","properties":{"success":{"type":"boolean","description":"Indicates if the request was successful"},"message":{"type":"string","description":"Response message describing the result"},"timestamp":{"type":"string","format":"date-time","description":"Response timestamp"},"data":{"type":"array","description":"Response data payload","items":{"$ref":"#/components/schemas/MilestoneResponse"}}}},"MilestoneResponse":{"type":"object","description":"A milestone and the authenticated user's unlock status for it","properties":{"milestone":{"type":"string","description":"Milestone identifier","enum":["THREE_DAY_STREAK","SEVEN_DAY_STREAK","THIRTY_DAY_STREAK","NINETY_DAY_STREAK","ONE_HUNDRED_EIGHTY_DAY_STREAK","THREE_HUNDRED_SIXTY_FIVE_DAY_STREAK","COURSE_COMPLETED","THREE_COURSES_COMPLETED"]},"title":{"type":"string","description":"Milestone title"},"description":{"type":"string","description":"Description of how the milestone is unlocked"},"unlocked":{"type":"boolean","description":"Whether the authenticated user has unlocked this milestone"},"unlockedAt":{"type":"string","format":"date-time","description":"When the milestone was unlocked, if applicable"}}},"ApiResponseProfileData":{"type":"object","description":"Standard HC API response wrapper for all endpoints","properties":{"success":{"type":"boolean","description":"Indicates if the request was successful"},"message":{"type":"string","description":"Response message describing the result"},"timestamp":{"type":"string","format":"date-time","description":"Response timestamp"},"data":{"$ref":"#/components/schemas/ProfileData","description":"Response data payload"}}},"ProfileData":{"type":"object","description":"Current user profile data","properties":{"userId":{"type":"integer","format":"int64"},"username":{"type":"string"},"email":{"type":"string"},"firstName":{"type":"string"},"lastName":{"type":"string"},"role":{"type":"string"},"userType":{"type":"string"},"imageUrl":{"type":"string"},"gender":{"type":"string"},"hasCourseInProgress":{"type":"boolean"},"hasChallengeSubscribed":{"type":"boolean"},"phoneNumber":{"type":"string"},"path":{"type":"string","enum":["NEW_CONVERT","REDEDICATION","SEEKING_GROWTH"]},"permissions":{"type":"array","description":"Privilege codes granted by the admin's role (admins only)","items":{"type":"string"}}}},"ApiResponseListTestimonyCategoryResponse":{"type":"object","description":"Standard HC API response wrapper for all endpoints","properties":{"success":{"type":"boolean","description":"Indicates if the request was successful"},"message":{"type":"string","description":"Response message describing the result"},"timestamp":{"type":"string","format":"date-time","description":"Response timestamp"},"data":{"type":"array","description":"Response data payload","items":{"$ref":"#/components/schemas/TestimonyCategoryResponse"}}}},"TestimonyCategoryResponse":{"type":"object","description":"Response representing a testimony category (code and display value)","properties":{"code":{"type":"string","description":"Code"},"value":{"type":"string","description":"Valude"}}},"ApiResponseListHCPathResponse":{"type":"object","description":"Standard HC API response wrapper for all endpoints","properties":{"success":{"type":"boolean","description":"Indicates if the request was successful"},"message":{"type":"string","description":"Response message describing the result"},"timestamp":{"type":"string","format":"date-time","description":"Response timestamp"},"data":{"type":"array","description":"Response data payload","items":{"$ref":"#/components/schemas/HCPathResponse"}}}},"HCPathResponse":{"type":"object","description":"Response representing an HC path with display text, description and key","properties":{"path":{"type":"string","description":"Display name of the path (e.g. 'New Convert')"},"description":{"type":"string","description":"Detailed description of the path"},"key":{"type":"string","description":"Machine key / enum name for the path (e.g. NEW_CONVERT)"}}},"ApiResponseListMediaTypeResponse":{"type":"object","description":"Standard HC API response wrapper for all endpoints","properties":{"success":{"type":"boolean","description":"Indicates if the request was successful"},"message":{"type":"string","description":"Response message describing the result"},"timestamp":{"type":"string","format":"date-time","description":"Response timestamp"},"data":{"type":"array","description":"Response data payload","items":{"$ref":"#/components/schemas/MediaTypeResponse"}}}},"MediaTypeResponse":{"type":"object","description":"Response representing a media type (code and display value)","properties":{"code":{"type":"string","description":"M (e.g. VIDEO)"},"value":{"type":"string","description":"Display value for UI (e.g. Video)"}}},"ApiResponseListCountryResponse":{"type":"object","description":"Standard HC API response wrapper for all endpoints","properties":{"success":{"type":"boolean","description":"Indicates if the request was successful"},"message":{"type":"string","description":"Response message describing the result"},"timestamp":{"type":"string","format":"date-time","description":"Response timestamp"},"data":{"type":"array","description":"Response data payload","items":{"$ref":"#/components/schemas/CountryResponse"}}}},"CountryResponse":{"type":"object","description":"Country response DTO","properties":{"id":{"type":"integer","format":"int64","description":"Country id"},"name":{"type":"string","description":"Country name"},"dialingCode":{"type":"string","description":"Dialing code"},"code":{"type":"string","description":"ISO country code"},"flagUrl":{"type":"string","description":"URL to the country flag"}}},"ApiResponseListProvinceResponse":{"type":"object","description":"Standard HC API response wrapper for all endpoints","properties":{"success":{"type":"boolean","description":"Indicates if the request was successful"},"message":{"type":"string","description":"Response message describing the result"},"timestamp":{"type":"string","format":"date-time","description":"Response timestamp"},"data":{"type":"array","description":"Response data payload","items":{"$ref":"#/components/schemas/ProvinceResponse"}}}},"ProvinceResponse":{"type":"object","description":"Province response DTO","properties":{"name":{"type":"string","description":"Province name"},"isoCode":{"type":"string","description":"ISO code for the province"},"id":{"type":"integer","format":"int64","description":"Province id"}}},"ApiResponsePagedResponseAdminMediaResponse":{"type":"object","description":"Standard HC API response wrapper for all endpoints","properties":{"success":{"type":"boolean","description":"Indicates if the request was successful"},"message":{"type":"string","description":"Response message describing the result"},"timestamp":{"type":"string","format":"date-time","description":"Response timestamp"},"data":{"$ref":"#/components/schemas/PagedResponseAdminMediaResponse","description":"Response data payload"}}},"PagedResponseAdminMediaResponse":{"type":"object","properties":{"totalRecords":{"type":"integer","format":"int64"},"totalPages":{"type":"integer","format":"int64"},"totalAmount":{"type":"number"},"records":{"type":"array","items":{"$ref":"#/components/schemas/AdminMediaResponse"}}}},"ApiResponsePagedResponseEventResponse":{"type":"object","description":"Standard HC API response wrapper for all endpoints","properties":{"success":{"type":"boolean","description":"Indicates if the request was successful"},"message":{"type":"string","description":"Response message describing the result"},"timestamp":{"type":"string","format":"date-time","description":"Response timestamp"},"data":{"$ref":"#/components/schemas/PagedResponseEventResponse","description":"Response data payload"}}},"PagedResponseEventResponse":{"type":"object","properties":{"totalRecords":{"type":"integer","format":"int64"},"totalPages":{"type":"integer","format":"int64"},"totalAmount":{"type":"number"},"records":{"type":"array","items":{"$ref":"#/components/schemas/EventResponse"}}}},"ApiResponseListEventMonthlyCountResponse":{"type":"object","description":"Standard HC API response wrapper for all endpoints","properties":{"success":{"type":"boolean","description":"Indicates if the request was successful"},"message":{"type":"string","description":"Response message describing the result"},"timestamp":{"type":"string","format":"date-time","description":"Response timestamp"},"data":{"type":"array","description":"Response data payload","items":{"$ref":"#/components/schemas/EventMonthlyCountResponse"}}}},"EventMonthlyCountResponse":{"type":"object","description":"Event count for a specific month","properties":{"year":{"type":"integer","format":"int32","description":"Year (e.g. 2026)"},"month":{"type":"integer","format":"int32","description":"Month number (1-12)"},"monthLabel":{"type":"string","description":"Human-readable month label, e.g. 'March 2026'"},"count":{"type":"integer","format":"int64","description":"Number of events in this month"}}},"ApiResponseWondersDevotionalResponse":{"type":"object","description":"Standard HC API response wrapper for all endpoints","properties":{"success":{"type":"boolean","description":"Indicates if the request was successful"},"message":{"type":"string","description":"Response message describing the result"},"timestamp":{"type":"string","format":"date-time","description":"Response timestamp"},"data":{"$ref":"#/components/schemas/WondersDevotionalResponse","description":"Response data payload"}}},"WondersDevotionalResponse":{"type":"object","description":"Devotional entry sourced from the Wonders API for a given day and month","properties":{"id":{"type":"string","description":"Devotional entry ID"},"title":{"type":"string","description":"Devotional title"},"description":{"type":"string","description":"Devotional description/body"},"image_url":{"type":"string","description":"Devotional image URL"},"verse_text":{"type":"string","description":"Bible verse text"},"verse_reference":{"type":"string","description":"Bible verse reference"}}},"ApiResponseCourseResponse":{"type":"object","description":"Standard HC API response wrapper for all endpoints","properties":{"success":{"type":"boolean","description":"Indicates if the request was successful"},"message":{"type":"string","description":"Response message describing the result"},"timestamp":{"type":"string","format":"date-time","description":"Response timestamp"},"data":{"$ref":"#/components/schemas/CourseResponse","description":"Response data payload"}}},"ActivityResponse":{"type":"object","description":"Course activity details response (user view)","properties":{"id":{"type":"integer","format":"int64","description":"Activity ID"},"moduleId":{"type":"integer","format":"int64","description":"Module ID"},"content":{"type":"string","description":"Activity content"},"order":{"type":"integer","format":"int32","description":"Activity order/sequence number"},"createdBy":{"type":"string","description":"Full name of admin who created the activity"},"dateCreated":{"type":"string","format":"date-time","description":"When the activity was created"},"completed":{"type":"boolean","description":"Whether the user has completed the activity"}}},"ApiResponseListModuleResponse":{"type":"object","description":"Standard HC API response wrapper for all endpoints","properties":{"success":{"type":"boolean","description":"Indicates if the request was successful"},"message":{"type":"string","description":"Response message describing the result"},"timestamp":{"type":"string","format":"date-time","description":"Response timestamp"},"data":{"type":"array","description":"Response data payload","items":{"$ref":"#/components/schemas/ModuleResponse"}}}},"ModuleResponse":{"type":"object","description":"Module details response (user view)","properties":{"id":{"type":"integer","format":"int64","description":"Module ID"},"courseId":{"type":"integer","format":"int64","description":"Course ID"},"title":{"type":"string","description":"Module title"},"content":{"type":"string","description":"Module HTML content"},"mediaLinks":{"type":"array","description":"Media links (videos, images, documents)","items":{"type":"string"}},"order":{"type":"integer","format":"int32","description":"Module order/sequence number"},"activities":{"type":"array","description":"Module activities","items":{"$ref":"#/components/schemas/ActivityResponse"}},"hasContent":{"type":"boolean","description":"Has content been added"},"createdBy":{"type":"string","description":"Full name of admin who created the module"},"dateCreated":{"type":"string","format":"date-time","description":"When the module was created"},"previousModuleId":{"type":"integer","format":"int64","description":"ID of the previous module in the course, null if this is the first"},"nextModuleId":{"type":"integer","format":"int64","description":"ID of the next module in the course, null if this is the last"},"status":{"type":"string","description":"User's progress status for this module: NOT_STARTED, STARTED, or COMPLETED","enum":["NOT_STARTED","STARTED","COMPLETED"]}}},"ApiResponseModuleResponse":{"type":"object","description":"Standard HC API response wrapper for all endpoints","properties":{"success":{"type":"boolean","description":"Indicates if the request was successful"},"message":{"type":"string","description":"Response message describing the result"},"timestamp":{"type":"string","format":"date-time","description":"Response timestamp"},"data":{"$ref":"#/components/schemas/ModuleResponse","description":"Response data payload"}}},"ApiResponsePagedResponseChallengeV2ListItemResponse":{"type":"object","description":"Standard HC API response wrapper for all endpoints","properties":{"success":{"type":"boolean","description":"Indicates if the request was successful"},"message":{"type":"string","description":"Response message describing the result"},"timestamp":{"type":"string","format":"date-time","description":"Response timestamp"},"data":{"$ref":"#/components/schemas/PagedResponseChallengeV2ListItemResponse","description":"Response data payload"}}},"ChallengeV2ListItemResponse":{"type":"object","description":"Challenge v2 list item with user participation","properties":{"id":{"type":"integer","format":"int64","description":"Challenge ID"},"title":{"type":"string","description":"Challenge title"},"numberOfDays":{"type":"integer","format":"int32","description":"Total number of days"},"participation":{"$ref":"#/components/schemas/ChallengeV2ParticipationResponse","description":"User participation details"},"imageUrls":{"type":"array","description":"Profile image URLs of up to 3 random subscribers","items":{"type":"string"}},"subscriberCount":{"type":"integer","format":"int32","description":"Number of subscribers (>=0)"}}},"ChallengeV2ParticipationResponse":{"type":"object","description":"User participation metadata for a challenge v2","properties":{"status":{"type":"string","description":"Participation status","enum":["NOT_SUBSCRIBED","SUBSCRIBED","STARTED","COMPLETED"]},"startDate":{"type":"string","format":"date","description":"Date user started this challenge"},"nextDayNumber":{"type":"integer","format":"int32","description":"Next day the user should complete"}}},"PagedResponseChallengeV2ListItemResponse":{"type":"object","properties":{"totalRecords":{"type":"integer","format":"int64"},"totalPages":{"type":"integer","format":"int64"},"totalAmount":{"type":"number"},"records":{"type":"array","items":{"$ref":"#/components/schemas/ChallengeV2ListItemResponse"}}}},"ApiResponseChapterFile":{"type":"object","description":"Standard HC API response wrapper for all endpoints","properties":{"success":{"type":"boolean","description":"Indicates if the request was successful"},"message":{"type":"string","description":"Response message describing the result"},"timestamp":{"type":"string","format":"date-time","description":"Response timestamp"},"data":{"$ref":"#/components/schemas/ChapterFile","description":"Response data payload"}}},"ChapterFile":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Verse"}}}},"Verse":{"type":"object","properties":{"book":{"type":"string"},"chapter":{"type":"string"},"verse":{"type":"string"},"text":{"type":"string"}}},"ApiResponseChaptersResponse":{"type":"object","description":"Standard HC API response wrapper for all endpoints","properties":{"success":{"type":"boolean","description":"Indicates if the request was successful"},"message":{"type":"string","description":"Response message describing the result"},"timestamp":{"type":"string","format":"date-time","description":"Response timestamp"},"data":{"$ref":"#/components/schemas/ChaptersResponse","description":"Response data payload"}}},"ChaptersResponse":{"type":"object","properties":{"count":{"type":"integer","format":"int32"},"chapters":{"type":"array","items":{"type":"integer","format":"int32"}}}},"ApiResponseListBookInfo":{"type":"object","description":"Standard HC API response wrapper for all endpoints","properties":{"success":{"type":"boolean","description":"Indicates if the request was successful"},"message":{"type":"string","description":"Response message describing the result"},"timestamp":{"type":"string","format":"date-time","description":"Response timestamp"},"data":{"type":"array","description":"Response data payload","items":{"$ref":"#/components/schemas/BookInfo"}}}},"BookInfo":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}}},"ApiResponseListBibleVersion":{"type":"object","description":"Standard HC API response wrapper for all endpoints","properties":{"success":{"type":"boolean","description":"Indicates if the request was successful"},"message":{"type":"string","description":"Response message describing the result"},"timestamp":{"type":"string","format":"date-time","description":"Response timestamp"},"data":{"type":"array","description":"Response data payload","items":{"$ref":"#/components/schemas/BibleVersion"}}}},"BibleVersion":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"englishName":{"type":"string"},"website":{"type":"string"},"licenseUrl":{"type":"string"},"language":{"type":"string"},"languageName":{"type":"string"},"languageEnglishName":{"type":"string"},"textDirection":{"type":"string"},"numberOfBooks":{"type":"integer","format":"int32"},"totalNumberOfChapters":{"type":"integer","format":"int32"},"totalNumberOfVerses":{"type":"integer","format":"int32"}}},"ApiResponseListTopOpening":{"type":"object","description":"Standard HC API response wrapper for all endpoints","properties":{"success":{"type":"boolean","description":"Indicates if the request was successful"},"message":{"type":"string","description":"Response message describing the result"},"timestamp":{"type":"string","format":"date-time","description":"Response timestamp"},"data":{"type":"array","description":"Response data payload","items":{"$ref":"#/components/schemas/TopOpening"}}}},"TopOpening":{"type":"object","properties":{"reference":{"type":"string"},"count":{"type":"integer","format":"int32"}}},"ApiResponseListSearchResult":{"type":"object","description":"Standard HC API response wrapper for all endpoints","properties":{"success":{"type":"boolean","description":"Indicates if the request was successful"},"message":{"type":"string","description":"Response message describing the result"},"timestamp":{"type":"string","format":"date-time","description":"Response timestamp"},"data":{"type":"array","description":"Response data payload","items":{"$ref":"#/components/schemas/SearchResult"}}}},"SearchResult":{"type":"object","properties":{"version":{"type":"string"},"book":{"type":"string"},"chapter":{"type":"string"},"verse":{"type":"string"},"text":{"type":"string"}}},"ApiResponseListBibleLanguage":{"type":"object","description":"Standard HC API response wrapper for all endpoints","properties":{"success":{"type":"boolean","description":"Indicates if the request was successful"},"message":{"type":"string","description":"Response message describing the result"},"timestamp":{"type":"string","format":"date-time","description":"Response timestamp"},"data":{"type":"array","description":"Response data payload","items":{"$ref":"#/components/schemas/BibleLanguage"}}}},"BibleLanguage":{"type":"object","properties":{"code":{"type":"string"},"name":{"type":"string"},"englishName":{"type":"string"},"textDirection":{"type":"string"},"versionCount":{"type":"integer","format":"int32"}}},"ApiResponsePagedResponseDevotionalV2ListItemResponse":{"type":"object","description":"Standard HC API response wrapper for all endpoints","properties":{"success":{"type":"boolean","description":"Indicates if the request was successful"},"message":{"type":"string","description":"Response message describing the result"},"timestamp":{"type":"string","format":"date-time","description":"Response timestamp"},"data":{"$ref":"#/components/schemas/PagedResponseDevotionalV2ListItemResponse","description":"Response data payload"}}},"DevotionalV2ListItemResponse":{"type":"object","description":"Bible plan list item with user participation","properties":{"id":{"type":"integer","format":"int64","description":"Bible plan ID"},"title":{"type":"string","description":"Bible plan title"},"thumbnailUrl":{"type":"string","description":"Thumbnail image URL"},"numberOfDays":{"type":"integer","format":"int32","description":"Total number of days"},"participation":{"$ref":"#/components/schemas/DevotionalV2ParticipationResponse","description":"User participation details"}}},"PagedResponseDevotionalV2ListItemResponse":{"type":"object","properties":{"totalRecords":{"type":"integer","format":"int64"},"totalPages":{"type":"integer","format":"int64"},"totalAmount":{"type":"number"},"records":{"type":"array","items":{"$ref":"#/components/schemas/DevotionalV2ListItemResponse"}}}},"ApiResponseDevotionalV2DetailResponse":{"type":"object","description":"Standard HC API response wrapper for all endpoints","properties":{"success":{"type":"boolean","description":"Indicates if the request was successful"},"message":{"type":"string","description":"Response message describing the result"},"timestamp":{"type":"string","format":"date-time","description":"Response timestamp"},"data":{"$ref":"#/components/schemas/DevotionalV2DetailResponse","description":"Response data payload"}}},"DevotionalV2DetailResponse":{"type":"object","description":"Bible plan with all day items (user view)","properties":{"devotional":{"$ref":"#/components/schemas/DevotionalV2ListItemResponse","description":"Bible plan metadata"},"items":{"type":"array","description":"Day items sorted by day number","items":{"$ref":"#/components/schemas/DevotionalV2ItemResponse"}}}},"DevotionalV2ItemResponse":{"type":"object","description":"Bible plan item details response (user view)","properties":{"id":{"type":"integer","format":"int64","description":"Bible plan item ID"},"dayNumber":{"type":"integer","format":"int32","description":"Day number"},"title":{"type":"string","description":"Bible plan item title"},"content":{"type":"string","description":"Bible plan item content"},"bibleReferences":{"type":"array","description":"Bible references","items":{"$ref":"#/components/schemas/BibleReferenceDto"}},"completed":{"type":"boolean","description":"Whether the current user has marked this day complete"}}},"ApiResponsePagedResponseAdminTestimonyResponse":{"type":"object","description":"Standard HC API response wrapper for all endpoints","properties":{"success":{"type":"boolean","description":"Indicates if the request was successful"},"message":{"type":"string","description":"Response message describing the result"},"timestamp":{"type":"string","format":"date-time","description":"Response timestamp"},"data":{"$ref":"#/components/schemas/PagedResponseAdminTestimonyResponse","description":"Response data payload"}}},"PagedResponseAdminTestimonyResponse":{"type":"object","properties":{"totalRecords":{"type":"integer","format":"int64"},"totalPages":{"type":"integer","format":"int64"},"totalAmount":{"type":"number"},"records":{"type":"array","items":{"$ref":"#/components/schemas/AdminTestimonyResponse"}}}},"ApiResponsePagedResponseAdminDailyScriptureResponse":{"type":"object","description":"Standard HC API response wrapper for all endpoints","properties":{"success":{"type":"boolean","description":"Indicates if the request was successful"},"message":{"type":"string","description":"Response message describing the result"},"timestamp":{"type":"string","format":"date-time","description":"Response timestamp"},"data":{"$ref":"#/components/schemas/PagedResponseAdminDailyScriptureResponse","description":"Response data payload"}}},"PagedResponseAdminDailyScriptureResponse":{"type":"object","properties":{"totalRecords":{"type":"integer","format":"int64"},"totalPages":{"type":"integer","format":"int64"},"totalAmount":{"type":"number"},"records":{"type":"array","items":{"$ref":"#/components/schemas/AdminDailyScriptureResponse"}}}},"ApiResponseListRoleResponse":{"type":"object","description":"Standard HC API response wrapper for all endpoints","properties":{"success":{"type":"boolean","description":"Indicates if the request was successful"},"message":{"type":"string","description":"Response message describing the result"},"timestamp":{"type":"string","format":"date-time","description":"Response timestamp"},"data":{"type":"array","description":"Response data payload","items":{"$ref":"#/components/schemas/RoleResponse"}}}},"ApiResponseListPrivilegeResponse":{"type":"object","description":"Standard HC API response wrapper for all endpoints","properties":{"success":{"type":"boolean","description":"Indicates if the request was successful"},"message":{"type":"string","description":"Response message describing the result"},"timestamp":{"type":"string","format":"date-time","description":"Response timestamp"},"data":{"type":"array","description":"Response data payload","items":{"$ref":"#/components/schemas/PrivilegeResponse"}}}},"AdminRoleResponse":{"type":"object","description":"The role held by an admin (if any) and its effective privileges","properties":{"adminId":{"type":"integer","format":"int64","description":"Admin id"},"role":{"$ref":"#/components/schemas/RoleResponse","description":"Role held by this admin, or null if none assigned"},"privileges":{"type":"array","description":"Privilege codes granted by the role","items":{"type":"string"}}}},"ApiResponseAdminRoleResponse":{"type":"object","description":"Standard HC API response wrapper for all endpoints","properties":{"success":{"type":"boolean","description":"Indicates if the request was successful"},"message":{"type":"string","description":"Response message describing the result"},"timestamp":{"type":"string","format":"date-time","description":"Response timestamp"},"data":{"$ref":"#/components/schemas/AdminRoleResponse","description":"Response data payload"}}},"ApiResponseDashboardUser":{"type":"object","description":"Standard HC API response wrapper for all endpoints","properties":{"success":{"type":"boolean","description":"Indicates if the request was successful"},"message":{"type":"string","description":"Response message describing the result"},"timestamp":{"type":"string","format":"date-time","description":"Response timestamp"},"data":{"$ref":"#/components/schemas/DashboardUser","description":"Response data payload"}}},"DashboardUser":{"type":"object","description":"Dashboard user list item","properties":{"id":{"type":"integer","format":"int64","description":"User id"},"fullName":{"type":"string","description":"User full name"},"username":{"type":"string","description":"Username"},"email":{"type":"string","description":"Email address"},"imageUrl":{"type":"string","description":"Profile image URL"},"status":{"type":"string","description":"Profile Status"},"phoneNumber":{"type":"string","description":"Profile Phone"},"address":{"$ref":"#/components/schemas/AddressResponse","description":"Full address object"},"gender":{"type":"string","description":"Gender"},"dateJoined":{"type":"string","format":"date","description":"When the user joined"}}},"ApiResponseUserCourseActivity":{"type":"object","description":"Standard HC API response wrapper for all endpoints","properties":{"success":{"type":"boolean","description":"Indicates if the request was successful"},"message":{"type":"string","description":"Response message describing the result"},"timestamp":{"type":"string","format":"date-time","description":"Response timestamp"},"data":{"$ref":"#/components/schemas/UserCourseActivity","description":"Response data payload"}}},"UserCourseActivity":{"type":"object","description":"User course activity summary","properties":{"coursesStarted":{"type":"integer","format":"int64","description":"Number of courses started by the user"},"coursesCompleted":{"type":"integer","format":"int64","description":"Number of courses completed by the user"},"courseDetails":{"type":"array","description":"List of course details for the user","items":{"$ref":"#/components/schemas/UserCourseDetail"}}}},"UserCourseDetail":{"type":"object","description":"User course details for a single course enrollment","properties":{"courseId":{"type":"integer","format":"int64","description":"Course ID"},"courseTitle":{"type":"string","description":"Course title"},"startedDate":{"type":"string","format":"date","description":"Date when user enrolled in the course"},"status":{"type":"string","description":"Course enrollment status: NOT_STARTED, STARTED, COMPLETED"},"lastActivityAt":{"type":"string","format":"date-time","description":"Last activity timestamp for this course"}}},"ApiResponseUserChallengeActivity":{"type":"object","description":"Standard HC API response wrapper for all endpoints","properties":{"success":{"type":"boolean","description":"Indicates if the request was successful"},"message":{"type":"string","description":"Response message describing the result"},"timestamp":{"type":"string","format":"date-time","description":"Response timestamp"},"data":{"$ref":"#/components/schemas/UserChallengeActivity","description":"Response data payload"}}},"UserChallengeActivity":{"type":"object","description":"User challenge activity summary","properties":{"challengesStarted":{"type":"integer","format":"int64","description":"Number of challenges started by the user"},"challengesCompleted":{"type":"integer","format":"int64","description":"Number of challenges completed by the user"},"challengeDetails":{"type":"array","description":"List of challenge participation details for the user","items":{"$ref":"#/components/schemas/UserChallengeDetail"}}}},"UserChallengeDetail":{"type":"object","description":"Challenge participation detail for a single challenge","properties":{"challengeId":{"type":"integer","format":"int64","description":"Challenge ID"},"title":{"type":"string","description":"Challenge title"},"numberOfDays":{"type":"integer","format":"int32","description":"Total number of days in the challenge"},"challengeStatus":{"type":"string","description":"Challenge status: DRAFT, LIVE"},"participationStatus":{"type":"string","description":"Participation status: STARTED, COMPLETED"},"startDate":{"type":"string","format":"date","description":"Date the user started the challenge"},"nextDayNumber":{"type":"integer","format":"int32","description":"Next day number the user should complete (null if completed)"},"daysCompleted":{"type":"integer","format":"int64","description":"Number of days the user has completed"},"progressPercentage":{"type":"number","format":"double","description":"Progress percentage (0-100)"}}},"ApiResponseMembersSummary":{"type":"object","description":"Standard HC API response wrapper for all endpoints","properties":{"success":{"type":"boolean","description":"Indicates if the request was successful"},"message":{"type":"string","description":"Response message describing the result"},"timestamp":{"type":"string","format":"date-time","description":"Response timestamp"},"data":{"$ref":"#/components/schemas/MembersSummary","description":"Response data payload"}}},"MembersSummary":{"type":"object","description":"Total, active and inactive member counts","properties":{"total":{"type":"integer","format":"int64","description":"Total number of members registered in the date range"},"active":{"type":"integer","format":"int64","description":"Number of active members"},"inactive":{"type":"integer","format":"int64","description":"Number of inactive members"}}},"ApiResponseListRecentMember":{"type":"object","description":"Standard HC API response wrapper for all endpoints","properties":{"success":{"type":"boolean","description":"Indicates if the request was successful"},"message":{"type":"string","description":"Response message describing the result"},"timestamp":{"type":"string","format":"date-time","description":"Response timestamp"},"data":{"type":"array","description":"Response data payload","items":{"$ref":"#/components/schemas/RecentMember"}}}},"RecentMember":{"type":"object","description":"Basic member details for the recent-members list","properties":{"id":{"type":"integer","format":"int64"},"firstName":{"type":"string"},"lastName":{"type":"string"},"username":{"type":"string"},"email":{"type":"string"},"dateCreated":{"type":"string","format":"date"},"recordStatus":{"type":"string"},"path":{"type":"string"},"imageUrl":{"type":"string"},"address":{"type":"string"}}},"ApiResponsePagedResponseDashboardUser":{"type":"object","description":"Standard HC API response wrapper for all endpoints","properties":{"success":{"type":"boolean","description":"Indicates if the request was successful"},"message":{"type":"string","description":"Response message describing the result"},"timestamp":{"type":"string","format":"date-time","description":"Response timestamp"},"data":{"$ref":"#/components/schemas/PagedResponseDashboardUser","description":"Response data payload"}}},"PagedResponseDashboardUser":{"type":"object","properties":{"totalRecords":{"type":"integer","format":"int64"},"totalPages":{"type":"integer","format":"int64"},"totalAmount":{"type":"number"},"records":{"type":"array","items":{"$ref":"#/components/schemas/DashboardUser"}}}},"ApiResponseListGenderCount":{"type":"object","description":"Standard HC API response wrapper for all endpoints","properties":{"success":{"type":"boolean","description":"Indicates if the request was successful"},"message":{"type":"string","description":"Response message describing the result"},"timestamp":{"type":"string","format":"date-time","description":"Response timestamp"},"data":{"type":"array","description":"Response data payload","items":{"$ref":"#/components/schemas/GenderCount"}}}},"GenderCount":{"type":"object","description":"Member count for a specific gender","properties":{"gender":{"type":"string","description":"Gender value: MALE, FEMALE or UNKNOWN"},"count":{"type":"integer","format":"int64","description":"Number of members with this gender"}}},"ApiResponseListCountryCount":{"type":"object","description":"Standard HC API response wrapper for all endpoints","properties":{"success":{"type":"boolean","description":"Indicates if the request was successful"},"message":{"type":"string","description":"Response message describing the result"},"timestamp":{"type":"string","format":"date-time","description":"Response timestamp"},"data":{"type":"array","description":"Response data payload","items":{"$ref":"#/components/schemas/CountryCount"}}}},"CountryCount":{"type":"object","description":"Member count for a specific country","properties":{"countryName":{"type":"string","description":"Country name"},"countryCode":{"type":"string","description":"ISO country code"},"flagUrl":{"type":"string","description":"Country flag URL"},"count":{"type":"integer","format":"int64","description":"Number of members from this country"}}},"ApiResponsePagedResponseCountryCount":{"type":"object","description":"Standard HC API response wrapper for all endpoints","properties":{"success":{"type":"boolean","description":"Indicates if the request was successful"},"message":{"type":"string","description":"Response message describing the result"},"timestamp":{"type":"string","format":"date-time","description":"Response timestamp"},"data":{"$ref":"#/components/schemas/PagedResponseCountryCount","description":"Response data payload"}}},"PagedResponseCountryCount":{"type":"object","properties":{"totalRecords":{"type":"integer","format":"int64"},"totalPages":{"type":"integer","format":"int64"},"totalAmount":{"type":"number"},"records":{"type":"array","items":{"$ref":"#/components/schemas/CountryCount"}}}},"ApiResponsePagedResponseDashboardCourseEnrollment":{"type":"object","description":"Standard HC API response wrapper for all endpoints","properties":{"success":{"type":"boolean","description":"Indicates if the request was successful"},"message":{"type":"string","description":"Response message describing the result"},"timestamp":{"type":"string","format":"date-time","description":"Response timestamp"},"data":{"$ref":"#/components/schemas/PagedResponseDashboardCourseEnrollment","description":"Response data payload"}}},"DashboardCourseEnrollment":{"type":"object","description":"Dashboard member course enrollment row","properties":{"userId":{"type":"integer","format":"int64","description":"User id for 'view user' action"},"courseId":{"type":"integer","format":"int64","description":"Course id"},"memberName":{"type":"string","description":"Member full name"},"memberEmail":{"type":"string","description":"Member email"},"memberImageUrl":{"type":"string","description":"Member avatar image URL"},"courseTitle":{"type":"string","description":"Course title"},"courseDescription":{"type":"string","description":"Course description"},"startedDate":{"type":"string","format":"date","description":"Enrollment start date"},"status":{"type":"string","description":"Enrollment status: NOT_STARTED, STARTED, COMPLETED"},"lastActivityAt":{"type":"string","format":"date-time","description":"Last learning activity timestamp"}}},"PagedResponseDashboardCourseEnrollment":{"type":"object","properties":{"totalRecords":{"type":"integer","format":"int64"},"totalPages":{"type":"integer","format":"int64"},"totalAmount":{"type":"number"},"records":{"type":"array","items":{"$ref":"#/components/schemas/DashboardCourseEnrollment"}}}},"ApiResponseListPathEnrollmentCount":{"type":"object","description":"Standard HC API response wrapper for all endpoints","properties":{"success":{"type":"boolean","description":"Indicates if the request was successful"},"message":{"type":"string","description":"Response message describing the result"},"timestamp":{"type":"string","format":"date-time","description":"Response timestamp"},"data":{"type":"array","description":"Response data payload","items":{"$ref":"#/components/schemas/PathEnrollmentCount"}}}},"PathEnrollmentCount":{"type":"object","description":"Enrolled-user count for a specific HC path","properties":{"path":{"type":"string","description":"HC path name"},"count":{"type":"integer","format":"int64","description":"Number of distinct users enrolled in at least one course on this path"}}},"ApiResponseChallengeParticipationStats":{"type":"object","description":"Standard HC API response wrapper for all endpoints","properties":{"success":{"type":"boolean","description":"Indicates if the request was successful"},"message":{"type":"string","description":"Response message describing the result"},"timestamp":{"type":"string","format":"date-time","description":"Response timestamp"},"data":{"$ref":"#/components/schemas/ChallengeParticipationStats","description":"Response data payload"}}},"ChallengeParticipationStats":{"type":"object","description":"Challenge participation stats","properties":{"distinctParticipants":{"type":"integer","format":"int64","description":"Distinct number of users who joined at least one challenge"},"totalMembers":{"type":"integer","format":"int64","description":"Total number of active app users"},"participationPercentage":{"type":"number","format":"double","description":"Percentage of active users who joined a challenge (0-100)"}}},"ApiResponsePagedResponseDashboardChallengeEnrollment":{"type":"object","description":"Standard HC API response wrapper for all endpoints","properties":{"success":{"type":"boolean","description":"Indicates if the request was successful"},"message":{"type":"string","description":"Response message describing the result"},"timestamp":{"type":"string","format":"date-time","description":"Response timestamp"},"data":{"$ref":"#/components/schemas/PagedResponseDashboardChallengeEnrollment","description":"Response data payload"}}},"DashboardChallengeEnrollment":{"type":"object","description":"Dashboard member challenge enrollment row","properties":{"userId":{"type":"integer","format":"int64","description":"User id for 'view user' action"},"challengeId":{"type":"integer","format":"int64","description":"Challenge id"},"memberName":{"type":"string","description":"Member full name"},"memberEmail":{"type":"string","description":"Member email"},"memberImageUrl":{"type":"string","description":"Member avatar image URL"},"challengeTitle":{"type":"string","description":"Challenge title"},"numberOfDays":{"type":"integer","format":"int32","description":"Number of challenge days"},"challengeStatus":{"type":"string","description":"Challenge status: DRAFT, LIVE"},"status":{"type":"string","description":"Participation status: STARTED, COMPLETED"},"startedDate":{"type":"string","format":"date","description":"Challenge start date"},"daysCompleted":{"type":"integer","format":"int64","description":"Number of days completed"},"progressPercentage":{"type":"number","format":"double","description":"Challenge completion percentage (0-100)"},"lastActivityAt":{"type":"string","format":"date-time","description":"Last challenge activity timestamp"}}},"PagedResponseDashboardChallengeEnrollment":{"type":"object","properties":{"totalRecords":{"type":"integer","format":"int64"},"totalPages":{"type":"integer","format":"int64"},"totalAmount":{"type":"number"},"records":{"type":"array","items":{"$ref":"#/components/schemas/DashboardChallengeEnrollment"}}}},"ApiResponseChallengeCompletionStats":{"type":"object","description":"Standard HC API response wrapper for all endpoints","properties":{"success":{"type":"boolean","description":"Indicates if the request was successful"},"message":{"type":"string","description":"Response message describing the result"},"timestamp":{"type":"string","format":"date-time","description":"Response timestamp"},"data":{"$ref":"#/components/schemas/ChallengeCompletionStats","description":"Response data payload"}}},"ChallengeCompletionStats":{"type":"object","description":"Challenge subscription completion stats","properties":{"totalSubscribed":{"type":"integer","format":"int64","description":"Total number of users subscribed to a challenge"},"totalCompleted":{"type":"integer","format":"int64","description":"Number of users who completed the full challenge (stamped every day)"},"completionPercentage":{"type":"number","format":"double","description":"Completion percentage of subscribed users (0-100)"}}},"ApiResponsePagedResponseAdminCourseResponse":{"type":"object","description":"Standard HC API response wrapper for all endpoints","properties":{"success":{"type":"boolean","description":"Indicates if the request was successful"},"message":{"type":"string","description":"Response message describing the result"},"timestamp":{"type":"string","format":"date-time","description":"Response timestamp"},"data":{"$ref":"#/components/schemas/PagedResponseAdminCourseResponse","description":"Response data payload"}}},"PagedResponseAdminCourseResponse":{"type":"object","properties":{"totalRecords":{"type":"integer","format":"int64"},"totalPages":{"type":"integer","format":"int64"},"totalAmount":{"type":"number"},"records":{"type":"array","items":{"$ref":"#/components/schemas/AdminCourseResponse"}}}},"ApiResponsePagedResponseAdminChallengeSeriesResponse":{"type":"object","description":"Standard HC API response wrapper for all endpoints","properties":{"success":{"type":"boolean","description":"Indicates if the request was successful"},"message":{"type":"string","description":"Response message describing the result"},"timestamp":{"type":"string","format":"date-time","description":"Response timestamp"},"data":{"$ref":"#/components/schemas/PagedResponseAdminChallengeSeriesResponse","description":"Response data payload"}}},"PagedResponseAdminChallengeSeriesResponse":{"type":"object","properties":{"totalRecords":{"type":"integer","format":"int64"},"totalPages":{"type":"integer","format":"int64"},"totalAmount":{"type":"number"},"records":{"type":"array","items":{"$ref":"#/components/schemas/AdminChallengeSeriesResponse"}}}},"ApiResponsePagedResponseAdminDevotionalResponse":{"type":"object","description":"Standard HC API response wrapper for all endpoints","properties":{"success":{"type":"boolean","description":"Indicates if the request was successful"},"message":{"type":"string","description":"Response message describing the result"},"timestamp":{"type":"string","format":"date-time","description":"Response timestamp"},"data":{"$ref":"#/components/schemas/PagedResponseAdminDevotionalResponse","description":"Response data payload"}}},"PagedResponseAdminDevotionalResponse":{"type":"object","properties":{"totalRecords":{"type":"integer","format":"int64"},"totalPages":{"type":"integer","format":"int64"},"totalAmount":{"type":"number"},"records":{"type":"array","items":{"$ref":"#/components/schemas/AdminDevotionalResponse"}}}},"ApiResponsePagedResponseAdminListItemResponse":{"type":"object","description":"Standard HC API response wrapper for all endpoints","properties":{"success":{"type":"boolean","description":"Indicates if the request was successful"},"message":{"type":"string","description":"Response message describing the result"},"timestamp":{"type":"string","format":"date-time","description":"Response timestamp"},"data":{"$ref":"#/components/schemas/PagedResponseAdminListItemResponse","description":"Response data payload"}}},"PagedResponseAdminListItemResponse":{"type":"object","properties":{"totalRecords":{"type":"integer","format":"int64"},"totalPages":{"type":"integer","format":"int64"},"totalAmount":{"type":"number"},"records":{"type":"array","items":{"$ref":"#/components/schemas/AdminListItemResponse"}}}},"AchievementResponse":{"type":"object","description":"An achievement and the authenticated user's unlock status for it","properties":{"achievement":{"type":"string","description":"Achievement identifier","enum":["BIBLE_SCHOLAR","TEAM_PLAYER","ENCOURAGER","MEDITATOR","ROOTED","ARDENT_LEARNER"]},"title":{"type":"string","description":"Achievement title"},"description":{"type":"string","description":"Description of how the achievement is unlocked"},"unlocked":{"type":"boolean","description":"Whether the authenticated user has unlocked this achievement"},"unlockedAt":{"type":"string","format":"date-time","description":"When the achievement was unlocked, if applicable"}}},"ApiResponseListAchievementResponse":{"type":"object","description":"Standard HC API response wrapper for all endpoints","properties":{"success":{"type":"boolean","description":"Indicates if the request was successful"},"message":{"type":"string","description":"Response message describing the result"},"timestamp":{"type":"string","format":"date-time","description":"Response timestamp"},"data":{"type":"array","description":"Response data payload","items":{"$ref":"#/components/schemas/AchievementResponse"}}}},"ApiResponseDailyDevotionalResponse":{"type":"object","description":"Standard HC API response wrapper for all endpoints","properties":{"success":{"type":"boolean","description":"Indicates if the request was successful"},"message":{"type":"string","description":"Response message describing the result"},"timestamp":{"type":"string","format":"date-time","description":"Response timestamp"},"data":{"$ref":"#/components/schemas/DailyDevotionalResponse","description":"Response data payload"}}},"DailyDevotionalResponse":{"type":"object","description":"Daily devotional details response (user view)","properties":{"id":{"type":"integer","format":"int64","description":"Devotional ID"},"title":{"type":"string","description":"Title of the devotional"},"devotionalDate":{"type":"string","format":"date","description":"Devotional date"},"content":{"type":"string","description":"Devotional content"},"publishTime":{"type":"string","description":"Publish time"},"scriptures":{"type":"array","description":"Scripture references","items":{"type":"string"},"uniqueItems":true},"createdBy":{"type":"string","description":"Full name of admin who created the devotional"}}},"ApiResponseListDailyDevotionalResponse":{"type":"object","description":"Standard HC API response wrapper for all endpoints","properties":{"success":{"type":"boolean","description":"Indicates if the request was successful"},"message":{"type":"string","description":"Response message describing the result"},"timestamp":{"type":"string","format":"date-time","description":"Response timestamp"},"data":{"type":"array","description":"Response data payload","items":{"$ref":"#/components/schemas/DailyDevotionalResponse"}}}},"ApiResponsePagedResponseChallengeResponse":{"type":"object","description":"Standard HC API response wrapper for all endpoints","properties":{"success":{"type":"boolean","description":"Indicates if the request was successful"},"message":{"type":"string","description":"Response message describing the result"},"timestamp":{"type":"string","format":"date-time","description":"Response timestamp"},"data":{"$ref":"#/components/schemas/PagedResponseChallengeResponse","description":"Response data payload"}}},"ChallengeResponse":{"type":"object","description":"Challenge details response (user view)","properties":{"id":{"type":"integer","format":"int64","description":"Challenge ID"},"challengeName":{"type":"string","description":"Challenge name"},"aboutChallenge":{"type":"string","description":"About challenge"},"startDate":{"type":"string","format":"date","description":"Challenge start date"},"endDate":{"type":"string","format":"date","description":"Challenge end date"},"numberOfDays":{"type":"integer","format":"int32","description":"Number of days for the challenge"},"createdBy":{"type":"string","description":"Full name of admin who created the challenge"},"dateCreated":{"type":"string","format":"date-time","description":"When the challenge was created"},"dateModified":{"type":"string","format":"date-time","description":"When the challenge was last modified"},"subscribed":{"type":"boolean","description":"Whether the current user is subscribed to this challenge"},"activeSubscriptionsCount":{"type":"integer","format":"int32","description":"Number of active subscriptions for this challenge"},"sampleSubscriberImageUrls":{"type":"array","description":"Sample image URLs for five randomly selected subscribers","items":{"type":"string"}},"detailLevel":{"type":"string","description":"Detail level of the response (BASIC for listing, FULL for detailed view)","enum":["BASIC","FULL"]}}},"PagedResponseChallengeResponse":{"type":"object","properties":{"totalRecords":{"type":"integer","format":"int64"},"totalPages":{"type":"integer","format":"int64"},"totalAmount":{"type":"number"},"records":{"type":"array","items":{"$ref":"#/components/schemas/ChallengeResponse"}}}},"ApiResponseChallengeResponse":{"type":"object","description":"Standard HC API response wrapper for all endpoints","properties":{"success":{"type":"boolean","description":"Indicates if the request was successful"},"message":{"type":"string","description":"Response message describing the result"},"timestamp":{"type":"string","format":"date-time","description":"Response timestamp"},"data":{"$ref":"#/components/schemas/ChallengeResponse","description":"Response data payload"}}},"ApiResponseListChallengeResponse":{"type":"object","description":"Standard HC API response wrapper for all endpoints","properties":{"success":{"type":"boolean","description":"Indicates if the request was successful"},"message":{"type":"string","description":"Response message describing the result"},"timestamp":{"type":"string","format":"date-time","description":"Response timestamp"},"data":{"type":"array","description":"Response data payload","items":{"$ref":"#/components/schemas/ChallengeResponse"}}}},"ApiResponsePagedResponseAdminDailyDevotionalResponse":{"type":"object","description":"Standard HC API response wrapper for all endpoints","properties":{"success":{"type":"boolean","description":"Indicates if the request was successful"},"message":{"type":"string","description":"Response message describing the result"},"timestamp":{"type":"string","format":"date-time","description":"Response timestamp"},"data":{"$ref":"#/components/schemas/PagedResponseAdminDailyDevotionalResponse","description":"Response data payload"}}},"PagedResponseAdminDailyDevotionalResponse":{"type":"object","properties":{"totalRecords":{"type":"integer","format":"int64"},"totalPages":{"type":"integer","format":"int64"},"totalAmount":{"type":"number"},"records":{"type":"array","items":{"$ref":"#/components/schemas/AdminDailyDevotionalResponse"}}}},"ApiResponsePagedResponseAdminChallengeResponse":{"type":"object","description":"Standard HC API response wrapper for all endpoints","properties":{"success":{"type":"boolean","description":"Indicates if the request was successful"},"message":{"type":"string","description":"Response message describing the result"},"timestamp":{"type":"string","format":"date-time","description":"Response timestamp"},"data":{"$ref":"#/components/schemas/PagedResponseAdminChallengeResponse","description":"Response data payload"}}},"PagedResponseAdminChallengeResponse":{"type":"object","properties":{"totalRecords":{"type":"integer","format":"int64"},"totalPages":{"type":"integer","format":"int64"},"totalAmount":{"type":"number"},"records":{"type":"array","items":{"$ref":"#/components/schemas/AdminChallengeResponse"}}}}},"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}}}}