Skip to content

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

Open

Description

@chonilius

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

Activity

  1. tresjo81 commented on Oct 13, 2026

    @tresjo81

    Hi team! I'd like to take this on. I can mark these stub operations with @ApiOperation({ deprecated: true, description: 'Not implemented' }) (or omit/document appropriately per guidelines) so Swagger accurately reflects the current status of these endpoints. Could you please assign this to me?

  2. added a commit that references this issue on Oct 14, 2026
    5526679
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentationgood first issueGood for newcomers

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions