> ## Documentation Index > Fetch the complete documentation index at: https://www.canva.dev/docs/audit-logs/llms.txt > Use this file to discover all available pages before exploring further. # Folders ## Update a folder's access controls An `actor` triggers this event when they change the rules that control access to a folder. There can be multiple changes in a single update. **Default value:** `UPDATE_FOLDER_ACCESS_CONTROLS` **Available values:** The only valid value is `UPDATE_FOLDER_ACCESS_CONTROLS`. A change to the rules that control the access to the folder. The owner of the folder changed. For example, when a user left the team, or when the folder moved into or out of a team space. `old_owner` or `new_owner` might be omitted if the folder doesn't have a user owner. For example, when a folder is owned by a team inside a team space. **Default value:** `UPDATE_FOLDER_OWNER` **Available values:** The only valid value is `UPDATE_FOLDER_OWNER`. A Canva user. Properties of old_owner}> The user ID. The display name of the user. For privacy reasons, this field is redacted for users outside of your organization. Rarely, it may also be unavailable for technical reasons. The email address of the user. For privacy reasons, this field is redacted for users outside of your organization. Rarely, it may also be unavailable for technical reasons. A Canva user. Properties of new_owner}> The user ID. The display name of the user. For privacy reasons, this field is redacted for users outside of your organization. Rarely, it may also be unavailable for technical reasons. The email address of the user. For privacy reasons, this field is redacted for users outside of your organization. Rarely, it may also be unavailable for technical reasons. A user granted another user access to the folder. **Default value:** `GRANT_USER_FOLDER_ACCESS` **Available values:** The only valid value is `GRANT_USER_FOLDER_ACCESS`. Whether the folder's content can be viewed, edited, organized or managed. Properties of access}> Whether read access has been provided (`true`) or denied (`false`). Whether write access has been provided (`true`) or denied (`false`). For a folder in a team space, this only includes adding and editing content. Removing and moving content requires `organize`. Whether access to organize content in the folder has been provided (`true`) or denied (`false`). Only applies to folders in a team space. Whether access to administer the folder has been provided (`true`) or denied (`false`). Can only be granted via a team space. A Canva user. Properties of user}> The user ID. The display name of the user. For privacy reasons, this field is redacted for users outside of your organization. Rarely, it may also be unavailable for technical reasons. The email address of the user. For privacy reasons, this field is redacted for users outside of your organization. Rarely, it may also be unavailable for technical reasons. A user revoked another user's access to the folder. **Default value:** `REVOKE_USER_FOLDER_ACCESS` **Available values:** The only valid value is `REVOKE_USER_FOLDER_ACCESS`. A Canva user. Properties of user}> The user ID. The display name of the user. For privacy reasons, this field is redacted for users outside of your organization. Rarely, it may also be unavailable for technical reasons. The email address of the user. For privacy reasons, this field is redacted for users outside of your organization. Rarely, it may also be unavailable for technical reasons. Whether the folder's content can be viewed, edited, organized or managed. Properties of access}> Whether read access has been provided (`true`) or denied (`false`). Whether write access has been provided (`true`) or denied (`false`). For a folder in a team space, this only includes adding and editing content. Removing and moving content requires `organize`. Whether access to organize content in the folder has been provided (`true`) or denied (`false`). Only applies to folders in a team space. Whether access to administer the folder has been provided (`true`) or denied (`false`). Can only be granted via a team space. A user changed another user's access to the folder. **Default value:** `UPDATE_USER_FOLDER_ACCESS` **Available values:** The only valid value is `UPDATE_USER_FOLDER_ACCESS`. Whether the folder's content can be viewed, edited, organized or managed. Properties of old_access}> Whether read access has been provided (`true`) or denied (`false`). Whether write access has been provided (`true`) or denied (`false`). For a folder in a team space, this only includes adding and editing content. Removing and moving content requires `organize`. Whether access to organize content in the folder has been provided (`true`) or denied (`false`). Only applies to folders in a team space. Whether access to administer the folder has been provided (`true`) or denied (`false`). Can only be granted via a team space. Whether the folder's content can be viewed, edited, organized or managed. Properties of new_access}> Whether read access has been provided (`true`) or denied (`false`). Whether write access has been provided (`true`) or denied (`false`). For a folder in a team space, this only includes adding and editing content. Removing and moving content requires `organize`. Whether access to organize content in the folder has been provided (`true`) or denied (`false`). Only applies to folders in a team space. Whether access to administer the folder has been provided (`true`) or denied (`false`). Can only be granted via a team space. A Canva user. Properties of user}> The user ID. The display name of the user. For privacy reasons, this field is redacted for users outside of your organization. Rarely, it may also be unavailable for technical reasons. The email address of the user. For privacy reasons, this field is redacted for users outside of your organization. Rarely, it may also be unavailable for technical reasons. A user granted a [group](https://www.canva.com/help/groups/) access to the folder. **Default value:** `GRANT_GROUP_FOLDER_ACCESS` **Available values:** The only valid value is `GRANT_GROUP_FOLDER_ACCESS`. Whether the folder's content can be viewed, edited, organized or managed. Properties of access}> Whether read access has been provided (`true`) or denied (`false`). Whether write access has been provided (`true`) or denied (`false`). For a folder in a team space, this only includes adding and editing content. Removing and moving content requires `organize`. Whether access to organize content in the folder has been provided (`true`) or denied (`false`). Only applies to folders in a team space. Whether access to administer the folder has been provided (`true`) or denied (`false`). Can only be granted via a team space. A Canva group. Properties of group}> The group ID. The display name of the group. A user revoked a [group's](https://www.canva.com/help/groups/) access to the folder. **Default value:** `REVOKE_GROUP_FOLDER_ACCESS` **Available values:** The only valid value is `REVOKE_GROUP_FOLDER_ACCESS`. A Canva group. Properties of group}> The group ID. The display name of the group. Whether the folder's content can be viewed, edited, organized or managed. Properties of access}> Whether read access has been provided (`true`) or denied (`false`). Whether write access has been provided (`true`) or denied (`false`). For a folder in a team space, this only includes adding and editing content. Removing and moving content requires `organize`. Whether access to organize content in the folder has been provided (`true`) or denied (`false`). Only applies to folders in a team space. Whether access to administer the folder has been provided (`true`) or denied (`false`). Can only be granted via a team space. A user changed a [group's](https://www.canva.com/help/groups/) access to the folder. **Default value:** `UPDATE_GROUP_FOLDER_ACCESS` **Available values:** The only valid value is `UPDATE_GROUP_FOLDER_ACCESS`. Whether the folder's content can be viewed, edited, organized or managed. Properties of old_access}> Whether read access has been provided (`true`) or denied (`false`). Whether write access has been provided (`true`) or denied (`false`). For a folder in a team space, this only includes adding and editing content. Removing and moving content requires `organize`. Whether access to organize content in the folder has been provided (`true`) or denied (`false`). Only applies to folders in a team space. Whether access to administer the folder has been provided (`true`) or denied (`false`). Can only be granted via a team space. Whether the folder's content can be viewed, edited, organized or managed. Properties of new_access}> Whether read access has been provided (`true`) or denied (`false`). Whether write access has been provided (`true`) or denied (`false`). For a folder in a team space, this only includes adding and editing content. Removing and moving content requires `organize`. Whether access to organize content in the folder has been provided (`true`) or denied (`false`). Only applies to folders in a team space. Whether access to administer the folder has been provided (`true`) or denied (`false`). Can only be granted via a team space. A Canva group. Properties of group}> The group ID. The display name of the group. A user granted a [team](https://www.canva.com/help/create-teams/) access to the folder. **Default value:** `GRANT_TEAM_FOLDER_ACCESS` **Available values:** The only valid value is `GRANT_TEAM_FOLDER_ACCESS`. Whether the folder's content can be viewed, edited, organized or managed. Properties of access}> Whether read access has been provided (`true`) or denied (`false`). Whether write access has been provided (`true`) or denied (`false`). For a folder in a team space, this only includes adding and editing content. Removing and moving content requires `organize`. Whether access to organize content in the folder has been provided (`true`) or denied (`false`). Only applies to folders in a team space. Whether access to administer the folder has been provided (`true`) or denied (`false`). Can only be granted via a team space. A Canva team. Properties of team}> The team ID. The display name of the team. For privacy reasons, this field is redacted for brands outside of your organization. Rarely, it may be unavailable for technical reasons. A user revoked a [team's](https://www.canva.com/help/create-teams/) access to the folder. **Default value:** `REVOKE_TEAM_FOLDER_ACCESS` **Available values:** The only valid value is `REVOKE_TEAM_FOLDER_ACCESS`. A Canva team. Properties of team}> The team ID. The display name of the team. For privacy reasons, this field is redacted for brands outside of your organization. Rarely, it may be unavailable for technical reasons. Whether the folder's content can be viewed, edited, organized or managed. Properties of access}> Whether read access has been provided (`true`) or denied (`false`). Whether write access has been provided (`true`) or denied (`false`). For a folder in a team space, this only includes adding and editing content. Removing and moving content requires `organize`. Whether access to organize content in the folder has been provided (`true`) or denied (`false`). Only applies to folders in a team space. Whether access to administer the folder has been provided (`true`) or denied (`false`). Can only be granted via a team space. A user changed a [team's](https://www.canva.com/help/create-teams/) access to the folder. **Default value:** `UPDATE_TEAM_FOLDER_ACCESS` **Available values:** The only valid value is `UPDATE_TEAM_FOLDER_ACCESS`. Whether the folder's content can be viewed, edited, organized or managed. Properties of old_access}> Whether read access has been provided (`true`) or denied (`false`). Whether write access has been provided (`true`) or denied (`false`). For a folder in a team space, this only includes adding and editing content. Removing and moving content requires `organize`. Whether access to organize content in the folder has been provided (`true`) or denied (`false`). Only applies to folders in a team space. Whether access to administer the folder has been provided (`true`) or denied (`false`). Can only be granted via a team space. Whether the folder's content can be viewed, edited, organized or managed. Properties of new_access}> Whether read access has been provided (`true`) or denied (`false`). Whether write access has been provided (`true`) or denied (`false`). For a folder in a team space, this only includes adding and editing content. Removing and moving content requires `organize`. Whether access to organize content in the folder has been provided (`true`) or denied (`false`). Only applies to folders in a team space. Whether access to administer the folder has been provided (`true`) or denied (`false`). Can only be granted via a team space. A Canva team. Properties of team}> The team ID. The display name of the team. For privacy reasons, this field is redacted for brands outside of your organization. Rarely, it may be unavailable for technical reasons. A user granted an organization access to the folder. **Default value:** `GRANT_ORGANIZATION_FOLDER_ACCESS` **Available values:** The only valid value is `GRANT_ORGANIZATION_FOLDER_ACCESS`. Whether the folder's content can be viewed, edited, organized or managed. Properties of access}> Whether read access has been provided (`true`) or denied (`false`). Whether write access has been provided (`true`) or denied (`false`). For a folder in a team space, this only includes adding and editing content. Removing and moving content requires `organize`. Whether access to organize content in the folder has been provided (`true`) or denied (`false`). Only applies to folders in a team space. Whether access to administer the folder has been provided (`true`) or denied (`false`). Can only be granted via a team space. A Canva organization. Properties of organization}> The organization ID. The display name of the organization. For privacy reasons, this field is redacted for organizations other than your organization. Rarely, it may be unavailable for technical reasons. A user revoked an organization's access to the folder. **Default value:** `REVOKE_ORGANIZATION_FOLDER_ACCESS` **Available values:** The only valid value is `REVOKE_ORGANIZATION_FOLDER_ACCESS`. A Canva organization. Properties of organization}> The organization ID. The display name of the organization. For privacy reasons, this field is redacted for organizations other than your organization. Rarely, it may be unavailable for technical reasons. Whether the folder's content can be viewed, edited, organized or managed. Properties of access}> Whether read access has been provided (`true`) or denied (`false`). Whether write access has been provided (`true`) or denied (`false`). For a folder in a team space, this only includes adding and editing content. Removing and moving content requires `organize`. Whether access to organize content in the folder has been provided (`true`) or denied (`false`). Only applies to folders in a team space. Whether access to administer the folder has been provided (`true`) or denied (`false`). Can only be granted via a team space. A user changed an organization's access to the folder. **Default value:** `UPDATE_ORGANIZATION_FOLDER_ACCESS` **Available values:** The only valid value is `UPDATE_ORGANIZATION_FOLDER_ACCESS`. Whether the folder's content can be viewed, edited, organized or managed. Properties of old_access}> Whether read access has been provided (`true`) or denied (`false`). Whether write access has been provided (`true`) or denied (`false`). For a folder in a team space, this only includes adding and editing content. Removing and moving content requires `organize`. Whether access to organize content in the folder has been provided (`true`) or denied (`false`). Only applies to folders in a team space. Whether access to administer the folder has been provided (`true`) or denied (`false`). Can only be granted via a team space. Whether the folder's content can be viewed, edited, organized or managed. Properties of new_access}> Whether read access has been provided (`true`) or denied (`false`). Whether write access has been provided (`true`) or denied (`false`). For a folder in a team space, this only includes adding and editing content. Removing and moving content requires `organize`. Whether access to organize content in the folder has been provided (`true`) or denied (`false`). Only applies to folders in a team space. Whether access to administer the folder has been provided (`true`) or denied (`false`). Can only be granted via a team space. A Canva organization. Properties of organization}> The organization ID. The display name of the organization. For privacy reasons, this field is redacted for organizations other than your organization. Rarely, it may be unavailable for technical reasons. ### Example ## Add an item to a folder An `actor` triggers this event when they add an item to a folder. **Default value:** `ADD_ITEM_TO_FOLDER` **Available values:** The only valid value is `ADD_ITEM_TO_FOLDER`. An item in a folder, such as a [design](https://www.canva.dev/docs/audit-logs/what-are-designs-folders-and-assets/#designs). `owner` is omitted when the item is owned by a team space, as team spaces have no user owner. Properties of item} defaultExpanded={true}> The type of item. **Available values:** * `FOLDER`: A folder. * `DESIGN`: A design. * `IMAGE`: An image. * `VIDEO`: A video. * `AUDIO`: An audio. * `TEMPLATE`: A template. * `FILE`: A file. The item ID. A Canva team. Properties of team}> The team ID. The display name of the team. For privacy reasons, this field is redacted for brands outside of your organization. Rarely, it may be unavailable for technical reasons. A Canva user. Properties of owner}> The user ID. The display name of the user. For privacy reasons, this field is redacted for users outside of your organization. Rarely, it may also be unavailable for technical reasons. The email address of the user. For privacy reasons, this field is redacted for users outside of your organization. Rarely, it may also be unavailable for technical reasons. The display name of the item. Rarely, it may be omitted for technical reasons. ### Example ## Remove an item from a folder An `actor` triggers this event when they remove an item from a folder. **Default value:** `REMOVE_ITEM_FROM_FOLDER` **Available values:** The only valid value is `REMOVE_ITEM_FROM_FOLDER`. An item in a folder, such as a [design](https://www.canva.dev/docs/audit-logs/what-are-designs-folders-and-assets/#designs). `owner` is omitted when the item is owned by a team space, as team spaces have no user owner. Properties of item} defaultExpanded={true}> The type of item. **Available values:** * `FOLDER`: A folder. * `DESIGN`: A design. * `IMAGE`: An image. * `VIDEO`: A video. * `AUDIO`: An audio. * `TEMPLATE`: A template. * `FILE`: A file. The item ID. A Canva team. Properties of team}> The team ID. The display name of the team. For privacy reasons, this field is redacted for brands outside of your organization. Rarely, it may be unavailable for technical reasons. A Canva user. Properties of owner}> The user ID. The display name of the user. For privacy reasons, this field is redacted for users outside of your organization. Rarely, it may also be unavailable for technical reasons. The email address of the user. For privacy reasons, this field is redacted for users outside of your organization. Rarely, it may also be unavailable for technical reasons. The display name of the item. Rarely, it may be omitted for technical reasons. ### Example ## Request access to a folder An `actor` triggers this event when they request access to a folder. This request is sent to the owner of the folder. **Default value:** `REQUEST_FOLDER_ACCESS` **Available values:** The only valid value is `REQUEST_FOLDER_ACCESS`. ### Example ## Grant access to a folder An `actor` (typically the folder `owner`) triggers this event when they grant the `requester` access to their folder. **Default value:** `GRANT_FOLDER_ACCESS` **Available values:** The only valid value is `GRANT_FOLDER_ACCESS`. A Canva user. Properties of requester} defaultExpanded={true}> The user ID. The display name of the user. For privacy reasons, this field is redacted for users outside of your organization. Rarely, it may also be unavailable for technical reasons. The email address of the user. For privacy reasons, this field is redacted for users outside of your organization. Rarely, it may also be unavailable for technical reasons. A user's access level for a folder. **Available values:** * `VIEW`: The user can view the folder and its contents. * `EDIT`: The user can view and edit the folder and its contents. * `ADMIN`: The user can view, edit, and modify access to the folder and its contents. * `ORGANIZE`: The user can view, edit, and organize the folder and its contents. This access level applies only to folders in a Team Space. ### Example