Skip to content

chore(openapi): refresh snapshot for v0.2.891 and map new endpoints - #78

Merged
cooper-gadd merged 3 commits into
scalar-nextfrom
tembo/sync-openapi-v0.2.891
Nov 11, 2026
Merged

cooper-gadd merged 3 commits into
scalar-nextfrom
tembo/sync-openapi-v0.2.891

Conversation

@tembo

@tembo tembo Bot commented Nov 11, 2026

Copy link
Copy Markdown
Contributor

Summary

Refreshes the committed public OpenAPI snapshot (openapi/openapi.json) from the production spec deployed by release v0.2.891 and maps the 11 new endpoints. The snapshot is byte-identical to the MCP snapshot in tembo/mcp#38.

Spec changes:

  • Added folders (sidebar folders that organize sessions): GET/POST /v1/folders, PATCH/DELETE /v1/folders/{folderId}. GET /v1/sessions adds folderId and inFolder filters.
  • Added organization roles: GET/POST /v1/organizations/{organizationId}/roles, GET/PATCH/DELETE /v1/organizations/{organizationId}/roles/{roleId}. Archiving a role (DELETE) requires a replacementRoleId body.
  • Organization members: role is replaced by roleId on create (required) and update (optional). This is a breaking SDK change, so the release is a minor bump (pre-1.0).
  • Added GET /v1/artifacts/assets/{assetId} (retrieve a signed asset URL) and GET /v1/projects/defaults.
  • Other field and response schema updates on existing endpoints.

No endpoints were removed.

Mapping

scalar.config.json adds these shared resources (used by the TypeScript, Rust, and Python targets):

  • folders: list, create, update, delete (new top-level resource)
  • organizations.roles: list, create, retrieve, update, delete. delete is an http method with bodyParamName: "body" for the required replacement role.
  • artifacts.retrieve_asset_url (follows integrations.retrieve_sync_status)
  • projects.retrieve_defaults (next to update_defaults)

tests/schema-contract.test.mjs adds a test that the mappings cover the new routes and keep their request bodies, including the role DELETE body. It fails without the mappings.

tests/sdk.test.mjs: Scalar's manifest names the new artifact operation retrieveAssetUrl, but the TypeScript emitter writes client.artifacts.retrieveAssetURL (like assetID). The contract test now resolves that URL casing when it checks that each manifest operation exists on the client. Without this, the release PR's contracts check would fail once this snapshot lands.

Generated code and version bumps are left to Scalar.

Scalar

  • The prepared schema was uploaded to tembo/tembo-eight-pr-verification as non-current version 2.0.42923047796. Scalar auto-built it as SDK 0.5.20 with the existing mappings (build vhHc4MqvrjOYbgRMTFO88).
  • In the hosted SDK config, only the shared resources mappings changed. All other hosted settings, including the typescript, rust, and python targets, are unchanged.
  • SDK 0.5.21 was built (build SIhAFMcV0C69P0vi7nVeI) and synced into scalar-next as feat(api): add operation organizations.roles.list (+10 more changes). It refreshed release PR release: 0.23.0 #77 (release: 0.23.0), release: 0.11.0 tembo-rs#18, and release: 0.12.0 sdk-python#17.
  • This branch merges scalar-next so the generated manifest includes the new operations.

Testing

  • npx --package=@scalar/cli@2.1.0 scalar document validate openapi/scalar.openapi.json: valid (OpenAPI 3.1)
  • npm run typecheck
  • npm test, with and without ALLOW_PENDING_SCALAR_MAPPINGS: 40 passed, 0 failed
  • npm pack --dry-run
  • node scripts/refresh-schema.mjs: mappings cover production, public contract unchanged
  • biome format: no changes

Want tembo to make any changes? Add a comment with @tembo and i'll get back to work!

View on Tembo  Review in Tembo  View Agent Settings  View on agent

cooper-gadd and others added 3 commits November 10, 2026 19:07
Co-authored-by: tembo[bot] <208362400+tembo-io[bot]@users.noreply.github.com>
…napi-v0.2.891

Co-authored-by: Cooper <126418690+cooper-gadd@users.noreply.github.com>
Co-authored-by: tembo[bot] <208362400+tembo-io[bot]@users.noreply.github.com>
@tembo
tembo Bot requested a review from cooper-gadd as a code owner November 11, 2026 00:16
@tembo tembo Bot added tembo Pull request created by Tembo labels Nov 11, 2026
@tembo

tembo Bot commented Nov 11, 2026

Copy link
Copy Markdown
Contributor Author

Requesting review from @cooper-gadd who has experience with the following files modified in this PR:

  • scalar.config.json
  • openapi/openapi.json
  • tests/schema-contract.test.mjs

@cooper-gadd
cooper-gadd merged commit bd81b15 into scalar-next Nov 11, 2026
4 checks passed
@tembo
tembo Bot deleted the tembo/sync-openapi-v0.2.891 branch November 11, 2026 00:50
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

tembo Pull request created by Tembo

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant