# The legacy SQL Permissions API is deprecated

Databricks REST API deprecated /api/2.0/preview/sql/permissions/* without giving a shutdown date yet.

Databricks deprecated the legacy SQL Permissions API without a shutdown date. Calls to /api/2.0/preview/sql/permissions/* are deprecated and will fail once removed. Databricks REST API notes that the Permissions API is now marked as deprecated.

## What to use instead

Manage query and alert permissions using the Workspace object permissions API at /api/2.0/permissions/{object_type}/{object_id}. To transfer ownership, use the Queries and Alerts update endpoints.

- API: Databricks REST API (*.cloud.databricks.com)
- Kind: Removal
- Takes effect: no date given yet
- Calls after that day: fail
- Calls it hits: `/api/2.0/preview/sql/permissions/*`
- Source: [Announcement](https://docs.databricks.com/aws/en/sql/dbsql-api-latest)
- Verified: November 6, 2026, against Databricks REST API's own pages
- Page: https://www.okapi.bot/providers/databricks-rest-api/breaking-changes/the-legacy-sql-permissions-api-is-deprecated/

## Databricks REST API's words

> The Permissions API is now marked as deprecated. Use the Workspace API to manage object permissions.

Okapi finds the calls this change hits in your repo and opens the pull request with the fix: https://github.com/apps/okapi-agent