Manage Data Products

Private preview: The Marketplace app is available to select accounts. Contact your Immuta representative for details.

Data product managers are able to publish and manage data products.

Requirement: Immuta permission GOVERNANCE or Manage Data Product in a domain

Publishing a data product

With the UI

From the Marketplace app,

1. Click Publish product.

2. Select the Domain from the dropdown. You will only be able to include data source from this domain in your data product. If you do not see a domain available, create one with at least one data source.

3. Click Next.

4. Select the data sources you want in the data product. If you do not see a data source you expected to see, it is not in the domain you selected.

5. Click Next.

6. Enter the following metadata for your new data product:

   • Name of the data product

   • Description of the data product (optional)

   • Enter the subject matter expert (optional). This should be a user that data consumers and stewards can reach out to for any questions about the data product.

7. Click Next.

8. Choose if you would like to require approval for access to this data product:

   • Yes: When the user requests access, in addition to acknowledging the data use agreement and answering the required question, they will need to be approved by one of the approvers. Approvers must have the global GOVERNANCE or domain-specific Manage Data Products permission.

   • No: When the user requests access, they will be automatically approved once they acknowledge the data use agreement and answer any question required for access.

9. Add a data use agreement (optional). You can create a data use agreement yourself or use the default data use agreement. The data use agreement is what the data consumer must agree to when requesting access to your data product.

10. Click Publish data product.

With the API

Ensure you set the correct global segment and use a Marketplace-specific personal access token (PAT) when using the Marketplace API. See the Marketplace API docs for additional guidance or to download the OpenAPI YAML for your own client generation.

Add new data products to the marketplace

post

Add one or more data products to the marketplace

Authorizations

Body

namestring · min: 1 · max: 64required

Data product name

Example: SalesPattern: ^[a-zA-Z0-9)(\-_/\\\s]*$

descriptionone of | nullableoptional

Data product description

Data product description

domainsstring[]requiredExample: ["4d004a3a-4568-4c1d-822e-30958ef898dc"]

approvalPolicyIdone ofrequired

statusstring · enumoptionalExample: PENDINGAvailable options:

statsobjectoptional

Data product statistics

sourceTypesstring[]optional

The types of data sources contained in the data product.

Example: ["Databricks","Redshift","Snowflake"]

dataUsageAgreementsobject[]optional

idstring · uuidoptional

Data product ID

dataSourcesobject[]required

metadataone of | nullablerequired

Responses

application/json

objectoptional

post

HTTPcURLJavaScriptPython

POST /marketplace/api/data-product HTTP/1.1
Host: na.api.immutacloud.com
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 613

{
  "name": "Sales",
  "description": "All sales records from the current fiscal year",
  "domains": [
    "4d004a3a-4568-4c1d-822e-30958ef898dc"
  ],
  "approvalPolicyId": "text",
  "status": "PENDING",
  "stats": {
    "dataSourceCount": 1,
    "pendingRequestCount": 1,
    "approvedRequestCount": 1,
    "revokedRequestCount": 1,
    "canceledRequestCount": 1,
    "deniedRequestCount": 1,
    "totalRequestCount": 1
  },
  "sourceTypes": [
    "Databricks",
    "Redshift",
    "Snowflake"
  ],
  "dataUsageAgreements": [
    {
      "id": "text",
      "name": "text"
    }
  ],
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "dataSources": [
    {
      "sourceId": "text"
    }
  ],
  "metadata": {
    "subjectMatterExpert": {
      "id": "123e4567-e89b-12d3-a456-426614174000"
    }
  }
}

{
  "id": "text",
  "name": "Sales",
  "description": "All sales records from the current fiscal year",
  "domains": [
    "4d004a3a-4568-4c1d-822e-30958ef898dc"
  ],
  "suspended": false,
  "createdBy": "123e4567-e89b-12d3-a456-426614174000",
  "createdAt": "2025-04-16T02:07:23.285Z",
  "updatedAt": "2025-04-16T02:07:23.285Z",
  "approvalPolicyId": "text",
  "status": "PENDING",
  "stats": {
    "dataSourceCount": 1,
    "pendingRequestCount": 1,
    "approvedRequestCount": 1,
    "revokedRequestCount": 1,
    "canceledRequestCount": 1,
    "deniedRequestCount": 1,
    "totalRequestCount": 1
  },
  "requestId": "text",
  "sourceTypes": [
    "Databricks",
    "Redshift",
    "Snowflake"
  ],
  "metadata": {
    "subjectMatterExpert": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "username": "text"
    }
  },
  "dataUsageAgreements": [
    {
      "id": "text",
      "name": "text"
    }
  ]
}

There is a short term limitation with the Marketplace app where adding data sources to a data product with active subscription policies set to Always Require could result in currently subscribed users losing access.

Editing data products

Once a data product has been published, many components can be edited from different parts of the data product:

• Details: Edit the name, description, or subject matter expert

• Data sources: Add or remove data sources from the data product

• Request policy: Edit the required approval or the data use agreement

With the UI

From the Marketplace app,

1. Select the data product.

2. Navigate to the tab with the information you want to edit.

3. Click Edit.

4. Make your edits and click Save.

With the API

Ensure you set the correct global segment and use a Marketplace-specific personal access token (PAT) when using the Marketplace API. See the Marketplace API docs for additional guidance or to download the OpenAPI YAML for your own client generation.

Update the request settings

To update the request settings of a data product:

1. Run POST /api/approval-policy : Use the ID from the response in the next call.

2. Run PUT/api/data-product/{id} : The ID in the request should be the data product ID and the approval policy ID from the previous call should be included in the payload.

Create an approval policy

post

Creates a new approval policy based on the provided policy JSON

Authorizations

Body

policyJSONobjectrequired

Responses

application/json

objectoptional

post

HTTPcURLJavaScriptPython

POST /marketplace/api/approval-policy HTTP/1.1
Host: na.api.immutacloud.com
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 176

{
  "policyJSON": {
    "policyVersion": "text",
    "dataAccessAgreements": [
      "text"
    ],
    "reason": "text",
    "stages": [
      {
        "name": "text",
        "required": [
          {
            "type": "USER",
            "id": "text",
            "displayName": "text"
          }
        ]
      }
    ]
  }
}

200Success

{
  "id": "text",
  "policyJSON": {
    "policyVersion": "text",
    "dataAccessAgreements": [
      "text"
    ],
    "reason": "text",
    "stages": [
      {
        "name": "text",
        "required": [
          {
            "type": "USER",
            "id": "text",
            "displayName": "text"
          }
        ]
      }
    ]
  }
}

Update an existing data product

put

Update an existing data product by ID

Authorizations

Path parameters

idstringrequired

Body

namestring · min: 1 · max: 64optional

Data product name

Example: SalesPattern: ^[a-zA-Z0-9)(\-_/\\\s]*$

descriptionone of | nullableoptional

Data product description

Data product description

domainsstring[]optionalExample: ["4d004a3a-4568-4c1d-822e-30958ef898dc"]

approvalPolicyIdone ofoptional

statusstring · enumoptionalExample: PENDINGAvailable options:

statsobjectoptional

Data product statistics

sourceTypesstring[]optional

The types of data sources contained in the data product.

Example: ["Databricks","Redshift","Snowflake"]

dataUsageAgreementsobject[]optional

idstring · uuidoptional

Data product ID

dataSourcesobject[]optional

metadataone of | nullableoptional

suspendedbooleanoptional

Whether access to the data product's data sources are suspended

Example: false

Responses

application/json

objectoptional

put

HTTPcURLJavaScriptPython

PUT /marketplace/api/data-product/{id} HTTP/1.1
Host: na.api.immutacloud.com
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 631

{
  "name": "Sales",
  "description": "All sales records from the current fiscal year",
  "domains": [
    "4d004a3a-4568-4c1d-822e-30958ef898dc"
  ],
  "approvalPolicyId": "text",
  "status": "PENDING",
  "stats": {
    "dataSourceCount": 1,
    "pendingRequestCount": 1,
    "approvedRequestCount": 1,
    "revokedRequestCount": 1,
    "canceledRequestCount": 1,
    "deniedRequestCount": 1,
    "totalRequestCount": 1
  },
  "sourceTypes": [
    "Databricks",
    "Redshift",
    "Snowflake"
  ],
  "dataUsageAgreements": [
    {
      "id": "text",
      "name": "text"
    }
  ],
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "dataSources": [
    {
      "sourceId": "text"
    }
  ],
  "metadata": {
    "subjectMatterExpert": {
      "id": "123e4567-e89b-12d3-a456-426614174000"
    }
  },
  "suspended": false
}

200Success

{
  "id": "text",
  "name": "Sales",
  "description": "All sales records from the current fiscal year",
  "domains": [
    "4d004a3a-4568-4c1d-822e-30958ef898dc"
  ],
  "suspended": false,
  "createdBy": "123e4567-e89b-12d3-a456-426614174000",
  "createdAt": "2025-04-16T02:07:23.285Z",
  "updatedAt": "2025-04-16T02:07:23.285Z",
  "approvalPolicyId": "text",
  "status": "PENDING",
  "stats": {
    "dataSourceCount": 1,
    "pendingRequestCount": 1,
    "approvedRequestCount": 1,
    "revokedRequestCount": 1,
    "canceledRequestCount": 1,
    "deniedRequestCount": 1,
    "totalRequestCount": 1
  },
  "requestId": "text",
  "sourceTypes": [
    "Databricks",
    "Redshift",
    "Snowflake"
  ],
  "metadata": {
    "subjectMatterExpert": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "username": "text"
    }
  },
  "dataUsageAgreements": [
    {
      "id": "text",
      "name": "text"
    }
  ]
}

Update the data sources

Ensure you set the correct global segment and use a Marketplace-specific personal access token (PAT) when using the Marketplace API. See the Marketplace API docs for additional guidance or to download the OpenAPI YAML for your own client generation.

To update data sources associated with a data product:

Update the data product's data sources

put

Update the data sources associated with the data product. Any currently associated data sources not included in the payload will be removed.

Authorizations

Path parameters

idstringrequired

Body

dataSourcesobject[]required

Responses

application/json

objectoptional

put

HTTPcURLJavaScriptPython

PUT /marketplace/api/data-product/{id}/datasources HTTP/1.1
Host: na.api.immutacloud.com
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 37

{
  "dataSources": [
    {
      "sourceId": "text"
    }
  ]
}

200Success

{
  "id": "text",
  "name": "Sales",
  "description": "All sales records from the current fiscal year",
  "domains": [
    "4d004a3a-4568-4c1d-822e-30958ef898dc"
  ],
  "suspended": false,
  "createdBy": "123e4567-e89b-12d3-a456-426614174000",
  "createdAt": "2025-04-16T02:07:23.285Z",
  "updatedAt": "2025-04-16T02:07:23.285Z",
  "approvalPolicyId": "text",
  "status": "PENDING",
  "stats": {
    "dataSourceCount": 1,
    "pendingRequestCount": 1,
    "approvedRequestCount": 1,
    "revokedRequestCount": 1,
    "canceledRequestCount": 1,
    "deniedRequestCount": 1,
    "totalRequestCount": 1
  },
  "requestId": "text",
  "sourceTypes": [
    "Databricks",
    "Redshift",
    "Snowflake"
  ],
  "metadata": {
    "subjectMatterExpert": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "username": "text"
    }
  },
  "dataUsageAgreements": [
    {
      "id": "text",
      "name": "text"
    }
  ]
}

Suspend access to data products

Data products can be suspended. Suspending access revokes all access to data sources in the data product that was gained from the manual approvals in the Marketplace. However, the data product access can be resumed to grant the approvals again.

With the UI

From the Marketplace app,

1. Select the data product.

2. Navigate to the Settings tab.

3. Select Suspend access and then click Suspend access on the modal.

With the API

Ensure you set the correct global segment and use a Marketplace-specific personal access token (PAT) when using the Marketplace API. See the Marketplace API docs for additional guidance or to download the OpenAPI YAML for your own client generation.

Update the suspended parameter using the endpoint below:

Update an existing data product

put

Update an existing data product by ID

Authorizations

Path parameters

idstringrequired

Body

namestring · min: 1 · max: 64optional

Data product name

Example: SalesPattern: ^[a-zA-Z0-9)(\-_/\\\s]*$

descriptionone of | nullableoptional

Data product description

Data product description

domainsstring[]optionalExample: ["4d004a3a-4568-4c1d-822e-30958ef898dc"]

approvalPolicyIdone ofoptional

statusstring · enumoptionalExample: PENDINGAvailable options:

statsobjectoptional

Data product statistics

sourceTypesstring[]optional

The types of data sources contained in the data product.

Example: ["Databricks","Redshift","Snowflake"]

dataUsageAgreementsobject[]optional

idstring · uuidoptional

Data product ID

dataSourcesobject[]optional

metadataone of | nullableoptional

suspendedbooleanoptional

Whether access to the data product's data sources are suspended

Example: false

Responses

application/json

objectoptional

put

HTTPcURLJavaScriptPython

PUT /marketplace/api/data-product/{id} HTTP/1.1
Host: na.api.immutacloud.com
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 631

{
  "name": "Sales",
  "description": "All sales records from the current fiscal year",
  "domains": [
    "4d004a3a-4568-4c1d-822e-30958ef898dc"
  ],
  "approvalPolicyId": "text",
  "status": "PENDING",
  "stats": {
    "dataSourceCount": 1,
    "pendingRequestCount": 1,
    "approvedRequestCount": 1,
    "revokedRequestCount": 1,
    "canceledRequestCount": 1,
    "deniedRequestCount": 1,
    "totalRequestCount": 1
  },
  "sourceTypes": [
    "Databricks",
    "Redshift",
    "Snowflake"
  ],
  "dataUsageAgreements": [
    {
      "id": "text",
      "name": "text"
    }
  ],
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "dataSources": [
    {
      "sourceId": "text"
    }
  ],
  "metadata": {
    "subjectMatterExpert": {
      "id": "123e4567-e89b-12d3-a456-426614174000"
    }
  },
  "suspended": false
}

200Success

{
  "id": "text",
  "name": "Sales",
  "description": "All sales records from the current fiscal year",
  "domains": [
    "4d004a3a-4568-4c1d-822e-30958ef898dc"
  ],
  "suspended": false,
  "createdBy": "123e4567-e89b-12d3-a456-426614174000",
  "createdAt": "2025-04-16T02:07:23.285Z",
  "updatedAt": "2025-04-16T02:07:23.285Z",
  "approvalPolicyId": "text",
  "status": "PENDING",
  "stats": {
    "dataSourceCount": 1,
    "pendingRequestCount": 1,
    "approvedRequestCount": 1,
    "revokedRequestCount": 1,
    "canceledRequestCount": 1,
    "deniedRequestCount": 1,
    "totalRequestCount": 1
  },
  "requestId": "text",
  "sourceTypes": [
    "Databricks",
    "Redshift",
    "Snowflake"
  ],
  "metadata": {
    "subjectMatterExpert": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "username": "text"
    }
  },
  "dataUsageAgreements": [
    {
      "id": "text",
      "name": "text"
    }
  ]
}

Deleting data products

It is also possible to delete data products, which will remove all users' access to the data sources within the data product. Deleting a data product cannot be undone.

With the UI

From the Marketplace app,

1. Select the data product.

2. Navigate to the Settings tab.

3. Click Delete data product.

4. Enter the name of your data product in the textbox and then click Delete again.

With the API

Ensure you set the correct global segment and use a Marketplace-specific personal access token (PAT) when using the Marketplace API. See the Marketplace API docs for additional guidance or to download the OpenAPI YAML for your own client generation.

Delete data product by ID

delete

Delete the specified data product from the system

Authorizations

Path parameters

idstringrequired

Responses

delete

HTTPcURLJavaScriptPython

DELETE /marketplace/api/data-product/{id} HTTP/1.1
Host: na.api.immutacloud.com
Authorization: Bearer JWT
Accept: */*

200Success

No Content