Consumer Personalization Request

View as Markdown

GetGET /api/2.1/marketplace-consumer/listings/{listing_id}/personalization-requestsCreatePOST /api/2.1/marketplace-consumer/listings/{listing_id}/personalization-requests

PersonalizationRequest object

idstring

consumer_regionobject

Show child attributesHide child attributes

cloudstring

regionstring

contact_infoobject

Show child attributesHide child attributes

first_namestring

last_namestring

emailstring

companystring

commentstring

intended_usestring

statusstring

Values: NEW, REQUEST_PENDING, FULFILLED, DENIED

status_messagestring

shareobject

Share information is required for data listings but should be empty/ignored for non-data listings (MCP and App).

Show child attributesHide child attributes

namestring

typestring

Values: SAMPLE, FULL

created_atint64

listing_idstring

updated_atint64

metastore_idstring

listing_namestring

is_from_lighthouseboolean

provider_idstring

recipient_typestring

Values: DELTA_SHARING_RECIPIENT_TYPE_DATABRICKS, DELTA_SHARING_RECIPIENT_TYPE_OPEN

View as Markdown

The PersonalizationRequest object

{
  "id": "string",
  "consumer_region": {
    "cloud": "string",
    "region": "string"
  },
  "contact_info": {
    "first_name": "string",
    "last_name": "string",
    "email": "string",
    "company": "string"
  },
  "comment": "string",
  "intended_use": "string",
  "status": "string",
  "status_message": "string",
  "share": {
    "name": "string",
    "type": "string"
  },
  "created_at": 0,
  "listing_id": "string",
  "updated_at": 0,
  "metastore_id": "string",
  "listing_name": "string",
  "is_from_lighthouse": true,
  "provider_id": "string",
  "recipient_type": "string"
}

Get

GET /api/2.1/marketplace-consumer/listings/{listing_id}/personalization-requests

Get the personalization request for a listing. Each consumer can make at most one personalization request for a listing.

API scopes: marketplace

Parameters

listing_idstringpath

Response

Returns a list of PersonalizationRequest objects.

View as Markdown

Response

{
  "personalization_requests": [
    {
      "id": "string",
      "consumer_region": {},
      "contact_info": {},
      "comment": "string",
      "intended_use": "string",
      "status": "string",
      "status_message": "string",
      "share": {},
      "created_at": 0,
      "listing_id": "string",
      "updated_at": 0,
      "metastore_id": "string",
      "listing_name": "string",
      "is_from_lighthouse": true,
      "provider_id": "string",
      "recipient_type": "string"
    }
  ]
}

Create

POST /api/2.1/marketplace-consumer/listings/{listing_id}/personalization-requests

Create a personalization request for a listing.

API scopes: marketplace

Parameters

listing_idstringpath

Request body

commentstring

intended_usestring

first_namestring

last_namestring

companystring

is_from_lighthouseboolean

recipient_typestring

Values: DELTA_SHARING_RECIPIENT_TYPE_DATABRICKS, DELTA_SHARING_RECIPIENT_TYPE_OPEN

accepted_consumer_termsobject

Show child attributesHide child attributes

versionstring

Response

idstring

View as Markdown

Request

{
  "comment": "string",
  "intended_use": "string",
  "first_name": "string",
  "last_name": "string",
  "company": "string",
  "is_from_lighthouse": true,
  "recipient_type": "string",
  "accepted_consumer_terms": {
    "version": "string"
  }
}

Response

{
  "id": "string"
}