Sitelet https://github.com/basecamp/bc-api/pull/451
Skip to content

Sync API docs from bc3: hill chart progress updates - #451

Open
robzolkos wants to merge 1 commit into
masterfrom
sync-hill-progress-updates
Open

robzolkos wants to merge 1 commit into
masterfrom
sync-hill-progress-updates

Conversation

@robzolkos

Copy link
Copy Markdown
Contributor

This documents read-only access to hill chart progress updates. Each time someone updates a hill chart, Basecamp saves the note they wrote and where each to-do list sat on the hill. Until now the API only returned the current positions.

  • Get hill chart progress updates. GET /todosets/1/hills/versions.json lists every progress update for a hill chart, newest first and paginated. Each update includes the full note as rich text, a dots array with each tracked to-do list's name and position at the time of the update, and links to its comments.
  • Get a hill chart progress update. GET /todosets/1/hills/versions/2.json returns a single update in the same shape.
  • versions_url on the hill chart. GET /todosets/1/hill.json now includes versions_url when the hill chart has any progress updates.
  • Collecting updates across projects. In the progress report, hill_version_created events have a url that returns the full progress update.

This changes sections/hill_charts.md only.

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 October 1, 2026 16:50

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.

Copilot review overview

🟢 Approved

The synchronized documentation is complete, internally consistent, and follows repository conventions.

Review effort: Balanced
Findings: None

What changed in this PR

Documents read-only API access to historical hill chart progress updates.

Changes:

  • Adds list and detail endpoints with response and cURL examples.
  • Documents update metadata, dots, comments, pagination, and timeline discovery.
  • Adds hill chart version URLs.

[!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.

File Description
sections/​hill_charts.md Documents hill chart progress update APIs and response fields.

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

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