Permissions

Create team permissions

Changed on

Creates the permission set for one team, named "<team name> Permissions" (fixed from then on), links it to the team and stores its initial permissions. A team can have one active set. With Shared roles on, send name (and optionally teamIds) instead of teamId to create a named role that can be given to any number of teams; each listed team's current custom role is replaced. You can only turn on permissions you have yourself. Requires permissions.manage (only the owner has it by default), a recent sign-in, and the Permissions feature.

post/v1/permissions/sets

Request

  • Base URL: https://api.openworklabs.com
  • URL: https://api.openworklabs.com/v1/permissions/sets
  • Auth: one of:
    • API key in header x-api-key
    • HTTP bearer

Request body

teamIdstring typeid

The one team this set applies to, named "<team name> Permissions". A team can have one active permission set. Required unless Shared roles is on and name is given.

namestring

Shared roles: the role's name. Required when teamId is left out.

teamIdsstring[]

Shared roles: teams that get this role now. Each team's current custom role is replaced. Left out or empty, the role starts with no team.

Response

Team permission set created.

Changes

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      the request property became optional

    • info

      added the required property /// to the response with the status

    • info

      added the required property / to the response with the status

    • info

      endpoint added