Sapience icon

Sapience

Sapience API integration

Actions11

File → Change Scope

AI-generated

Summary

Change the scope (visibility) of a file in Sapience between private (user) and organization-wide (org).

Inputs

  • fileUid (required) — The unique identifier of the file whose scope will be changed.
  • scope (required) — Target visibility for the file. 'user' keeps the file visible only to the owner; 'org' makes it visible to all organization members.
  • confirmScopeChange — Confirmation flag for the action (present in the UI but not sent to the API).

Output shape

Array of one object per input item.

On success, returns an object with success: true, fileUid, newScope (matching the requested scope), a message string, and any additional fields returned by the Sapience API. Errors (e.g., file not found or insufficient permissions) are thrown as node errors and halt execution unless Continue On Fail is enabled.

Examples

Example 1: Make a file organization‑wide.

File UID = file-j5kk6mcAYcTEpYM, Scope = org, Confirm Scope Change = true

Links

Discussion