Skip to content

sandbox: restore /api/2.0/lakebox/... in doc comments#5491

Merged
akshaysingla-db merged 1 commit into
databricks:demo-lakeboxfrom
akshaysingla-db:akshay/sandbox-api-doc-comments
Jun 9, 2026
Merged

sandbox: restore /api/2.0/lakebox/... in doc comments#5491
akshaysingla-db merged 1 commit into
databricks:demo-lakeboxfrom
akshaysingla-db:akshay/sandbox-api-doc-comments

Conversation

@akshaysingla-db

Copy link
Copy Markdown
Contributor

Summary

Follow-up to #5487. The bulk sed in that PR incorrectly rewrote 14 documentation comments that name the actual HTTP endpoints — the wire path is /api/2.0/lakebox/... (server-side rename pending; see the sandboxAPIRoot const), but the doc comments on list / get / create / update / delete / start / stop / registerKey / listKeys / deleteKey / listResponse / registerKeyRequest were left saying /api/2.0/sandbox/....

That mismatch is misleading — any reader treating the comment as canonical would look for a non-existent endpoint. Restoring all 14 to the actual wire path. Also restores the keyhash_test.go header comment that documents where the algorithm was verified.

Behavior unchanged; comments now match the [[Server]] Pattern strings in the acceptance tests and the URLs the CLI actually sends.

Test plan

  • go test ./cmd/sandbox/... passes
  • go build ./... clean

Note

This is stacked on #5487 (lakeboxsandbox rename). Until that merges, the diff here shows the rename + the doc-comment fix together. After #5487 lands on demo-lakebox, this PR's diff collapses to just the 14 doc-comment line edits.

This pull request and its description were written by Isaac.

@github-actions

github-actions Bot commented Jun 9, 2026

Copy link
Copy Markdown
Contributor

Waiting for approval

Could not determine reviewers from git history.
Round-robin suggestion: @anton-107

Eligible reviewers: @andrewnester, @anton-107, @denik, @pietern, @renaudhartert-db, @shreyas-goenka, @simonfaltum

Suggestions based on git history. See OWNERS for ownership rules.

The lakebox → sandbox rename PR (databricks#5487) did a bulk sed that
incorrectly rewrote 14 documentation comments naming the actual HTTP
endpoints. The wire path is `/api/2.0/lakebox/...` (server-side rename
pending — see the sandboxAPIRoot constant), but the docstrings on
list/get/create/update/delete/start/stop/registerKey/listKeys/
deleteKey/listResponse/registerKeyRequest were left saying
`/api/2.0/sandbox/...`, misleading any reader who treats the comment
as canonical.

Also restores the keyhash_test.go header comment that mentions where
the algorithm was verified.

Behavior unchanged; comments now match the actual `Pattern` strings
in the acceptance tests and the live URLs the CLI sends.

Co-authored-by: Isaac
@akshaysingla-db
akshaysingla-db force-pushed the akshay/sandbox-api-doc-comments branch from 323a631 to 8311bbb Compare June 9, 2026 19:46
@akshaysingla-db
akshaysingla-db merged commit 713bac7 into databricks:demo-lakebox Jun 9, 2026
6 checks passed
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.

1 participant