integrations

Replace a SharePoint connection's site policy

Replaces the WHOLE policy — the complete set of sites this connection may reach, never a delta. expected_policy_version is a compare-and-set guard: send the version the read returned, or omit it to assert there was no policy at all. Either expectation failing is a 409, and the way forward is to re-read and decide against what the policy now says rather than to resend this one. A selection that cannot become a policy is a 422 naming the entry that refused. Authority is the same rule as the read.

Send sites only. The document libraries under them are enumerated here, from the selection, because a drive -> site pair is what admits a call rooted at a drive and a client that could state one would be granting itself reach. That enumeration is live: if it cannot be finished the previous policy is left exactly as it was and the answer is a 503, because a policy naming a site with none of its libraries admits the site and refuses every document in it.

put/v1/integrations/accounts/{account_id}/scope

Request

  • Base URL: https://api.patricia.app (the document declares no server; this is the origin it was published from)
  • URL: https://api.patricia.app/v1/integrations/accounts/{account_id}/scope
  • Auth: HTTP bearer

Path parameters

account_idstring uuid required

Headers

X-Tenant-Idstring nullable

Request body

mode_code'unrestricted' | 'selected_sites' required

Which SharePoint sites a connection may address through Patricia.

  • UNRESTRICTED: anything the Microsoft identity and the reviewed tool surface permit. This is what every connection does today, and what a migration-backfilled row records.
  • SELECTED_SITES: only the canonical site ids named in the policy, and the drive ids materialized under them.

The mode alone never decides access. A row's owner_authored_at says whether a HUMAN chose the policy or a landing insert merely recorded that the connection exists, and only the former is a grant.

sitesstring[]
expected_policy_versioninteger nullable

Response

Successful Response

mode_code'unrestricted' | 'selected_sites' required

Which SharePoint sites a connection may address through Patricia.

  • UNRESTRICTED: anything the Microsoft identity and the reviewed tool surface permit. This is what every connection does today, and what a migration-backfilled row records.
  • SELECTED_SITES: only the canonical site ids named in the policy, and the drive ids materialized under them.

The mode alone never decides access. A row's owner_authored_at says whether a HUMAN chose the policy or a landing insert merely recorded that the connection exists, and only the former is a grant.

policy_versioninteger nullable required
owner_authoredboolean required
sitesstring[] required

Changes

No recorded changes to this operation across all 1 revision of this API.