---
title: "Databricks Delta Sharing metadata"
method: GET
path: "/api/v1/data/databricks/grant"
tags: ["Distribution"]
---

# Databricks Delta Sharing metadata

`GET /api/v1/data/databricks/grant`

## Request

- Base URL: `https://propraven.com`
- URL: `https://propraven.com/api/v1/data/databricks/grant`
- Auth: API key in cookie `sb-<project-ref>-auth-token`

Returns the Delta Share name, the recipient types, whether delivery is configured and whether the channel is paused, with the channel status and its date. AUTHENTICATED (signed-in session only): an anonymous call gets HTTP 401 from the session gate and an API key is not accepted. Provisioning is POST on the same path from a signed-in session (see https://propraven.com/docs/databricks); while the channel is paused it returns 503 with a waitlist message. That operation is not part of the API-key contract.

## Response `200`

Databricks delivery metadata.

- object
  - `share` string, required
  - `protocol` string, required
  - `recipient_types` string[], required
  - `configured` boolean, required
  - `paused` boolean, required: True while DATABRICKS_CHANNEL_PAUSED is set; POST then returns 503.
  - `status` 'paused' | 'live', required: The published channel status (the same text /docs/databricks shows).
  - `status_as_of` string, date, required
  - `docs` string, required

## Other responses

- `401`: Missing, malformed or invalid credential.
- `405`: The endpoint exists but does not support this method. `Allow` lists the methods it does.
- `500`: Unexpected server error. The body never carries database or driver text.

---

[API](https://skmtc.dev/propraven/apis/propraven-api.md) · [All operations](https://skmtc.dev/propraven/apis/propraven-api/llms.txt) · [OpenAPI document](https://skmtc.dev/propraven/apis/propraven-api/revisions/37f8158c4eda?raw)