---
title: "Replace content references"
method: POST
path: "/api/v1/models/{modelId}/content-validator"
tags: ["Models"]
---

# Replace content references

`POST /api/v1/models/{modelId}/content-validator`

## Path parameters

- `modelId` string, uuid, required — Model UUID

## Query parameters

- `userId` string, uuid — Target user membership ID (for org-scoped API keys)

## Request body

- ModelsContentValidatorReplaceBody
  - `branch_id` string — Optional branch ID
  - `creator_id` string, uuid — Restrict replacement to documents created by this user (user ID). Unknown IDs return 400.
  - `find` string, required — The string to find
  - `find_or_replace_type` 'FIELD' | 'TOPIC' | 'VIEW', required — Type of find/replace operation.
  - `folder_paths` string[] — Restrict replacement to documents in matching folder paths (prefix match). Documents with no folder are excluded unless "" is specified.
  - `include_personal_folders` boolean — Whether to include personal folders
  - `labels` string — Comma-separated label names to scope replacement. Unknown labels return 400.
  - `only_in_workbook_id` string — Optional workbook ID to limit the replace scope
  - `replacement` string, required — The replacement string

## Response `200`

Replace operation completed

- ModelsContentValidatorReplaceResponse
  - `replaced_dashboard_filters_count` integer, required — Number of dashboard filters replaced
  - `replaced_documents_count` integer, required — Number of documents modified
  - `replaced_input_column_keys_count` integer, required — Number of input columns whose key references were replaced
  - `replaced_queries_count` integer, required — Number of queries replaced
  - `replaced_workbook_models_count` integer, required — Number of workbook models replaced
  - `skipped_pr_required_count` integer, required — Number of documents skipped due to pull request requirements

## Other responses

- `400` — Invalid request body
- `401` — Authentication required
- `403` — Permission denied
- `404` — Model not found

---

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