Skip to content

Add account settings, team settings, and API keys to the OpenAPI spec - #573

Merged
erkkinen merged 22 commits into
mainfrom
docs/v3-settings-endpoints
Nov 13, 2026
Merged

erkkinen merged 22 commits into
mainfrom
docs/v3-settings-endpoints

Conversation

@jspaetzel

@jspaetzel jspaetzel commented Oct 9, 2026 •

Copy link
Copy Markdown
Member

Summary

  • Publish the v3 account and team settings endpoints, including an optional account or team id at the end of the path.
  • Name team lock modes organization_admins, team_admins, and members, and model updates as set, unset, and lock maps. Unsetting a team setting also clears its lock.
  • Publish the API key endpoints in the docs spec (openapi.yaml and openapi-fern.yaml), with examples and SEO copy. They stay hidden from the SDK spec and are marked closed beta.
  • Rebuild the settings SDK surface from the regenerated spec.

Generated from the Sign settings branch: https://github.com/dropbox-internal/sign/pull/28857

Test plan

  • Confirm ./build output matches this branch
  • Review the settings operations, TeamSettingLock, and the five API key operations in the docs spec
  • Confirm /api_key is absent from openapi-sdk.yaml
  • Hold the docs publish until the settings API and public SDKs are released

jspaetzel and others added 13 commits October 8, 2026 20:01
Co-authored-by: Cursor <cursoragent@cursor.com>
Co-authored-by: Cursor <cursoragent@cursor.com>
Co-authored-by: Cursor <cursoragent@cursor.com>
Co-authored-by: Cursor <cursoragent@cursor.com>
…cs/v3-settings-endpoints

Co-authored-by: Cursor <cursoragent@cursor.com>
Co-authored-by: Cursor <cursoragent@cursor.com>
Docs list each setting and the unset names, and SDK clients keep a free-form map.

Co-authored-by: Cursor <cursoragent@cursor.com>
Co-authored-by: Cursor <cursoragent@cursor.com>
Co-authored-by: Cursor <cursoragent@cursor.com>
The modes now say what the lock does, matching the value the console stores.

Co-authored-by: Cursor <cursoragent@cursor.com>
Co-authored-by: Cursor <cursoragent@cursor.com>
@jspaetzel jspaetzel changed the title Add account and team settings to the OpenAPI and Fern specs Add account settings, team settings, and API keys to the OpenAPI spec Nov 5, 2026
@jspaetzel
jspaetzel marked this pull request as ready for review November 5, 2026 21:45
jspaetzel and others added 9 commits November 5, 2026 15:01
Regenerate the docs spec from Sign so path and response examples match IdConstraint.

Co-authored-by: Cursor <cursoragent@cursor.com>
Pick up the OpenAPI Generator 7.26.0 SDK upgrades so generated clients match CI.
Account updates no longer expose locks, and the clients match the generator output CI checks.

Co-authored-by: Cursor <cursoragent@cursor.com>
…amples.

Team responses keep existing constructor arguments, published descriptions resolve again, and API key examples stay as direct HTTP calls.

Co-authored-by: Cursor <cursoragent@cursor.com>

@erkkinen erkkinen left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

LGTM

@erkkinen erkkinen left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

LGTM

@erkkinen
erkkinen merged commit 75dbc6f into main Nov 13, 2026
10 checks passed
@erkkinen
erkkinen deleted the docs/v3-settings-endpoints branch November 13, 2026 00:55
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