Repository navigation
feat: support Platform API 1.145 features (roles, folder mounts, linked datasets) - #697
Merged
Merged
Conversation
This was referenced Oct 5, 2026
Open
Merged
cristianrcv
added this pull request to stack #704
October 5, 2026 16:12
This was referenced Oct 5, 2026
Closed
cristianrcv
removed this pull request from stack #704
October 5, 2026 16:20
cristianrcv
added this pull request to stack #705
October 5, 2026 16:20
cristianrcv
force-pushed
the
feat/NOTASK-api-1.113-catch-up
branch
from
October 7, 2026 09:39
349ef6b to
7fc52bb
Compare
cristianrcv
force-pushed
the
feat/NOTASK-tw-api-1.145
branch
from
October 7, 2026 09:39
7074dd0 to
1ae323f
Compare
cristianrcv
removed this pull request from stack #705
October 7, 2026 13:26
cristianrcv
changed the base branch from
feat/NOTASK-api-1.113-catch-up
to
master
October 7, 2026 13:31
alberto-miranda
approved these changes
Oct 7, 2026
jonmarti
approved these changes
Oct 7, 2026
DataStudioConfiguration.mountDataV2 (platform API 1.114.0, platform commit ac72147bb3; first in the published spec at 1.145.0) mounts a data link with an optional sub-path, and the platform gives it precedence over the deprecated mountData. The UI now sends only mountDataV2, and studio descriptions return both fields, so 'tw studios start|update|add-as-new' with a mount option sent a new mountData while the fetched mountDataV2 still held the old mounts: the platform kept the old mounts and silently ignored the change. tw now always sends mountDataV2 (plus mountData for older platforms) when a mount option is given. '--mount-data-uris' also accepts a URI inside a data link: tw resolves the closest parent data link and mounts the remainder as the path, which is what the UI's folder picker does. 'studios view' prints the mounted path. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Data links created before Platform stripped trailing slashes from resource refs (2025-02) can still be stored as 's3://bucket/'. The mount-data URI lookup strips the slash from the user's URI and then compared it exactly, so those links could no longer be mounted. Normalise both sides. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
API 1.145.0 added linked datasets: a dataset created with
sourceType=LINKED whose versions point to a public HTTP(S) CSV/TSV URL
(POST /datasets/{id}/link) instead of an uploaded file. tw could only
upload files, so:
- 'tw datasets add --url <url>' validates the URL first
(POST /datasets/validate-url, as the UI does, so a bad URL does not
leave an empty dataset behind), creates a LINKED dataset and links
the URL as its first version.
- 'tw datasets update --url <url>' links a new version.
- 'datasets view ... versions' shows the source URL of linked versions,
which have no file name (the table would otherwise hit a null cell).
preview-url and the version preview back UI widgets and add no CLI
capability.
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
listUserRolesInOrganization (API 1.145, /orgs/{orgId}/users/{userId}/roles)
had no tw command.
Add 'tw members roles' to show a member's role in each workspace and
whether it was granted directly or through a team.
deleteWorkspaceUser is not added: it removes the same participant as
'tw participants delete' (both call MemberDeleteService.deleteParticipant
in the backend), only looked up by user ID instead of participant ID.
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Platform API 1.145 added custom workspace roles (/roles), but tw could only assign them by name through 'participants update --role'; there was no way to see which roles exist or to create them. Add 'tw roles' with list, view, add, update, delete and permissions. The update endpoint replaces name, description and permissions as a whole, so 'roles update' reads the current role and only overrides the fields that were passed. The /roles/permissions name filter is typed as int64 in the API spec, so 'roles permissions' does not expose it. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
A custom roles section, 'tw members roles' next to organization quotas, and summary bullets for studio folder mounts and linked datasets. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Entries for the roles and members roles commands and responses, taken from a full test run under the GraalVM tracing agent. Response classes register allDeclaredFields, since Jackson serializes every field for -o json. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
cristianrcv
force-pushed
the
feat/NOTASK-tw-api-1.145
branch
from
October 7, 2026 14:50
1ae323f to
24cb0df
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Exposes features introduced in Platform API 1.145.0: custom roles, data-link folder mounts for studios (mountDataV2), and linked (URL) datasets.
This is one PR in a stack that catches tw up with Platform API 1.230.0: one PR per API version that introduced the features, then one PR per topic for agents and actions, which are grouped across versions so they're easier to review.
tower-java-sdk1.200.0, which already contains every API element used here. The 1.230 PR bumps it.Changes
Notes for review
studios start|update|add-as-new --mount-data*now setsmountDataV2, which takes precedence in Platform. Before, a mount change was silently ignored for studios that already had v2 mounts.datasets add: FILENAME is optional when--urlis given.Verification
./gradlew test: 857 tests, 0 failures. Every new command and option has MockServer tests that assert the request (method, path, query, body) and the output.🤖 Generated with Claude Code