/documents/v1/bulk/add_owners

post

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

Add users or groups as owners to multiple files when you need clear stewardship across your policies, procedures, and reference materials in Documents. This endpoint is useful after a team restructure, handover, or repository clean-up. 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 add owners to multiple files without removing existing owners.

file_ids

array of strings

required

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