---
title: "Re-parse model SQL"
method: POST
path: "/v1/models/{modelId}/reparse"
tags: ["Models"]
---

# Re-parse model SQL

`POST /v1/models/{modelId}/reparse`

## Request

- Base URL: `https://blobsrus.omniapp.co/api`
- URL: `https://blobsrus.omniapp.co/api/v1/models/{modelId}/reparse`
- Auth: HTTP bearer

<Note>
  **Querier** permissions or higher on a model are required to use this endpoint.
</Note>

Re-parse all SQL fields and views in a shared model or shared extension and refresh their inferred column types. Use this to clear a SQL validation error after resolving the issue - such as a missing database grant - without editing the SQL itself.

Re-parsing the shared model itself, or a branch on a Git follower model, only saves if the result leaves the model's YAML unchanged; otherwise the request fails and nothing is saved. Re-parsing an ordinary branch saves YAML changes normally, such as newly inferred dimensions.

This request runs synchronously and can take several minutes on a large model. If your client times out before it finishes, the re-parse still completes and saves on the server.

## Path parameters

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

## Query parameters

- `branch_id` string, uuid

## Response `200`

Model re-parsed and saved

- SuccessResponse
  - `success` boolean

## Other responses

- `400`: Bad Request Possible causes: - Invalid `modelId`, `branch_id`, or an unknown query parameter - The re-parse would change the YAML of the model itself, or of a branch on a Git follower model
- `401`: Missing or invalid authentication
- `403`: Forbidden Possible causes: - The caller doesn't have permission to edit the model, or its branch if `branch_id` is provided
- `404`: Not Found Possible causes: - Model not found, or deleted - `branch_id` doesn't belong to the model's branch parent
- `405`: Method Not Allowed
- `409`: The model or branch was edited during the re-parse. Retry the request.
- `422`: The model is not a shared model or shared extension, for example a workbook model.
- `429`: Too Many Requests - Rate limit exceeded (60 requests/minute)

## Changes

- **2026-11-03** `43290040f88f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/omni/apis/omni-api/changes/v1/models/:modelId/reparse/post.md)

---

[API](https://skmtc.dev/omni/apis/omni-api.md) - [All operations](https://skmtc.dev/omni/apis/omni-api/llms.txt) - [OpenAPI document](https://skmtc.dev/omni/apis/omni-api/revisions/43290040f88f?raw)
