/documents/v1/bulk/update_owners

post

https://api.safetyculture.io/documents/v1/bulk/update_owners

Replace the owners on multiple files in Documents in a single request. Use this endpoint when you need to reset ownership to a specific set of users or groups, such as during a team handover, restructure, or repository clean-up.

SafetyCulture replaces the full owner list on each file with the owners you provide and removes any existing owners that you do not include. Each file supports up to 5 owners, and this request accepts up to 100 file IDs.

File ownership focuses on accountability and filtering by owner. It does not replace file and folder access controls, which manage who can view or edit files and folders.

Requirements

SafetyCulture Premium Plan or Enterprise Plan
"Documents: Administration" permission
Full seat
"Edit" document access
Get entity IDs (files, users, or groups)

Body Params

Request to update and replace the existing owners of multiple files.

file_ids

array of strings

required

The IDs of the files you want to update the owners of.
To get the file_id, open the file in the SafetyCulture web app and copy the last part of the URL.
For example, in this link https://app.safetyculture.com/documents/document/765aa2e6-69cb-43b5-8ab4-48ab26e2a094,
the file ID is 765aa2e6-69cb-43b5-8ab4-48ab26e2a094.

file_ids*

user_ids

array of strings

The IDs of the users you want to add as owners. Existing owners will be removed.
To get the user_id, open the user in the SafetyCulture web app and copy the last part of the URL before /profile.
For example, in this link https://app.safetyculture.com/organisation/role_d7b113c0c6774a59b8cfdea1ab1da89a/users/user_7a7cddac38ac4dd197304ba0d05b981a/profile,
the user ID is user_7a7cddac38ac4dd197304ba0d05b981a.

user_ids

group_ids

array of strings

The IDs of the groups you want to add as owners.
To get the group_id, open the group in the SafetyCulture web app and copy the last part of the URL before /users.
For example, in this link https://app.safetyculture.com/organisation/role_d7b113c0c6774a59b8cfdea1ab1da89a/groups/role_1ebbbca147644b5aa4ea646429f941e7/users,
the group ID is role_1ebbbca147644b5aa4ea646429f941e7.

group_ids

Responses

Requirements

200A successful response.

defaultAn unexpected error response.