Refresh schema

<Note> This endpoint requires either **Connection Admin** or **Modeler** permissions:

• Modelers can use this endpoint on connections that have exactly one shared model
• Connection Admins can use this endpoint on any connection they are an admin of, whether the connection has one or multiple models </Note>

Refresh the schema of the specified model. This will cause the model to reflect the latest changes to schemas, views, and fields from the data source. Schema refreshes will remove structures that are no longer present in the source, but not anything created by users.

Depending on whether the Branch-based schema refresh setting is configured:

• If Branch-based schema refresh is enabled, the branch_id query parameter is required. The branch_id is validated against the shared model.
• If Branch-based schema refresh isn't enabled, do not provide the branch_id parameter. The API will return a 400 error in this case.

{
  "status": "running"
}