v1

latestOpenAPI 3.1.0Apache 2.02026-07-264001921002.3 KB

Access Profiles

Propagate template changes to user copies

Pushes selected fields from the template to every user that holds a copy. Use dry_run: true to preview the impact. By default, accumulated usage is preserved.

post/api/access-profiles/{id}/propagate

Path parameters

idinteger required

Request body

dry_runboolean

fieldsstring[] required

user_idsstring[]

Empty or omitted = all users with a copy of this profile.

group_idsstring[]

Filter by SCIM group or team IDs.

reset_usageboolean

If true, zero out budget and rate-limit usage on cloned rows. Default false (preserves usage).

Response

Propagation result.

affected_usersinteger

failed_usersinteger

skipped_usersinteger

user_idsstring[]

fieldsstring[]

appliedboolean

False on dry run, true when changes were persisted.

vk_sync_errorsstring[]