EXPIRED and DISABLED error codes do not include example JSON responses in Unkey Docs

[unrenamed]

Preliminary Checks

• I have reviewed the documentation: https://unkey.com/docs

• I have searched for existing issues: https://github.com/unkeyed/unkey/issues

• This issue is not a question, general help request, or anything other than a bug report directly related to Unkey. Please ask questions in our Discord community: https://unkey.com/discord.

Reproduction / Replay Link (Optional)

No response

Issue Summary

Currently, the Unkey documentation provides example JSON responses for various error codes, enhancing clarity for developers. However, the EXPIRED and DISABLED error codes are the only exceptions, as they do not include example JSON responses.

Was it done intentionally? If no, see the proposed solutions in the Expected behavior.

https://www.unkey.com/docs/api-reference/errors/code/EXPIRED
https://www.unkey.com/docs/api-reference/errors/code/DISABLED

Steps to Reproduce

1. Visit any of the error code documentation pages for EXPIRED or DISABLED.
2. Compare the content on these pages with the corresponding pages for other error codes to identify the absence of JSON response examples.

Expected behavior

I propose one of the following solutions:

• Include relevant example JSON responses for both the EXPIRED and DISABLED error codes for consistency.
• Consider removing the existing JSON examples for other error codes if they are not essential.

Both approaches would contribute to a more uniform documentation structure.

Other information

No response

Screenshots

Version info

- OS:
- Node:
- npm:

[linear]

ENG-1413 `EXPIRED` and `DISABLED` error codes do not include example JSON responses in Unkey Docs

[2DELTA7]

/assign

[unrenamed]

@2DELTA7 This ticket first needs to be approved by the repo owners. The /assign command will not work without oss.gg label, fyi.

[perkinsjr]

/award 150

[oss-gg]

Awarding unrenamed: 150 points 🕹️ Well done! Check out your new contribution on oss.gg/unrenamed

[HimanshuGaur14]

/assign

[oss-gg]

Assigned to @HimanshuGaur14! Please open a draft PR linking this issue within 48h ⚠️ If we can't detect a PR from you linking this issue in 48h, you'll be unassigned automatically 🕹️ Excited to have you ship this 🚀

[Harshalingole]

/assign

[oss-gg]

This issue is already assigned to another person. Please find more issues here.

[tandrimab]

/assign

[oss-gg]

This issue is already assigned to another person. Please find more issues here.

[jayraj-kl]

/assign

[oss-gg]

This issue is already assigned to another person. Please find more issues here.

[Vidhanvyrs]

/assign

[oss-gg]

This issue is already assigned to another person. Please find more issues here.

[chronark]

Let's add examples everywhere, rather than removing. I think it helps to understand what we return

[HimanshuGaur14]

My system is facing a problem while im updating the issue , i won't be able to complete it please unassign me.
I'm sorry for the delay.

[DeepaPrasanna]

My system is facing a problem while im updating the issue , i won't be able to complete it please unassign me. I'm sorry for the delay.

you can unassign yourself too. Look at the top right corner or use /unassign command

[HimanshuGaur14]

/unassign

[oss-gg]

Issue unassigned.

[joelwalice]

/assign

[oss-gg]

Assigned to @joelwalice! Please open a draft PR linking this issue within 48h ⚠️ If we can't detect a PR from you linking this issue in 48h, you'll be unassigned automatically 🕹️ Excited to have you ship this 🚀

[rajtejani]

/assign

[oss-gg]

Assigned to @rajtejani! Please open a draft PR linking this issue within 48h ⚠️ If we can't detect a PR from you linking this issue in 48h, you'll be unassigned automatically 🕹️ Excited to have you ship this 🚀

[rajtejani]

After carefully reviewing the code it seems like the issue is not related with Docs but actually these ErrExpired and ErrDisabled response are not implemented. It can not be found on https://api.unkey.dev/openapi.json.

[chronark]

@rajtejani ah that might be yeah
if you add them here, it will add them to the openapi spec once deployed
https://github.com/unkeyed/unkey/blob/main/apps/api/src/pkg/errors/openapi_responses.ts

[rajtejani]

Running pnpm fmt before commiting code throw some errors of dashboard code which is not relevant to my changes. There are more then 20+ problems highlighted by linter. What should I do?

[Taranv8]

/assign

[oss-gg]

This issue is already assigned to another person. Please find more issues here.

[div000-321go]

/assign

[oss-gg]

This issue is already assigned to another person. Please find more issues here.

[Pk9697]

/assign

[oss-gg]

Assigned to @Pk9697! Please open a draft PR linking this issue within 48h ⚠️ If we can't detect a PR from you linking this issue in 48h, you'll be unassigned automatically 🕹️ Excited to have you ship this 🚀

[oss-gg]

@Pk9697, Just a little reminder: Please open a draft PR linking this issue within 12 hours. If we can't detect a PR in 12h, you will be unassigned automatically.

[oss-gg]

@Pk9697, Just a little reminder: Please open a draft PR linking this issue within 12 hours. If we can't detect a PR in 12h, you will be unassigned automatically.

[oss-gg]

@Pk9697, Just a little reminder: Please open a draft PR linking this issue within 12 hours. If we can't detect a PR in 12h, you will be unassigned automatically.