Skip to content

Sync API docs from bc3: spotlights, questions 403 note, schedule entries 422 note - #439

Merged
jeremy merged 1 commit into
masterfrom
sync-api-docs-drift-remediation
Sep 1, 2026
Merged

Sync API docs from bc3: spotlights, questions 403 note, schedule entries 422 note#439
jeremy merged 1 commit into
masterfrom
sync-api-docs-drift-remediation

Conversation

@jeremy

@jeremy jeremy commented Sep 1, 2026

Copy link
Copy Markdown
Member

Forward sync of the bc3-ahead half of the docs drift:

  • New Spotlights section (sections/spotlights.md) plus its README index entry
  • questions.md: client users may only update their own question — 403 Forbidden otherwise
  • schedule_entries.md: failed validation on create returns 422 Unprocessable Entity with an errors payload

Companion to bc3#13040, which ports #436's delegated-events docs back into bc3's doc/api/ — with that port in place, this sync leaves events.md/webhooks.md untouched (exact convergence, nothing deleted). Merge after bc3#13040 lands.

Tracking: bc3 ↔ bc-api docs drift card

Synced from bc3 doc/api/ by script/api/sync_to_bc3_api — not a hand-edit.

Copilot AI balanced review requested due to automatic review settings September 1, 2026 01:20

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 4b35ecb9a6

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread sections/spotlights.md
@chatgpt-codex-connector

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review Completed 2026-09-01T01:22:44.207892Z 4b35ecb PR opened
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Syncs authoritative bc3 API documentation into this read-only documentation mirror.

Changes:

  • Adds Spotlights endpoint documentation and index entry.
  • Documents Questions update authorization behavior.
  • Documents Schedule Entry validation errors.

Tip

If you aren't ready for review, convert to a draft PR.
Click "Convert to draft" or run gh pr ready --undo.
Click "Ready for review" or run gh pr ready to reengage.

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated no comments.

File Description
README.md Adds Spotlights to the endpoint index.
sections/spotlights.md Documents spotlight creation, removal, and legacy routes.
sections/questions.md Documents client-user update restrictions.
sections/schedule_entries.md Documents 422 validation responses.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

@jeremy
jeremy merged commit ab04d9c into master Sep 1, 2026
1 check passed
@jeremy
jeremy deleted the sync-api-docs-drift-remediation branch September 1, 2026 02:42
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