JUjubjubapp
v2 - Workspaces

Set Workspace Team

Atomically set (or clear) a workspace's team in one request.

Replaces the client-side unlink-then-link pattern, which could leave a workspace orphaned from every team if the second call failed. Validates the target team up front, then unlinks from the old team and links to the new one, saving the workspace once. team_id=None unlinks only.

Access: workspace owner only (matches the link endpoint).

put/v2/workspaces/{workspace_id}/team

Request

  • Base URL
    https://api.jubjubapp.com (the document declares no server; this is the origin it was published from)
  • Auth
    HTTP bearer

Path parameters

workspace_idstring required

Headers

Authorizationstring
X-JubJub-Service-Keystring
X-JubJub-Agent-Keystring
X-JubJub-Platform-Keystring
Originstring
Refererstring
X-JubJub-Trial-Tokenstring

Request body

team_idstring nullable

Team to link to. None unlinks from any current team.

Response

Successful Response

workspace_idstring required
owner_member_refstring nullable
ownerobject nullable

The owner's public profile: {member_ref, display_name, avatar_url, handle, is_you}. Null for an unclaimed trial.

is_ownerboolean
folder_idstring nullable required
team_idstring nullable

Team this workspace belongs to (if linked)

team_namestring nullable

Name of the linked team (for display)

my_rolestring nullable

Role of the requesting user: 'owner', 'admin', 'editor', 'reviewer', 'viewer', or null if not a member

namestring required
descriptionstring nullable required
cover_image_urlstring nullable required
kind'workspace' | 'collection'
archivedboolean
archived_atstring date-time nullable
archived_bystring nullable
archived_by_member_refstring nullable
can_approveboolean

Whether the caller may release a launch here

has_reviewersboolean nullable

Whether the workspace has at least one reviewer (a reviewer on the linked team, or a direct workspace reviewer); the approval badge shows only then. Null when the linked team was not read.

default_languagestring nullable required
default_tagsstring[] nullable required
split_overrideobject nullable

Workspace-level ownership/revenue split override

member_opt_outsstring[] nullable

member_refs of members who opted out of the ownership split (never profile IDs)

planstring nullable

Plan the workspace was created under

created_atstring date-time required
updated_atstring date-time nullable required
expires_atstring date-time nullable

When this workspace expires (None = permanent)

claimed_from_trial_atstring date-time nullable

When this workspace was claimed out of the try-now flow (None if it never was)

meta_engagement_enabledboolean

Facebook and Instagram first comments are switched on here (META_ENGAGEMENT_ENABLED_WORKSPACES, meta_engagement_policy)

Changes

No recorded changes to this operation across all 1 revision of this API.