Timeline API endpoints use incorrect URL paths

[robzolkos]

The SDK client uses incorrect URL paths for two timeline endpoints, causing 404 errors:

Project Timeline

Current: GET /{accountId}/buckets/{projectId}/timeline.json
Expected: GET /{accountId}/projects/{projectId}/timeline.json

Per https://github.com/basecamp/bc3-api/blob/master/sections/timeline.md, the endpoint is /projects/{id}/timeline.json, not /buckets/{id}/timeline.json.

Person Progress

Current: GET /{accountId}/reports/users/progress/{personId}
Expected: GET /{accountId}/reports/users/progress/{personId}.json

Missing .json extension.

Reproduction

# Works (account-wide)
bcq timeline --json -vv
# -> GET /5735026/reports/progress.json -> 200 OK

# Fails (project)
bcq timeline --in 45926954 --json -vv
# -> GET /5735026/buckets/45926954/timeline.json -> 404

# Fails (person)
bcq timeline me --json -vv
# -> GET /5735026/reports/users/progress/20143023 -> 404

Location

The paths are generated in pkg/generated/client.gen.go:

• NewGetProjectTimelineRequest: uses /buckets/ instead of /projects/
• NewGetPersonProgressRequest: missing .json suffix

[robzolkos]

I'll take a look at a fix shortly.

[robzolkos]

Validation Results

Tested against the real Basecamp API to validate the assumptions:

API Test Results

Endpoint	Path Tested	Result
Project Timeline (current)	/buckets/45926954/timeline.json	404 Not Found ❌
Project Timeline (correct)	/projects/45926954/timeline.json	200 OK ✅
Person Progress (no .json)	/reports/users/progress/45259208	200 OK ✅
Person Progress (with .json)	/reports/users/progress/45259208.json	200 OK ✅

Findings

1. Project Timeline: Confirmed bug - The SDK uses /buckets/{id}/timeline.json but the API expects /projects/{id}/timeline.json.

2. Person Progress: The API accepts both with and without .json extension. The original 404 was likely due to using user_id from auth config (20143023) instead of the actual person_id (45259208).

Impact on Ruby and TypeScript SDKs

All three SDKs are affected by the project timeline bug:

SDK	File	Current Path
Go	pkg/generated/client.gen.go:10924	/buckets/{id}/timeline.json
Ruby	generated/services/timeline_service.rb:14	bucket_path() → /buckets/{id}/timeline.json
TypeScript	generated/services/timeline.ts:39	/buckets/{projectId}/timeline.json

Root Cause

The issue is in the OpenAPI spec (openapi.json:10935) which defines the wrong path:

"/{accountId}/buckets/{projectId}/timeline.json"

Should be:

"/{accountId}/projects/{projectId}/timeline.json"

Fixing the OpenAPI spec will fix all three SDKs upon regeneration.

[robzolkos]

@jeremy Going to wait to see where the chips fall after #74 is merged but I think that one removes project scoped timelines altogether.