Skip to content

docs(audit-log): document window_start's format and the 400 for an unreadable value - #16984

Merged
blakeaowens merged 2 commits into
devfrom
docs/audit-log-refused-filter-400
Nov 18, 2026
Merged

blakeaowens merged 2 commits into
devfrom
docs/audit-log-refused-filter-400

Conversation

@blakeaowens

Copy link
Copy Markdown
Contributor

Description

Documents two things about the Pro audit log endpoint (/api/v2/audit_log/) that its docs page did not say:

  • window_start takes a date in the format YYYY-MM-DD and returns up to 31 days of logs from that date, and the date filters such as timestamp_after and timestamp_before take a date, not a date and time.
  • A parameter value the endpoint cannot read (a malformed date, for example) is answered with a 400 response naming the parameter, rather than being ignored.

The second point matches a Pro change in the same release: the endpoint used to drop an unreadable value silently, which also removed the default 31-day window and answered with the whole history.

Test results

Docs only. The English page docs/content/admin/user_management/PRO__audit_logging.md is the only file changed; the other language copies are generated.

Documentation

This PR is the documentation change.

Checklist

  • Make sure to rebase your PR against the very latest dev.
  • Submit all PRs, features and bug fixes alike, against the dev branch.
  • Give a meaningful name to your PR, as it may end up being used in the release notes.

🤖 Generated with Claude Code

https://claude.ai/code/session_0143hYTDjsrrao6CNsp55Zf8

…readable value

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0143hYTDjsrrao6CNsp55Zf8
@blakeaowens blakeaowens added this to the 3.5.300 milestone Nov 18, 2026
@github-actions github-actions Bot added the docs label Nov 18, 2026
@blakeaowens
blakeaowens added this pull request to the merge queue Nov 18, 2026
Merged via the queue into dev with commit 6164803 Nov 18, 2026
32 checks passed
@blakeaowens
blakeaowens deleted the docs/audit-log-refused-filter-400 branch November 18, 2026 07:05
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants