docs(api): define ordering of audit log requests

[nowNick]

Description

Audit Log request were previously sorted by request_id. With the upcoming changes they'll be sorted by request_timestamp descending - which is from latest to oldest.

Testing instructions

Preview link:

Checklist

• [x] Review label added
• [x] Conditional version tags added, if applicable.

[netlify[bot]]

✅ Deploy Preview for kongdocs ready!

Name	Link
🔨 Latest commit	338b987dd1555397239dc129a5ca654a515a08aa
🔍 Latest deploy log	https://app.netlify.com/sites/kongdocs/deploys/663bc0b1c7235a00088b40cc
😎 Deploy Preview	https://deploy-preview-7178--kongdocs.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.
Lighthouse	9 paths audited Performance: 92 (🔴 down 1 from production) Accessibility: 93 (no change from production) Best Practices: 98 (🟢 up 8 from production) SEO: 91 (no change from production) PWA: - View the detailed breakdown and full score reports

---

To edit notification comments on pull requests, go to your Netlify site configuration.

[nowNick]

Hey @lena-larionova !

I was hoping I could preview the change here: https://deploy-preview-7178--kongdocs.netlify.app/gateway/api/admin-ee/latest/#/audit-logs/get-audit-requests but I think the conditional version tag is excluding it since the latest version there is 3.6.0.x and I'm allowing it only for: {% if_version gte:3.7.x %}

Is that expected?

[lena-larionova]

Ah! I'm sorry, I didn't realize this was one of the migrated pages, that's my miss. You will actually have to update the spec instead now: https://github.com/Kong/docs.konghq.com/blob/main/api-specs/Gateway-EE/latest/kong-ee.yaml#L14781

You don't need to version tag anything in the spec, we'll cut a new version when 3.7 goes out.

[nowNick]

Got it! I'll fix that but for now I'll change this PR back to draft.

[nowNick]

@lena-larionova I've updated the spec but I still can't see it in deploy preview : https://deploy-preview-7178--kongdocs.netlify.app/gateway/api/admin-ee/latest/#/audit-logs Shouldn't it be visible there? 🤔

[lena-larionova]

@lena-larionova I've updated the spec but I still can't see it in deploy preview : https://deploy-preview-7178--kongdocs.netlify.app/gateway/api/admin-ee/latest/#/audit-logs Shouldn't it be visible there? 🤔

We have to upload the spec to the konnect dev portal, which is currently not automated. I'll upload it after this PR gets merged.

[lena-larionova]

Threw it into swagger editor to test, everything displays as it should. Will merge with 3.7.

[Guaris]

Pulled all of these changes into #7353 so they can be merged with the release of 3.7. Closing this PR.