---
title: "Propagate template changes to user copies"
method: POST
path: "/api/access-profiles/{id}/propagate"
tags: ["Access Profiles"]
---

# Propagate template changes to user copies

`POST /api/access-profiles/{id}/propagate`

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.

## Path parameters

- `id` integer, required

## Request body

- object
  - `dry_run` boolean
  - `fields` string[], required
  - `user_ids` string[] — Empty or omitted = all users with a copy of this profile.
  - `group_ids` string[] — Filter by SCIM group or team IDs.
  - `reset_usage` boolean — If true, zero out budget and rate-limit usage on cloned rows. Default false (preserves usage).

## Response `200`

Propagation result.

- object
  - `affected_users` integer
  - `failed_users` integer
  - `skipped_users` integer
  - `user_ids` string[]
  - `fields` string[]
  - `applied` boolean — False on dry run, true when changes were persisted.
  - `vk_sync_errors` string[]

## Other responses

- `400` — Bad request
- `404` — Profile not found
- `500` — Internal server error

---

[API](https://skmtc.net/getbifrost/apis/bifrost-api.md) · [All operations](https://skmtc.net/getbifrost/apis/bifrost-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/getbifrost/bifrost-api/versions/f8cab88f64ea/schema)