Skip to content

docs(api): mark the stub allocate/approve/reject routes deprecated in Swagger - #654

Closed
yggdrasilworld wants to merge 3 commits into
MergeFi:mainfrom
yggdrasilworld:fix/swagger-stub-routes-613
Closed

yggdrasilworld wants to merge 3 commits into
MergeFi:mainfrom
yggdrasilworld:fix/swagger-stub-routes-613

Conversation

@yggdrasilworld

@yggdrasilworld yggdrasilworld commented Oct 14, 2026 •

Copy link
Copy Markdown

What

POST /milestones/:id/allocate and POST /bounties/:id/approve|reject are stubs (the #253 regression) but Swagger presented them as working operations with normal summaries + success responses — API consumers building against /api/docs had no hint nothing happens.

The fix

Marked all three @ApiOperation({ deprecated: true, description: 'Not implemented — stub route' }) so the docs don't present them as working.

Resolves #613 · Related: #253

Payment: Base USDC 0xD40Df5c27cEa7dd78A3c345401995c319589334e

… Swagger

The three stub routes (the MergeFi#253 regression) presented as working operations
in /api/docs — API consumers had no hint nothing happens. Marked deprecated
with 'Not implemented'.

Resolves MergeFi#613
@vercel

vercel Bot commented Oct 14, 2026

Copy link
Copy Markdown

@yggdrasilworld is attempting to deploy a commit to the chonilius' projects Team on Vercel.

A member of the Team first needs to authorize it.

yggdrasilworld and others added 2 commits October 18, 2026 21:50
The shared base carried half-written merge artifacts: an orphaned
invokeOnLockedEscrow block in escrow.service.ts, duplicated returns plus
a dead parsePagination in sponsors.controller.ts, and missing
describe/it closers in github-webhooks.service.spec.ts. Aligned each
with the intended form so the branch typechecks and its specs load.
@yggdrasilworld
yggdrasilworld deleted the fix/swagger-stub-routes-613 branch October 19, 2026 02:33
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.

POST /milestones/:id/allocate and /bounties/:id/approve|reject are documented in Swagger as working operations

2 participants