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.
  • SCHEDULE_POSTS_WITH_CONTENT_PLANNER: Schedule posts with the Content Planner.
  • CANVA_PRINT: Use Canva Print.
  • DOWNLOAD_DESIGNS: Download designs or selected elements.
  • 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.
  • REFERENCE_TEAM_CONTENT_FOR_AI_GENERATED_RESPONSES: Reference team documents when using AI to generate content.
  • MAGIC_ACTIVITIES: Use Magic Activities.
  • GROW_CREATE: Use Canva Grow Create
  • GROW_INSIGHTS: Use Canva Grow Insights
  • GROW_INSPIRE: Use Canva Grow Inspire
  • CONNECT_AD_ACCOUNTS: Connect Ad Accounts to Canva Grow
  • MAGIC_BACKGROUND: Use Magic Background.
  • PUBLISH_TO_WEBSITE_DOMAIN: Publish to a website domain.
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 Permissions

An actor triggers this event when they update an organization's default permission for a feature. For example, when an organization admin sets MAGIC WRITE to TEAM_ADMINS, all users in the organization with the TEAM ADMIN team role can access MAGIC WRITE. An organization admin is able to specify whether this default permission value is overrideable by team level admins.

typestring

Default value: UPDATE_ORGANIZATION_PERMISSION

Available values: The only valid value is UPDATE_ORGANIZATION_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.
  • SCHEDULE_POSTS_WITH_CONTENT_PLANNER: Schedule posts with the Content Planner.
  • CANVA_PRINT: Use Canva Print.
  • DOWNLOAD_DESIGNS: Download designs or selected elements.
  • 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.
  • REFERENCE_TEAM_CONTENT_FOR_AI_GENERATED_RESPONSES: Reference team documents when using AI to generate content.
  • MAGIC_ACTIVITIES: Use Magic Activities.
  • GROW_CREATE: Use Canva Grow Create
  • GROW_INSIGHTS: Use Canva Grow Insights
  • GROW_INSPIRE: Use Canva Grow Inspire
  • CONNECT_AD_ACCOUNTS: Connect Ad Accounts to Canva Grow
  • MAGIC_BACKGROUND: Use Magic Background.
  • PUBLISH_TO_WEBSITE_DOMAIN: Publish to a website domain.
old_team_overrides_enabledboolean
Optional

Whether or not the team permission was overrideable by team admins previously.

new_team_overrides_enabledboolean
Optional

Whether or not the team permission is overrideable by team admins currently.

old_team_permission_role_defaultstring
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_role_defaultstring
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.

Example

{
  "id": ...,
  "timestamp": ...,
  "actor": ...,
  "target": ...,
  "action": {
    "type": "UPDATE_ORGANIZATION_PERMISSION",
    "team_permission": "DREAM_STUDIO",
    "old_team_overrides_enabled": true,
    "new_team_overrides_enabled": true,
    "old_team_permission_role_default": "NO_ONE",
    "new_team_permission_role_default": "NO_ONE"
  },
  "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:

  • PERSONAL_TEAM_ARCHIVING_ENABLED: Automatically archive any personal teams⁠(opens in a new tab or window) that your managed members may have.
  • SHARE_DESIGNS_WITH_CANVA_SUPPORT_ENABLED: Allows or prevents members of a Canva organization from temporarily sharing affected designs with Canva Support during support requests.
  • INVESTIGATIONS_ENABLED: Allows organisation admins to access private content that hasn’t been shared with them. This access is for security and compliance investigations only and is always audit logged.
  • DESIGN_ACTIVITY_REPORT_ENABLED: When turned on, admins can access the design activity report which shows insights about team designs.
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

Update data residency region

An actor triggers this event when they update the data residency region.

typestring

Default value: UPDATE_DATA_RESIDENCY_REGION_SETTING

Available values: The only valid value is UPDATE_DATA_RESIDENCY_REGION_SETTING.

new_regionstring

The data residency region.

Available values:

  • US: United States
  • EU: Europe
  • ANY: No preference
old_regionstring
Optional

The data residency region.

Available values:

  • US: United States
  • EU: Europe
  • ANY: No preference

Example

{
  "id": ...,
  "timestamp": ...,
  "actor": ...,
  "target": ...,
  "action": {
    "type": "UPDATE_DATA_RESIDENCY_REGION_SETTING",
    "old_region": "US",
    "new_region": "US"
  },
  "outcome": ...,
  "context": ...
}
JSON