Visitar URL original
Update OpenAPI spec: document include_deleted on detail/history endpoints · Issue #1012 · modelcontextprotocol/registry · GitHub
Skip to content

Update OpenAPI spec: document include_deleted on detail/history endpoints #1012

Closed

Description

@tadasant

Context

PR #893 added include_deleted query parameter support to multiple endpoints, but the OpenAPI spec (docs/reference/api/openapi.yaml) only documents it on the list endpoint.

Ref: #893 (review)

What needs updating

The include_deleted query parameter (boolean, default false) should be added to the OpenAPI spec for:

  • GET /v0.1/servers/{serverName}/versions/{version} — version detail endpoint
  • GET /v0.1/servers/{serverName}/versions — version history endpoint

It's already documented on GET /v0.1/servers (the list endpoint).

Notes

  • The code already supports include_deleted on all three endpoints — this is purely a spec documentation gap
  • The official-registry-api.md and CHANGELOG.md were updated in Publisher-managed "deleted" support #893; only the OpenAPI spec was missed

Activity

  1. pree-dew commented on Feb 27, 2026

    @pree-dew
    Contributor

    @tadasant Thank you for pointing this out, my bad I missed this. I will take care of this.

  2. pree-dew commented on Feb 28, 2026

    @pree-dew
    Contributor

    #1014 Fixes the issue.

  3. rdimitrov commented on Apr 24, 2026

    @rdimitrov
    Member

    Closing this out. include_deleted is now documented on all three endpoints in docs/reference/api/openapi.yaml: the list (/v0.1/servers), version history (/v0.1/servers/{serverName}/versions), and version detail (/v0.1/servers/{serverName}/versions/{version}).

  4. self-assigned this
    on Apr 24, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

No labels
No labels

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions