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

Open
#613 2 comments 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

@urielit1313-creator is already working on this.

Since Oct 13, 2026.

  • #628 by @urielit1313-creator — open
  • #647 by @yggdrasilworld — closed without merging
  • #654 by @yggdrasilworld — closed without merging

Assessment

Difficulty
2/5
Estimated time
Under an hour
Newbie friendliness
25/100
Issue type
Documentation
Clarity
Clearly specified
Activity status
Active
Tech stack
typescript
Domain
api

Research direction

The three stub routes are POST /milestones/:id/allocate and POST /bounties/:id/approve and /bounties/:id/reject, whose Swagger summaries are shown at /api/docs. Three open pull requests (#628, #647, #654) already target this issue, so read those first and check whether one already covers it. Done means the three operations show as deprecated or not implemented in the Swagger output.

Written by the indexing model from the issue text.

Description

documentation good first issue

Problem

While these three routes are stubs (see the #253 regression), Swagger presents them with summaries such as "Approve a claimed bounty" and standard success responses. API consumers building against /api/docs have no hint that nothing happens.

Suggested fix

Mark them @ApiOperation({ deprecated: true, description: 'Not implemented' }) or exclude them until they're implemented.

Related: #253

Dominant language
TypeScript
Stars
2
Forks
90
Avg merge
31m
Merged PRs (30d)
20

Getting set up

  • Ships a Dockerfile or Docker Compose file
  • No pull request template
  • No contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from MergeFi/backend

All issues in MergeFi/backend

Similar issues

More TypeScript issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.