nav[aria-label="Primary Navigation"] { padding: 0; & ul { list-style: none; width: 100%; display: flex; flex-direction: row; justify-content: start; align-items: start; gap: 30px; padding: 0; & li { margin: 0; } & ul li { list-style: none; } } }

API JSON schemas URLs are 404

Hadrien Milano

I would like to leverage the JSON schemas as seen in the API documentation to write some tooling around the API.

However, the schema URLs lead to 404 Not Found error pages. For instance, this page should be a JSON schema of the issue update request payload, but in fact it does not exist.

Accepted answers

Angélica Luz

Hi Hadrien,

The page that you sent is showing 404 for me as well, but on the API documentation there is a scheme for "Edit issue" that is the same as "Issue updated".
Here is the direct link: Edit issue API
Can you please test and let us know if it works for you?

Regards,
Angélica

All comments

Angélica Luz

Hi Hadrien,

Regards,
Angélica

Hadrien Milano

Well that's where I found the faulty URL.

The JSON schema provided for the "edit issue API" contains a URL associated with the key "id". The schema itself should be served when you navigate to this URL, but instead there is a 404 error.

Normally, you can hint IDEs at the schema using its URL. However, in this case it doesn't work because of the 404.

Note that this is the case for all schemas, it is not specific to the "edit issue" api.

Angélica Luz

Hi Hadrien,

The URL https://docs.atlassian.com/jira/REST/schema/issue-update for any of other schemas will not return anything.
Have you tried to use the endpoints?
To edit an issue, you won't need the schema, you will need to use PUT /rest/api/2/issue/{issueIdOrKey}.
Please, check the documentation below that has more updated information:
- Jira Cloud platform Developer

Regards,
Angélica

Hadrien Milano

> The URL https://docs.atlassian.com/jira/REST/schema/issue-update for any of other schemas will not return anything.

That's exactly the problem. Some text editors can use the schema to provide an enhanced editing experience. Normally, the full JSON schema should be available at that address, and then I can annotate a JSON payload with the `$schema` attribute and that URL to let my editor understand the structure JSON document I am writing.

> Have you tried to use the endpoints?

Yes, that works just fine. There is no problem using the API. I'm just saying that the URL you put in the schema isn't just there for decoration. It should work and it should serve the schema definition.