Skip to content

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

Open
jspaetzel wants to merge 18 commits into
mainfrom
docs/v3-settings-endpoints
Open

jspaetzel wants to merge 18 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 5 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>
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