JUjubjubapp
v2 - Workspaces

Create Workspace

Create a new workspace.

The authenticated user becomes the owner of the workspace.

post/v2/workspaces

Request

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

Headers

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

Request body

namestring required
descriptionstring nullable
cover_image_urlstring nullable
folder_idstring nullable
default_languagestring nullable
default_tagsstring[] nullable
owner_idstring nullable

Owner ID. If not provided, will use authenticated user's ID.

kind'workspace' | 'collection'

'workspace' = project for shipping work. 'collection' = pinboard for grouping references.

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.