Consumer Personalization Request

View as Markdown

Get the personalization request for a listingGET /api/2.1/marketplace-consumer/listings/{listing_id}/personalization-requestsList all personalization requestsGET /api/2.1/marketplace-consumer/personalization-requestsCreate a personalization requestPOST /api/2.1/marketplace-consumer/listings/{listing_id}/personalization-requests

PersonalizationRequest object

idstringPublic Preview

consumer_regionobjectPublic Preview

Show child attributesHide child attributes

cloudstringPublic Preview

regionstringPublic Preview

contact_infoobjectPublic Preview

Show child attributesHide child attributes

first_namestringPublic Preview

last_namestringPublic Preview

emailstringPublic Preview

companystringPublic Preview

commentstringPublic Preview

intended_usestringPublic Preview

statusstringPublic Preview

Values:

• NEW
• REQUEST_PENDING
• FULFILLED
• DENIED

status_messagestringPublic Preview

shareobjectPublic Preview

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

Show child attributesHide child attributes

namestringPublic Preview

typestringPublic Preview

Values:

• SAMPLE
• FULL

created_atint64Public Preview

listing_idstringPublic Preview

updated_atint64Public Preview

metastore_idstringPublic Preview

listing_namestringPublic Preview

is_from_lighthousebooleanPublic Preview

provider_idstringPublic Preview

recipient_typestringPublic Preview

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": "NEW",
  "status_message": "string",
  "share": {
    "name": "string",
    "type": "SAMPLE"
  },
  "created_at": 0,
  "listing_id": "string",
  "updated_at": 0,
  "metastore_id": "string",
  "listing_name": "string",
  "is_from_lighthouse": true,
  "provider_id": "string",
  "recipient_type": "DELTA_SHARING_RECIPIENT_TYPE_DATABRICKS"
}

Get the personalization request for a listing Public Preview

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_idstringRequiredpath

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": "NEW",
      "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": "DELTA_SHARING_RECIPIENT_TYPE_DATABRICKS"
    }
  ]
}

List all personalization requests Public Preview

GET /api/2.1/marketplace-consumer/personalization-requests

List personalization requests for a consumer across all listings.

API scopes: marketplace

Parameters

page_tokenstringquery

page_sizeint32query

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": "NEW",
      "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": "DELTA_SHARING_RECIPIENT_TYPE_DATABRICKS"
    }
  ],
  "next_page_token": "string"
}

Create a personalization request Public Preview

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

Create a personalization request for a listing.

API scopes: marketplace

Parameters

listing_idstringRequiredpath

Request body

commentstring

intended_usestringRequired

first_namestring

last_namestring

companystring

is_from_lighthouseboolean

recipient_typestring

Values:

• DELTA_SHARING_RECIPIENT_TYPE_DATABRICKS
• DELTA_SHARING_RECIPIENT_TYPE_OPEN

accepted_consumer_termsobjectRequired

Show child attributesHide child attributes

versionstringRequired

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": "DELTA_SHARING_RECIPIENT_TYPE_DATABRICKS",
  "accepted_consumer_terms": {
    "version": "string"
  }
}

Response

{
  "id": "string"
}