Skip navigation

Skip to main content

Permissions & Settings

Update a Team's Permissions

An actor triggers this event when they update a team permission for a feature. For example, when a user sets MAGIC WRITE to TEAM_ADMINS, users with the TEAM ADMIN team role can access MAGIC WRITE. If an a user adds a group to a feature's team permission, all members of this group will get access to the feature regardless of the members team role.

typestring

Default value: UPDATE_TEAM_PERMISSION

Available values: The only valid value is UPDATE_TEAM_PERMISSION.

team_permissionstring

The feature which the permission controls access too.

Available values:

  • DREAM_STUDIO: Use Dream studio.
  • OFFLINE_DESIGNS: Use Offline Designs.
  • CANVA_AI: Use Canva AI (conversational AI) to brainstorm, write, and create designs.
  • MAGIC_DESIGN: Use Magic Design.
  • MAGIC_EDIT: Use Magic Edit.
  • MAGIC_MEDIA: Use Magic Media.
  • TRANSFORM_INTO_DOC: Use Transform into Doc.
  • MAGIC_WRITE: Use Magic Write.
  • TEMPLATE_LIBRARY: Access the templates library.
  • ASK_CANVA: Ask Canva for AI-generated design advice.
  • NON_INDEMNIFIED_CONTENT: Access elements and fonts not covered by Canva’s IP indemnity.
  • MAGIC_INSIGHTS: Use Magic Insights.
  • CANVA_CODE: Use Canva Code.
  • ACCEPT_COPIED_CONTENT_FROM_ANOTHER_TEAM: Accept copied content from another team.
  • SHARE_DESIGNS_EXTERNALLY_VIA_LINKS: Share designs via public view links⁠(opens in a new tab or window), public embeds⁠(opens in a new tab or window), websites⁠(opens in a new tab or window), and collaboration links⁠(opens in a new tab or window) that can be shared externally.
  • SHARE_DESIGNS_TO_EXTERNAL_EMAILS: Share designs to external emails by design access invitation or directly granting access.
  • COPY_CONTENT_TO_ANOTHER_TEAM: Send copies of their content outside the team.
  • PHOTO_ELEMENTS: Use photo elements.
  • AUDIO_ELEMENTS: Use audio elements.
  • VIDEO_ELEMENTS: Use video elements.
  • GRAPHIC_ELEMENTS: Use graphic elements.
  • STICKER_ELEMENTS: Use sticker elements.
  • CHART_ELEMENTS: Use chart elements.
  • TABLE_ELEMENTS: Use table elements.
  • FRAME_ELEMENTS: Use frame elements.
  • GRID_ELEMENTS: Use grid elements.
  • SHAPE_ELEMENTS: Use shape elements.
  • OTHER_ELEMENTS: Use any other elements.
  • VIEW_EMAILS: See other members email addresses.
  • CREATE_GROUPS: Create groups⁠(opens in a new tab or window).
  • LEAVE_TEAM: Leave a team.
old_team_permission_rolestring
Optional

The team role for a feature. Users who are assigned this team role will access to the feature controlled by the Permission.

Available values:

  • NO_ONE: No team members can use the feature.
  • TEAM_ADMINS: Team admins can use the feature.
  • TEAM_BRAND_DESIGNERS_AND_TEAM_ADMINS: Team designers and admins can use the feature.
  • EVERYONE: All team members can use the feature.
new_team_permission_rolestring
Optional

The team role for a feature. Users who are assigned this team role will access to the feature controlled by the Permission.

Available values:

  • NO_ONE: No team members can use the feature.
  • TEAM_ADMINS: Team admins can use the feature.
  • TEAM_BRAND_DESIGNERS_AND_TEAM_ADMINS: Team designers and admins can use the feature.
  • EVERYONE: All team members can use the feature.
old_groupsAuditLogGroup[]
Optional

The Groups associated with this Permission Setting. Members of a Group included will have access to the feature regardless of the Team Role.

idstring

The group ID.

display_namestring
Optional

The display name of the group.

new_groupsAuditLogGroup[]
Optional

The Groups associated with this Permission Setting. Members of a Group included will have access to the feature regardless of the Team Role.

idstring

The group ID.

display_namestring
Optional

The display name of the group.

Example

{
  "id": ...,
  "timestamp": ...,
  "actor": ...,
  "target": ...,
  "action": {
    "type": "UPDATE_TEAM_PERMISSION",
    "team_permission": "DREAM_STUDIO",
    "old_team_permission_role": "NO_ONE",
    "new_team_permission_role": "NO_ONE",
    "old_groups": [
      {
        "id": "GJViWaMsqhL",
        "display_name": "Marketing Group"
      }
    ],
    "new_groups": [
      {
        "id": "GJViWaMsqhL",
        "display_name": "Marketing Group"
      }
    ]
  },
  "outcome": ...,
  "context": ...
}
JSON

Update an Organization's settings

An actor triggers this event when they update an organization setting.

typestring

Default value: UPDATE_ORGANIZATION_SETTING

Available values: The only valid value is UPDATE_ORGANIZATION_SETTING.

settingstring

The name of the setting that was updated.

Available values:

new_valueboolean
old_valueboolean
Optional

Example

{
  "id": ...,
  "timestamp": ...,
  "actor": ...,
  "target": ...,
  "action": {
    "type": "UPDATE_ORGANIZATION_SETTING",
    "setting": "PERSONAL_TEAM_ARCHIVING_ENABLED",
    "old_value": true,
    "new_value": true
  },
  "outcome": ...,
  "context": ...
}
JSON