Skip to content

Update OpenAPI spec for Batch B quest and dashboard routes#62

Open
mintlify[bot] wants to merge 1 commit intomainfrom
mintlify/sync-openapi-batch-b-1774090336
Open

Update OpenAPI spec for Batch B quest and dashboard routes#62
mintlify[bot] wants to merge 1 commit intomainfrom
mintlify/sync-openapi-batch-b-1774090336

Conversation

@mintlify
Copy link

@mintlify mintlify bot commented Mar 21, 2026

Summary

Syncs api-reference/openapi.json to match the normalized Batch B quest and dashboard routes from d-sports-api@ceb5c41.

Trigger repo changes

  • app/api/quests/check-progress/route.ts — shared questType validation with alias map, rich status/actionStatus response
  • app/api/quests/start/route.ts — normalized to apiSuccess/apiError helpers
  • app/api/quests/complete-step/route.ts — normalized response envelope
  • app/api/quests/daily-visit/route.ts — normalized with pointsAwarded + pointsEarned compatibility field
  • app/api/quests/route.ts — normalized response envelope
  • app/api/dashboard/route.ts — normalized to apiSuccess/apiError
  • app/api/dashboard/stats/route.ts — added admin impersonation (userId param), 403 response
  • app/api/dashboard/balance/route.ts — added admin impersonation (userId param), 403 response
  • app/api/dashboard/quests/route.ts — added admin impersonation (userId param), rich aggregated quest progress response

Doc pages updated

  • api-reference/openapi.json — Updated 9 endpoint specs:
    • /api/quests — added normalized response shape, error codes
    • /api/quests/start — marked questId as required, added error codes
    • /api/quests/complete-step — marked body fields required, added detailed response/error shapes
    • /api/quests/daily-visit — added response fields (pointsAwarded, pointsEarned), error codes
    • /api/quests/check-progress — added questId legacy alias, questType enum values, rich response with status and actionStatus
    • /api/dashboard — updated response descriptions for normalized envelope
    • /api/dashboard/stats — added 403 forbidden, documented admin impersonation
    • /api/dashboard/balance — added userId query param, 403 forbidden
    • /api/dashboard/quests — added userId query param, 403 forbidden, detailed aggregated progress response schema

@mintlify
Copy link
Author

mintlify bot commented Mar 21, 2026

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
d-sports 🟢 Ready View Preview Mar 21, 2026, 11:52 AM

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants