/documents/v1/bulk/remove_owners

post

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

Remove owners from multiple files in Documents in a single request. Use this endpoint when you need to remove ownership from files, such as during a team handover, restructure, or repository clean-up.

SafetyCulture removes the owners you provide from the files you specify. 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 remove owners from multiple files.

file_ids

array of strings

The IDs of the files you want to remove owners from.
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 remove as owners.
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 remove 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.