Template Settings

Update Template Sharing Settings

Changed on

Replaces the full list of Workspaces this Template is shared with. The caller must be a member of every Workspace being newly shared by this call. Unsharing a Workspace only requires permission to edit the Template.

put/public/v1/templates/{template_id}/shares

Request

Path parameters

template_idstring required

Unique identifier of the Template whose Shares are being replaced.

Request body

workspace_idsstring[] required

Unique identifiers of the Workspaces the Template should be shared with, representing the complete desired end-state rather than a delta. Duplicate ids are deduplicated, and the server replaces the prior shares with this set atomically.

Example request

{
  "workspace_ids": [
    "BhVzRcxH9Z2LgfPPGXFUBa",
    "2eWSKSvVqmuVCnuUK3iWwD"
  ]
}

Response

Successfully replaced the Template's Shares.

workspace_idsstring[] required

Unique identifiers of the Workspaces the Template is currently shared with, reflecting the server state at the time of the response.

Example response

{
  "workspace_ids": [
    "BhVzRcxH9Z2LgfPPGXFUBa",
    "2eWSKSvVqmuVCnuUK3iWwD"
  ]
}

Changes