Described API URLs do not match auto-generated schema

[whitep4nth3r]

SDK

Other

Description

Relevant Discord thread: https://discord.com/channels/621778831602221064/1301836198355931220/1301836198355931220

Affected pages:

API URLs described at the top of API pages including (but not limited to):

• https://docs.sentry.io/api/events/retrieve-an-issue/
• https://docs.sentry.io/api/events/remove-an-issue/

The issue

URLs, e.g. GET /api/0/issues/{issue_id}/ are used as an example of a URL to call.

Further down on the page, the docs state that each URL requires an organization_id_or_slug.

This is not represented in the URL.

---

I understand that the API docs are auto-generated from the annotations on API endpoint definitions inside the Sentry repo i.e. here.

Suggested Solution

No response

[getsantry]

Assigning to @getsentry/support for routing ⏲️

[a-hariti]

I think this has to do with auto generated API docs more than authors