SQL Proxy API

Beta ProductSQL Proxy is currently in beta. API endpoints may change.

The SQL Proxy Admin API allows you to manage warehouses, principals (users and service principals), tokens, and jobs compute settings.

Base URL

https://sqlproxy.your-company.datafold.com

All /admin endpoints require Bearer token authentication with a proxy manager token:

curl -H "Authorization: Bearer <proxy-manager-token>" \
  https://sqlproxy.your-company.datafold.com/admin/warehouses

Proxy manager tokens can be created via the API or provisioned during onboarding. Contact your Datafold representative if you need an initial token.

Resource	Endpoints	Description
Warehouses	`/admin/warehouses`	Manage Databricks SQL warehouse configurations
Principals	`/admin/users`, `/admin/service-principals`	Manage users and service principals
Tokens	`/admin/users/{id}/tokens`, `/admin/service-principals/{id}/tokens`, `/admin/proxy-manager/tokens`	Manage authentication tokens
Jobs Compute	`/admin/jobs-compute`	Configure jobs compute routing

Success responses:

{
  "data": { ... },
  "message": "Optional success message"
}

Error responses:

{
  "error_code": "NOT_FOUND",
  "message": "Resource not found"
}

Error Code	HTTP Status	Description
`UNAUTHORIZED`	401	Missing or invalid token
`FORBIDDEN`	403	Token lacks required permissions
`NOT_FOUND`	404	Resource not found
`BAD_REQUEST`	400	Invalid request body
`CONFLICT`	409	Resource already exists
`INTERNAL_ERROR`	500	Server error