Skip to content

Hide the Backend API logs endpoints from the published reference - #133

Merged
jescalan merged 1 commit into
mainfrom
jeff/unpublish-logs-endpoints
Sep 23, 2026
Merged

jescalan merged 1 commit into
mainfrom
jeff/unpublish-logs-endpoints

Conversation

@jescalan

@jescalan jescalan commented Sep 23, 2026 •

Copy link
Copy Markdown
Contributor

Why

The Backend API /logs endpoints (GET /logs, GET /logs/{event_time_and_id}, GET /logs/schemas) were published in the reference on 2026-09-22 via #132, ahead of two things we want in place first: rate limiting suited to agent-driven callers, and an explicit experimental marker, since the response shape is still expected to change. Within a day of publication we saw new customers start calling it, including agent loops with malformed pagination params.

This takes the endpoints back out of the published reference so the docs and the generated SDKs stop advertising them until that work is done. The endpoints themselves remain live for the customers already using them.

What changed

Only the five bapi/*.yml files are touched. Each drops exactly the 637 lines that #132 added for the logs family: the Logs tag, the three /logs paths, and the Log, LogWithPayload, and LogSchema schemas. The FAPI and Platform API changes from #132 are untouched.

Related

  • clerk_go PR flipping the x-public markers back so the next automated publish doesn't re-add them: clerk/clerk_go#22393
  • Original publish: chore: Update OpenAPI Specs #132 and clerk/clerk_go#22280

🤖 Generated with Claude Code

The /logs family (list, get, schemas) went public in the Backend API
reference on 2026-09-22 before rate limiting and the API's stability
posture were settled. This removes the Logs tag, the three /logs paths,
and their schemas from every published BAPI version so the reference and
generated SDKs stop advertising them while that work lands. The FAPI and
Platform API changes from the same publish are kept.

The endpoints themselves stay live; only the docs visibility changes.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
@github-actions

Copy link
Copy Markdown

Preview Links

@jescalan
jescalan merged commit cdd59c4 into main Sep 23, 2026
5 checks passed
@jescalan
jescalan deleted the jeff/unpublish-logs-endpoints branch September 23, 2026 16:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants