# Data Product

APIs for managing data products

## Search data products across the marketplace

> Search data products in the marketplace using the provided filters

```json
{"openapi":"3.0.0","info":{"title":"Immuta Data Marketplace","version":"1.0"},"tags":[{"name":"Data Product","description":"APIs for managing data products"}],"servers":[{"url":"https://{global-segment}.api.immutacloud.com/marketplace","description":"Marketplace API Endpoint","variables":{"global-segment":{"default":"na","enum":["na","eu","ap"],"description":"Marketplace API global segment"}}}],"security":[{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"scheme":"bearer","bearerFormat":"JWT","type":"http"}},"schemas":{"PaginatedDataProduct":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"oneOf":[{"type":"string","format":"cuid"},{"type":"string","format":"uuid"}]},"name":{"type":"string","minLength":1,"maxLength":255,"pattern":"^[a-zA-Z0-9)(\\-_/\\\\\\s]*$","description":"Data product name"},"description":{"oneOf":[{"type":"string","description":"Data product description"}],"nullable":true,"description":"Data product description"},"domains":{"type":"array","items":{"type":"string"},"minItems":1},"suspended":{"type":"boolean","description":"Whether access to the data product's data sources is suspended"},"createdBy":{"type":"string","format":"uuid","description":"Immuta global user ID of the user who created the data product"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"status":{"type":"string","enum":["APPROVED","CANCELED","DENIED","PENDING","NONE","PUBLISHER","REVOKED","EXPIRED"]},"expiration":{"oneOf":[{"type":"string","format":"date-time"}],"nullable":true},"stats":{"type":"object","properties":{"dataSourceCount":{"type":"integer","description":"Count of data sources in a data product"},"pendingRequestCount":{"type":"integer","description":"Count of pending requests for a data product"},"approvedRequestCount":{"type":"integer","description":"Count of approved requests for a data product"},"revokedRequestCount":{"type":"integer","description":"Count of revoked requests for a data product"},"canceledRequestCount":{"type":"integer","description":"Count of canceled requests for a data product"},"deniedRequestCount":{"type":"integer","description":"Count of denied requests for a data product"},"totalRequestCount":{"type":"integer","description":"Count of total requests for a data product"}},"required":["dataSourceCount","pendingRequestCount","approvedRequestCount","revokedRequestCount","canceledRequestCount","deniedRequestCount","totalRequestCount"],"description":"Data product statistics","title":"Data Product Stats"},"requestId":{"type":"string","format":"cuid","description":"If requested, the ID of the access request for the data product"},"sourceTypes":{"type":"array","items":{"type":"string"},"description":"The types of data sources contained in the data product."},"metadata":{"oneOf":[{"type":"object","properties":{"subjectMatterExpert":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Immuta global user ID of the subject matter expert for this data product"},"username":{"type":"string"},"name":{"type":"string"}},"required":["id"]}},"required":["subjectMatterExpert"]}],"nullable":true},"dataAccessPolicy":{"default":{"rules":[],"defaultEvent":{"type":"review","params":{"stages":[{"any":[{"type":"PERMISSION","permission":"GOVERNANCE"},{"type":"DOMAIN PERMISSION","permission":"Manage Data Products"}]}]}}},"type":"object","properties":{"version":{"type":"string","description":"Policy schema version"},"rules":{"type":"array","items":{"type":"object","properties":{"conditions":{"oneOf":[{"type":"object","properties":{"all":{"type":"array","items":{}}},"required":["all"],"additionalProperties":false},{"type":"object","properties":{"any":{"type":"array","items":{}}},"required":["any"],"additionalProperties":false},{"type":"object","properties":{"not":{}},"required":["not"],"additionalProperties":false}]},"event":{"discriminator":{"propertyName":"type"},"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["approve"]},"params":{"type":"object","properties":{"comment":{"type":"string"},"duration":{"type":"number","minimum":1},"durationUnit":{"type":"string","enum":["HOURS","DAYS","WEEKS","MONTHS","YEARS"]}},"additionalProperties":false}},"required":["type","params"]},{"type":"object","properties":{"type":{"type":"string","enum":["deny"]},"params":{"type":"object","properties":{"comment":{"type":"string"}}}},"required":["type","params"]},{"type":"object","properties":{"type":{"type":"string","enum":["review"]},"params":{"type":"object","properties":{"stages":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"all":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["USER"],"description":"Entity type"},"id":{"type":"string","description":"Entity ID"},"displayName":{"type":"string","description":"Entity display name"}},"required":["type","id"]},{"type":"object","properties":{"type":{"type":"string","enum":["GROUP"],"description":"Entity type"},"id":{"type":"number","description":"Entity ID"},"iamId":{"type":"string","description":"IAM ID"},"name":{"type":"string","description":"Entity display name"}},"required":["type","name"]},{"type":"object","properties":{"type":{"type":"string","enum":["PERMISSION"]},"permission":{"type":"string","enum":["GOVERNANCE","USER_ADMIN","AUDIT"],"description":"Global permission"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["DOMAIN PERMISSION"]},"permission":{"type":"string","enum":["Manage Policies","Audit Activity","Manage Data Products","Manage Identifiers"],"description":"Domain permission"},"domainId":{"type":"string","description":"Domain ID"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["ATTRIBUTE"]},"key":{"type":"string","description":"Attribute key"},"value":{"type":"string","description":"Attribute value"}},"required":["type","key","value"]}]},"minItems":1}},"required":["all"]},{"type":"object","properties":{"any":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["USER"],"description":"Entity type"},"id":{"type":"string","description":"Entity ID"},"displayName":{"type":"string","description":"Entity display name"}},"required":["type","id"]},{"type":"object","properties":{"type":{"type":"string","enum":["GROUP"],"description":"Entity type"},"id":{"type":"number","description":"Entity ID"},"iamId":{"type":"string","description":"IAM ID"},"name":{"type":"string","description":"Entity display name"}},"required":["type","name"]},{"type":"object","properties":{"type":{"type":"string","enum":["PERMISSION"]},"permission":{"type":"string","enum":["GOVERNANCE","USER_ADMIN","AUDIT"],"description":"Global permission"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["DOMAIN PERMISSION"]},"permission":{"type":"string","enum":["Manage Policies","Audit Activity","Manage Data Products","Manage Identifiers"],"description":"Domain permission"},"domainId":{"type":"string","description":"Domain ID"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["ATTRIBUTE"]},"key":{"type":"string","description":"Attribute key"},"value":{"type":"string","description":"Attribute value"}},"required":["type","key","value"]}]},"minItems":1}},"required":["any"]}]},"description":"Array of stages for manual review"}},"required":["stages"]}},"required":["type","params"]},{"type":"object","properties":{"type":{"type":"string","enum":["dataProductPolicy"]}},"required":["type"]}]}},"required":["conditions","event"]}},"defaultEvent":{"discriminator":{"propertyName":"type"},"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["approve"]},"params":{"type":"object","properties":{"comment":{"type":"string"},"duration":{"type":"number","minimum":1},"durationUnit":{"type":"string","enum":["HOURS","DAYS","WEEKS","MONTHS","YEARS"]}},"additionalProperties":false}},"required":["type","params"]},{"type":"object","properties":{"type":{"type":"string","enum":["review"]},"params":{"type":"object","properties":{"stages":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"all":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["USER"],"description":"Entity type"},"id":{"type":"string","description":"Entity ID"},"displayName":{"type":"string","description":"Entity display name"}},"required":["type","id"]},{"type":"object","properties":{"type":{"type":"string","enum":["GROUP"],"description":"Entity type"},"id":{"type":"number","description":"Entity ID"},"iamId":{"type":"string","description":"IAM ID"},"name":{"type":"string","description":"Entity display name"}},"required":["type","name"]},{"type":"object","properties":{"type":{"type":"string","enum":["PERMISSION"]},"permission":{"type":"string","enum":["GOVERNANCE","USER_ADMIN","AUDIT"],"description":"Global permission"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["DOMAIN PERMISSION"]},"permission":{"type":"string","enum":["Manage Policies","Audit Activity","Manage Data Products","Manage Identifiers"],"description":"Domain permission"},"domainId":{"type":"string","description":"Domain ID"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["ATTRIBUTE"]},"key":{"type":"string","description":"Attribute key"},"value":{"type":"string","description":"Attribute value"}},"required":["type","key","value"]}]},"minItems":1}},"required":["all"]},{"type":"object","properties":{"any":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["USER"],"description":"Entity type"},"id":{"type":"string","description":"Entity ID"},"displayName":{"type":"string","description":"Entity display name"}},"required":["type","id"]},{"type":"object","properties":{"type":{"type":"string","enum":["GROUP"],"description":"Entity type"},"id":{"type":"number","description":"Entity ID"},"iamId":{"type":"string","description":"IAM ID"},"name":{"type":"string","description":"Entity display name"}},"required":["type","name"]},{"type":"object","properties":{"type":{"type":"string","enum":["PERMISSION"]},"permission":{"type":"string","enum":["GOVERNANCE","USER_ADMIN","AUDIT"],"description":"Global permission"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["DOMAIN PERMISSION"]},"permission":{"type":"string","enum":["Manage Policies","Audit Activity","Manage Data Products","Manage Identifiers"],"description":"Domain permission"},"domainId":{"type":"string","description":"Domain ID"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["ATTRIBUTE"]},"key":{"type":"string","description":"Attribute key"},"value":{"type":"string","description":"Attribute value"}},"required":["type","key","value"]}]},"minItems":1}},"required":["any"]}]},"description":"Array of stages for manual review"}},"required":["stages"]}},"required":["type","params"]}]}},"required":["rules","defaultEvent"],"description":"Data product data access policy","title":"Data Product Data Access Policy"},"maskingExceptionPolicy":{"default":{"rules":[],"defaultEvent":{"type":"review","params":{"stages":[{"any":[{"type":"PERMISSION","permission":"GOVERNANCE"},{"type":"DOMAIN PERMISSION","permission":"Manage Data Products"}]}]}}},"type":"object","properties":{"version":{"type":"string","description":"Policy schema version"},"rules":{"type":"array","items":{"type":"object","properties":{"conditions":{"oneOf":[{"type":"object","properties":{"all":{"type":"array","items":{}}},"required":["all"],"additionalProperties":false},{"type":"object","properties":{"any":{"type":"array","items":{}}},"required":["any"],"additionalProperties":false},{"type":"object","properties":{"not":{}},"required":["not"],"additionalProperties":false}]},"event":{"discriminator":{"propertyName":"type"},"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["approve"]},"params":{"type":"object","properties":{"comment":{"type":"string"},"duration":{"type":"number","minimum":1},"durationUnit":{"type":"string","enum":["HOURS","DAYS","WEEKS","MONTHS","YEARS"]}},"additionalProperties":false}},"required":["type","params"]},{"type":"object","properties":{"type":{"type":"string","enum":["deny"]},"params":{"type":"object","properties":{"comment":{"type":"string"}}}},"required":["type","params"]},{"type":"object","properties":{"type":{"type":"string","enum":["review"]},"params":{"type":"object","properties":{"stages":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"all":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["USER"],"description":"Entity type"},"id":{"type":"string","description":"Entity ID"},"displayName":{"type":"string","description":"Entity display name"}},"required":["type","id"]},{"type":"object","properties":{"type":{"type":"string","enum":["GROUP"],"description":"Entity type"},"id":{"type":"number","description":"Entity ID"},"iamId":{"type":"string","description":"IAM ID"},"name":{"type":"string","description":"Entity display name"}},"required":["type","name"]},{"type":"object","properties":{"type":{"type":"string","enum":["PERMISSION"]},"permission":{"type":"string","enum":["GOVERNANCE","USER_ADMIN","AUDIT"],"description":"Global permission"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["DOMAIN PERMISSION"]},"permission":{"type":"string","enum":["Manage Policies","Audit Activity","Manage Data Products","Manage Identifiers"],"description":"Domain permission"},"domainId":{"type":"string","description":"Domain ID"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["ATTRIBUTE"]},"key":{"type":"string","description":"Attribute key"},"value":{"type":"string","description":"Attribute value"}},"required":["type","key","value"]}]},"minItems":1}},"required":["all"]},{"type":"object","properties":{"any":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["USER"],"description":"Entity type"},"id":{"type":"string","description":"Entity ID"},"displayName":{"type":"string","description":"Entity display name"}},"required":["type","id"]},{"type":"object","properties":{"type":{"type":"string","enum":["GROUP"],"description":"Entity type"},"id":{"type":"number","description":"Entity ID"},"iamId":{"type":"string","description":"IAM ID"},"name":{"type":"string","description":"Entity display name"}},"required":["type","name"]},{"type":"object","properties":{"type":{"type":"string","enum":["PERMISSION"]},"permission":{"type":"string","enum":["GOVERNANCE","USER_ADMIN","AUDIT"],"description":"Global permission"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["DOMAIN PERMISSION"]},"permission":{"type":"string","enum":["Manage Policies","Audit Activity","Manage Data Products","Manage Identifiers"],"description":"Domain permission"},"domainId":{"type":"string","description":"Domain ID"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["ATTRIBUTE"]},"key":{"type":"string","description":"Attribute key"},"value":{"type":"string","description":"Attribute value"}},"required":["type","key","value"]}]},"minItems":1}},"required":["any"]}]},"description":"Array of stages for manual review"}},"required":["stages"]}},"required":["type","params"]},{"type":"object","properties":{"type":{"type":"string","enum":["dataProductPolicy"]}},"required":["type"]}]}},"required":["conditions","event"]}},"defaultEvent":{"discriminator":{"propertyName":"type"},"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["approve"]},"params":{"type":"object","properties":{"comment":{"type":"string"},"duration":{"type":"number","minimum":1},"durationUnit":{"type":"string","enum":["HOURS","DAYS","WEEKS","MONTHS","YEARS"]}},"additionalProperties":false}},"required":["type","params"]},{"type":"object","properties":{"type":{"type":"string","enum":["review"]},"params":{"type":"object","properties":{"stages":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"all":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["USER"],"description":"Entity type"},"id":{"type":"string","description":"Entity ID"},"displayName":{"type":"string","description":"Entity display name"}},"required":["type","id"]},{"type":"object","properties":{"type":{"type":"string","enum":["GROUP"],"description":"Entity type"},"id":{"type":"number","description":"Entity ID"},"iamId":{"type":"string","description":"IAM ID"},"name":{"type":"string","description":"Entity display name"}},"required":["type","name"]},{"type":"object","properties":{"type":{"type":"string","enum":["PERMISSION"]},"permission":{"type":"string","enum":["GOVERNANCE","USER_ADMIN","AUDIT"],"description":"Global permission"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["DOMAIN PERMISSION"]},"permission":{"type":"string","enum":["Manage Policies","Audit Activity","Manage Data Products","Manage Identifiers"],"description":"Domain permission"},"domainId":{"type":"string","description":"Domain ID"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["ATTRIBUTE"]},"key":{"type":"string","description":"Attribute key"},"value":{"type":"string","description":"Attribute value"}},"required":["type","key","value"]}]},"minItems":1}},"required":["all"]},{"type":"object","properties":{"any":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["USER"],"description":"Entity type"},"id":{"type":"string","description":"Entity ID"},"displayName":{"type":"string","description":"Entity display name"}},"required":["type","id"]},{"type":"object","properties":{"type":{"type":"string","enum":["GROUP"],"description":"Entity type"},"id":{"type":"number","description":"Entity ID"},"iamId":{"type":"string","description":"IAM ID"},"name":{"type":"string","description":"Entity display name"}},"required":["type","name"]},{"type":"object","properties":{"type":{"type":"string","enum":["PERMISSION"]},"permission":{"type":"string","enum":["GOVERNANCE","USER_ADMIN","AUDIT"],"description":"Global permission"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["DOMAIN PERMISSION"]},"permission":{"type":"string","enum":["Manage Policies","Audit Activity","Manage Data Products","Manage Identifiers"],"description":"Domain permission"},"domainId":{"type":"string","description":"Domain ID"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["ATTRIBUTE"]},"key":{"type":"string","description":"Attribute key"},"value":{"type":"string","description":"Attribute value"}},"required":["type","key","value"]}]},"minItems":1}},"required":["any"]}]},"description":"Array of stages for manual review"}},"required":["stages"]}},"required":["type","params"]}]}},"required":["rules","defaultEvent"],"description":"Data product masking exception policy","title":"Data Product Masking Exception Policy"}},"required":["id","name","domains","suspended","createdBy","createdAt","updatedAt","metadata"]}},"meta":{"type":"object","properties":{"nextToken":{"oneOf":[{"type":"string","description":"Pagination token to fetch the next page of results, or null if there are no more pages."}],"nullable":true,"description":"Pagination token to fetch the next page of results, or null if there are no more pages."},"limit":{"default":10,"type":"number","minimum":1,"maximum":100,"description":"The number of items to return per page"}},"required":["nextToken"]}},"required":["data","meta"]}}},"paths":{"/api/data-product":{"get":{"description":"Search data products in the marketplace using the provided filters","operationId":"searchDataProducts","parameters":[{"name":"nextToken","required":false,"in":"query","description":"Pagination token to fetch the next page of results","schema":{"type":"string"}},{"name":"limit","required":false,"in":"query","description":"The number of items to return per page","schema":{"minimum":1,"maximum":100,"default":10,"type":"number"}},{"name":"sortOrder","required":false,"in":"query","schema":{"default":"asc","type":"string","enum":["asc","desc"]}},{"name":"sortBy","required":false,"in":"query","schema":{"type":"string","enum":["name"]}},{"name":"nameFilter","required":false,"in":"query","schema":{"type":"string"}},{"name":"statusFilter","required":false,"in":"query","schema":{"type":"array","items":{"type":"string","enum":["APPROVED","CANCELED","DENIED","PENDING","NONE","PUBLISHER","REVOKED","EXPIRED"]}}},{"name":"roleFilter","required":false,"in":"query","schema":{"type":"array","items":{"type":"string","enum":["manager","member","noRole","steward"]}}},{"name":"expiration","required":false,"in":"query","description":"Filter data products by whether data access has an expiration.","schema":{"type":"boolean"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedDataProduct"}}}}},"summary":"Search data products across the marketplace","tags":["Data Product"]}}}}
```

## Add new data products to the marketplace

> Add one or more data products to the marketplace

```json
{"openapi":"3.0.0","info":{"title":"Immuta Data Marketplace","version":"1.0"},"tags":[{"name":"Data Product","description":"APIs for managing data products"}],"servers":[{"url":"https://{global-segment}.api.immutacloud.com/marketplace","description":"Marketplace API Endpoint","variables":{"global-segment":{"default":"na","enum":["na","eu","ap"],"description":"Marketplace API global segment"}}}],"security":[{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"scheme":"bearer","bearerFormat":"JWT","type":"http"}},"schemas":{"CreateDataProduct":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":255,"pattern":"^[a-zA-Z0-9)(\\-_/\\\\\\s]*$","description":"Data product name"},"description":{"oneOf":[{"type":"string","description":"Data product description"}],"nullable":true,"description":"Data product description"},"metadata":{"oneOf":[{"type":"object","properties":{"subjectMatterExpert":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Immuta global user ID of the subject matter expert for this data product"},"username":{"type":"string"},"name":{"type":"string"}},"required":["id"]}},"required":["subjectMatterExpert"]}],"nullable":true},"domains":{"type":"array","items":{"type":"string"},"minItems":1},"dataAccessPolicy":{"default":{"rules":[],"defaultEvent":{"type":"review","params":{"stages":[{"any":[{"type":"PERMISSION","permission":"GOVERNANCE"},{"type":"DOMAIN PERMISSION","permission":"Manage Data Products"}]}]}}},"type":"object","properties":{"version":{"type":"string","description":"Policy schema version"},"rules":{"type":"array","items":{"type":"object","properties":{"conditions":{"oneOf":[{"type":"object","properties":{"all":{"type":"array","items":{}}},"required":["all"],"additionalProperties":false},{"type":"object","properties":{"any":{"type":"array","items":{}}},"required":["any"],"additionalProperties":false},{"type":"object","properties":{"not":{}},"required":["not"],"additionalProperties":false}]},"event":{"discriminator":{"propertyName":"type"},"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["approve"]},"params":{"type":"object","properties":{"comment":{"type":"string"},"duration":{"type":"number","minimum":1},"durationUnit":{"type":"string","enum":["HOURS","DAYS","WEEKS","MONTHS","YEARS"]}},"additionalProperties":false}},"required":["type","params"]},{"type":"object","properties":{"type":{"type":"string","enum":["deny"]},"params":{"type":"object","properties":{"comment":{"type":"string"}}}},"required":["type","params"]},{"type":"object","properties":{"type":{"type":"string","enum":["review"]},"params":{"type":"object","properties":{"stages":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"all":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["USER"],"description":"Entity type"},"id":{"type":"string","description":"Entity ID"},"displayName":{"type":"string","description":"Entity display name"}},"required":["type","id"]},{"type":"object","properties":{"type":{"type":"string","enum":["GROUP"],"description":"Entity type"},"id":{"type":"number","description":"Entity ID"},"iamId":{"type":"string","description":"IAM ID"},"name":{"type":"string","description":"Entity display name"}},"required":["type","name"]},{"type":"object","properties":{"type":{"type":"string","enum":["PERMISSION"]},"permission":{"type":"string","enum":["GOVERNANCE","USER_ADMIN","AUDIT"],"description":"Global permission"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["DOMAIN PERMISSION"]},"permission":{"type":"string","enum":["Manage Policies","Audit Activity","Manage Data Products","Manage Identifiers"],"description":"Domain permission"},"domainId":{"type":"string","description":"Domain ID"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["ATTRIBUTE"]},"key":{"type":"string","description":"Attribute key"},"value":{"type":"string","description":"Attribute value"}},"required":["type","key","value"]}]},"minItems":1}},"required":["all"]},{"type":"object","properties":{"any":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["USER"],"description":"Entity type"},"id":{"type":"string","description":"Entity ID"},"displayName":{"type":"string","description":"Entity display name"}},"required":["type","id"]},{"type":"object","properties":{"type":{"type":"string","enum":["GROUP"],"description":"Entity type"},"id":{"type":"number","description":"Entity ID"},"iamId":{"type":"string","description":"IAM ID"},"name":{"type":"string","description":"Entity display name"}},"required":["type","name"]},{"type":"object","properties":{"type":{"type":"string","enum":["PERMISSION"]},"permission":{"type":"string","enum":["GOVERNANCE","USER_ADMIN","AUDIT"],"description":"Global permission"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["DOMAIN PERMISSION"]},"permission":{"type":"string","enum":["Manage Policies","Audit Activity","Manage Data Products","Manage Identifiers"],"description":"Domain permission"},"domainId":{"type":"string","description":"Domain ID"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["ATTRIBUTE"]},"key":{"type":"string","description":"Attribute key"},"value":{"type":"string","description":"Attribute value"}},"required":["type","key","value"]}]},"minItems":1}},"required":["any"]}]},"description":"Array of stages for manual review"}},"required":["stages"]}},"required":["type","params"]},{"type":"object","properties":{"type":{"type":"string","enum":["dataProductPolicy"]}},"required":["type"]}]}},"required":["conditions","event"]}},"defaultEvent":{"discriminator":{"propertyName":"type"},"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["approve"]},"params":{"type":"object","properties":{"comment":{"type":"string"},"duration":{"type":"number","minimum":1},"durationUnit":{"type":"string","enum":["HOURS","DAYS","WEEKS","MONTHS","YEARS"]}},"additionalProperties":false}},"required":["type","params"]},{"type":"object","properties":{"type":{"type":"string","enum":["review"]},"params":{"type":"object","properties":{"stages":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"all":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["USER"],"description":"Entity type"},"id":{"type":"string","description":"Entity ID"},"displayName":{"type":"string","description":"Entity display name"}},"required":["type","id"]},{"type":"object","properties":{"type":{"type":"string","enum":["GROUP"],"description":"Entity type"},"id":{"type":"number","description":"Entity ID"},"iamId":{"type":"string","description":"IAM ID"},"name":{"type":"string","description":"Entity display name"}},"required":["type","name"]},{"type":"object","properties":{"type":{"type":"string","enum":["PERMISSION"]},"permission":{"type":"string","enum":["GOVERNANCE","USER_ADMIN","AUDIT"],"description":"Global permission"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["DOMAIN PERMISSION"]},"permission":{"type":"string","enum":["Manage Policies","Audit Activity","Manage Data Products","Manage Identifiers"],"description":"Domain permission"},"domainId":{"type":"string","description":"Domain ID"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["ATTRIBUTE"]},"key":{"type":"string","description":"Attribute key"},"value":{"type":"string","description":"Attribute value"}},"required":["type","key","value"]}]},"minItems":1}},"required":["all"]},{"type":"object","properties":{"any":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["USER"],"description":"Entity type"},"id":{"type":"string","description":"Entity ID"},"displayName":{"type":"string","description":"Entity display name"}},"required":["type","id"]},{"type":"object","properties":{"type":{"type":"string","enum":["GROUP"],"description":"Entity type"},"id":{"type":"number","description":"Entity ID"},"iamId":{"type":"string","description":"IAM ID"},"name":{"type":"string","description":"Entity display name"}},"required":["type","name"]},{"type":"object","properties":{"type":{"type":"string","enum":["PERMISSION"]},"permission":{"type":"string","enum":["GOVERNANCE","USER_ADMIN","AUDIT"],"description":"Global permission"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["DOMAIN PERMISSION"]},"permission":{"type":"string","enum":["Manage Policies","Audit Activity","Manage Data Products","Manage Identifiers"],"description":"Domain permission"},"domainId":{"type":"string","description":"Domain ID"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["ATTRIBUTE"]},"key":{"type":"string","description":"Attribute key"},"value":{"type":"string","description":"Attribute value"}},"required":["type","key","value"]}]},"minItems":1}},"required":["any"]}]},"description":"Array of stages for manual review"}},"required":["stages"]}},"required":["type","params"]}]}},"required":["rules","defaultEvent"],"description":"Data product data access policy","title":"Data Product Data Access Policy"},"maskingExceptionPolicy":{"default":{"rules":[],"defaultEvent":{"type":"review","params":{"stages":[{"any":[{"type":"PERMISSION","permission":"GOVERNANCE"},{"type":"DOMAIN PERMISSION","permission":"Manage Data Products"}]}]}}},"type":"object","properties":{"version":{"type":"string","description":"Policy schema version"},"rules":{"type":"array","items":{"type":"object","properties":{"conditions":{"oneOf":[{"type":"object","properties":{"all":{"type":"array","items":{}}},"required":["all"],"additionalProperties":false},{"type":"object","properties":{"any":{"type":"array","items":{}}},"required":["any"],"additionalProperties":false},{"type":"object","properties":{"not":{}},"required":["not"],"additionalProperties":false}]},"event":{"discriminator":{"propertyName":"type"},"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["approve"]},"params":{"type":"object","properties":{"comment":{"type":"string"},"duration":{"type":"number","minimum":1},"durationUnit":{"type":"string","enum":["HOURS","DAYS","WEEKS","MONTHS","YEARS"]}},"additionalProperties":false}},"required":["type","params"]},{"type":"object","properties":{"type":{"type":"string","enum":["deny"]},"params":{"type":"object","properties":{"comment":{"type":"string"}}}},"required":["type","params"]},{"type":"object","properties":{"type":{"type":"string","enum":["review"]},"params":{"type":"object","properties":{"stages":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"all":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["USER"],"description":"Entity type"},"id":{"type":"string","description":"Entity ID"},"displayName":{"type":"string","description":"Entity display name"}},"required":["type","id"]},{"type":"object","properties":{"type":{"type":"string","enum":["GROUP"],"description":"Entity type"},"id":{"type":"number","description":"Entity ID"},"iamId":{"type":"string","description":"IAM ID"},"name":{"type":"string","description":"Entity display name"}},"required":["type","name"]},{"type":"object","properties":{"type":{"type":"string","enum":["PERMISSION"]},"permission":{"type":"string","enum":["GOVERNANCE","USER_ADMIN","AUDIT"],"description":"Global permission"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["DOMAIN PERMISSION"]},"permission":{"type":"string","enum":["Manage Policies","Audit Activity","Manage Data Products","Manage Identifiers"],"description":"Domain permission"},"domainId":{"type":"string","description":"Domain ID"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["ATTRIBUTE"]},"key":{"type":"string","description":"Attribute key"},"value":{"type":"string","description":"Attribute value"}},"required":["type","key","value"]}]},"minItems":1}},"required":["all"]},{"type":"object","properties":{"any":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["USER"],"description":"Entity type"},"id":{"type":"string","description":"Entity ID"},"displayName":{"type":"string","description":"Entity display name"}},"required":["type","id"]},{"type":"object","properties":{"type":{"type":"string","enum":["GROUP"],"description":"Entity type"},"id":{"type":"number","description":"Entity ID"},"iamId":{"type":"string","description":"IAM ID"},"name":{"type":"string","description":"Entity display name"}},"required":["type","name"]},{"type":"object","properties":{"type":{"type":"string","enum":["PERMISSION"]},"permission":{"type":"string","enum":["GOVERNANCE","USER_ADMIN","AUDIT"],"description":"Global permission"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["DOMAIN PERMISSION"]},"permission":{"type":"string","enum":["Manage Policies","Audit Activity","Manage Data Products","Manage Identifiers"],"description":"Domain permission"},"domainId":{"type":"string","description":"Domain ID"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["ATTRIBUTE"]},"key":{"type":"string","description":"Attribute key"},"value":{"type":"string","description":"Attribute value"}},"required":["type","key","value"]}]},"minItems":1}},"required":["any"]}]},"description":"Array of stages for manual review"}},"required":["stages"]}},"required":["type","params"]},{"type":"object","properties":{"type":{"type":"string","enum":["dataProductPolicy"]}},"required":["type"]}]}},"required":["conditions","event"]}},"defaultEvent":{"discriminator":{"propertyName":"type"},"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["approve"]},"params":{"type":"object","properties":{"comment":{"type":"string"},"duration":{"type":"number","minimum":1},"durationUnit":{"type":"string","enum":["HOURS","DAYS","WEEKS","MONTHS","YEARS"]}},"additionalProperties":false}},"required":["type","params"]},{"type":"object","properties":{"type":{"type":"string","enum":["review"]},"params":{"type":"object","properties":{"stages":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"all":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["USER"],"description":"Entity type"},"id":{"type":"string","description":"Entity ID"},"displayName":{"type":"string","description":"Entity display name"}},"required":["type","id"]},{"type":"object","properties":{"type":{"type":"string","enum":["GROUP"],"description":"Entity type"},"id":{"type":"number","description":"Entity ID"},"iamId":{"type":"string","description":"IAM ID"},"name":{"type":"string","description":"Entity display name"}},"required":["type","name"]},{"type":"object","properties":{"type":{"type":"string","enum":["PERMISSION"]},"permission":{"type":"string","enum":["GOVERNANCE","USER_ADMIN","AUDIT"],"description":"Global permission"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["DOMAIN PERMISSION"]},"permission":{"type":"string","enum":["Manage Policies","Audit Activity","Manage Data Products","Manage Identifiers"],"description":"Domain permission"},"domainId":{"type":"string","description":"Domain ID"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["ATTRIBUTE"]},"key":{"type":"string","description":"Attribute key"},"value":{"type":"string","description":"Attribute value"}},"required":["type","key","value"]}]},"minItems":1}},"required":["all"]},{"type":"object","properties":{"any":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["USER"],"description":"Entity type"},"id":{"type":"string","description":"Entity ID"},"displayName":{"type":"string","description":"Entity display name"}},"required":["type","id"]},{"type":"object","properties":{"type":{"type":"string","enum":["GROUP"],"description":"Entity type"},"id":{"type":"number","description":"Entity ID"},"iamId":{"type":"string","description":"IAM ID"},"name":{"type":"string","description":"Entity display name"}},"required":["type","name"]},{"type":"object","properties":{"type":{"type":"string","enum":["PERMISSION"]},"permission":{"type":"string","enum":["GOVERNANCE","USER_ADMIN","AUDIT"],"description":"Global permission"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["DOMAIN PERMISSION"]},"permission":{"type":"string","enum":["Manage Policies","Audit Activity","Manage Data Products","Manage Identifiers"],"description":"Domain permission"},"domainId":{"type":"string","description":"Domain ID"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["ATTRIBUTE"]},"key":{"type":"string","description":"Attribute key"},"value":{"type":"string","description":"Attribute value"}},"required":["type","key","value"]}]},"minItems":1}},"required":["any"]}]},"description":"Array of stages for manual review"}},"required":["stages"]}},"required":["type","params"]}]}},"required":["rules","defaultEvent"],"description":"Data product masking exception policy","title":"Data Product Masking Exception Policy"},"id":{"type":"string","format":"uuid","description":"Data product ID"},"dataSources":{"type":"array","items":{"type":"object","properties":{"sourceId":{"type":"string"}},"required":["sourceId"]}},"requestFormId":{"oneOf":[{"type":"string","format":"cuid"},{"type":"string","format":"uuid"}]}},"required":["name","metadata","domains","dataSources","requestFormId"]},"DataProduct":{"type":"object","properties":{"id":{"oneOf":[{"type":"string","format":"cuid"},{"type":"string","format":"uuid"}]},"name":{"type":"string","minLength":1,"maxLength":255,"pattern":"^[a-zA-Z0-9)(\\-_/\\\\\\s]*$","description":"Data product name"},"description":{"oneOf":[{"type":"string","description":"Data product description"}],"nullable":true,"description":"Data product description"},"domains":{"type":"array","items":{"type":"string"},"minItems":1},"suspended":{"type":"boolean","description":"Whether access to the data product's data sources is suspended"},"createdBy":{"type":"string","format":"uuid","description":"Immuta global user ID of the user who created the data product"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"status":{"type":"string","enum":["APPROVED","CANCELED","DENIED","PENDING","NONE","PUBLISHER","REVOKED","EXPIRED"]},"expiration":{"oneOf":[{"type":"string","format":"date-time"}],"nullable":true},"stats":{"type":"object","properties":{"dataSourceCount":{"type":"integer","description":"Count of data sources in a data product"},"pendingRequestCount":{"type":"integer","description":"Count of pending requests for a data product"},"approvedRequestCount":{"type":"integer","description":"Count of approved requests for a data product"},"revokedRequestCount":{"type":"integer","description":"Count of revoked requests for a data product"},"canceledRequestCount":{"type":"integer","description":"Count of canceled requests for a data product"},"deniedRequestCount":{"type":"integer","description":"Count of denied requests for a data product"},"totalRequestCount":{"type":"integer","description":"Count of total requests for a data product"}},"required":["dataSourceCount","pendingRequestCount","approvedRequestCount","revokedRequestCount","canceledRequestCount","deniedRequestCount","totalRequestCount"],"description":"Data product statistics","title":"Data Product Stats"},"requestId":{"type":"string","format":"cuid","description":"If requested, the ID of the access request for the data product"},"sourceTypes":{"type":"array","items":{"type":"string"},"description":"The types of data sources contained in the data product."},"metadata":{"oneOf":[{"type":"object","properties":{"subjectMatterExpert":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Immuta global user ID of the subject matter expert for this data product"},"username":{"type":"string"},"name":{"type":"string"}},"required":["id"]}},"required":["subjectMatterExpert"]}],"nullable":true},"dataAccessPolicy":{"default":{"rules":[],"defaultEvent":{"type":"review","params":{"stages":[{"any":[{"type":"PERMISSION","permission":"GOVERNANCE"},{"type":"DOMAIN PERMISSION","permission":"Manage Data Products"}]}]}}},"type":"object","properties":{"version":{"type":"string","description":"Policy schema version"},"rules":{"type":"array","items":{"type":"object","properties":{"conditions":{"oneOf":[{"type":"object","properties":{"all":{"type":"array","items":{}}},"required":["all"],"additionalProperties":false},{"type":"object","properties":{"any":{"type":"array","items":{}}},"required":["any"],"additionalProperties":false},{"type":"object","properties":{"not":{}},"required":["not"],"additionalProperties":false}]},"event":{"discriminator":{"propertyName":"type"},"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["approve"]},"params":{"type":"object","properties":{"comment":{"type":"string"},"duration":{"type":"number","minimum":1},"durationUnit":{"type":"string","enum":["HOURS","DAYS","WEEKS","MONTHS","YEARS"]}},"additionalProperties":false}},"required":["type","params"]},{"type":"object","properties":{"type":{"type":"string","enum":["deny"]},"params":{"type":"object","properties":{"comment":{"type":"string"}}}},"required":["type","params"]},{"type":"object","properties":{"type":{"type":"string","enum":["review"]},"params":{"type":"object","properties":{"stages":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"all":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["USER"],"description":"Entity type"},"id":{"type":"string","description":"Entity ID"},"displayName":{"type":"string","description":"Entity display name"}},"required":["type","id"]},{"type":"object","properties":{"type":{"type":"string","enum":["GROUP"],"description":"Entity type"},"id":{"type":"number","description":"Entity ID"},"iamId":{"type":"string","description":"IAM ID"},"name":{"type":"string","description":"Entity display name"}},"required":["type","name"]},{"type":"object","properties":{"type":{"type":"string","enum":["PERMISSION"]},"permission":{"type":"string","enum":["GOVERNANCE","USER_ADMIN","AUDIT"],"description":"Global permission"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["DOMAIN PERMISSION"]},"permission":{"type":"string","enum":["Manage Policies","Audit Activity","Manage Data Products","Manage Identifiers"],"description":"Domain permission"},"domainId":{"type":"string","description":"Domain ID"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["ATTRIBUTE"]},"key":{"type":"string","description":"Attribute key"},"value":{"type":"string","description":"Attribute value"}},"required":["type","key","value"]}]},"minItems":1}},"required":["all"]},{"type":"object","properties":{"any":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["USER"],"description":"Entity type"},"id":{"type":"string","description":"Entity ID"},"displayName":{"type":"string","description":"Entity display name"}},"required":["type","id"]},{"type":"object","properties":{"type":{"type":"string","enum":["GROUP"],"description":"Entity type"},"id":{"type":"number","description":"Entity ID"},"iamId":{"type":"string","description":"IAM ID"},"name":{"type":"string","description":"Entity display name"}},"required":["type","name"]},{"type":"object","properties":{"type":{"type":"string","enum":["PERMISSION"]},"permission":{"type":"string","enum":["GOVERNANCE","USER_ADMIN","AUDIT"],"description":"Global permission"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["DOMAIN PERMISSION"]},"permission":{"type":"string","enum":["Manage Policies","Audit Activity","Manage Data Products","Manage Identifiers"],"description":"Domain permission"},"domainId":{"type":"string","description":"Domain ID"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["ATTRIBUTE"]},"key":{"type":"string","description":"Attribute key"},"value":{"type":"string","description":"Attribute value"}},"required":["type","key","value"]}]},"minItems":1}},"required":["any"]}]},"description":"Array of stages for manual review"}},"required":["stages"]}},"required":["type","params"]},{"type":"object","properties":{"type":{"type":"string","enum":["dataProductPolicy"]}},"required":["type"]}]}},"required":["conditions","event"]}},"defaultEvent":{"discriminator":{"propertyName":"type"},"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["approve"]},"params":{"type":"object","properties":{"comment":{"type":"string"},"duration":{"type":"number","minimum":1},"durationUnit":{"type":"string","enum":["HOURS","DAYS","WEEKS","MONTHS","YEARS"]}},"additionalProperties":false}},"required":["type","params"]},{"type":"object","properties":{"type":{"type":"string","enum":["review"]},"params":{"type":"object","properties":{"stages":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"all":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["USER"],"description":"Entity type"},"id":{"type":"string","description":"Entity ID"},"displayName":{"type":"string","description":"Entity display name"}},"required":["type","id"]},{"type":"object","properties":{"type":{"type":"string","enum":["GROUP"],"description":"Entity type"},"id":{"type":"number","description":"Entity ID"},"iamId":{"type":"string","description":"IAM ID"},"name":{"type":"string","description":"Entity display name"}},"required":["type","name"]},{"type":"object","properties":{"type":{"type":"string","enum":["PERMISSION"]},"permission":{"type":"string","enum":["GOVERNANCE","USER_ADMIN","AUDIT"],"description":"Global permission"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["DOMAIN PERMISSION"]},"permission":{"type":"string","enum":["Manage Policies","Audit Activity","Manage Data Products","Manage Identifiers"],"description":"Domain permission"},"domainId":{"type":"string","description":"Domain ID"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["ATTRIBUTE"]},"key":{"type":"string","description":"Attribute key"},"value":{"type":"string","description":"Attribute value"}},"required":["type","key","value"]}]},"minItems":1}},"required":["all"]},{"type":"object","properties":{"any":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["USER"],"description":"Entity type"},"id":{"type":"string","description":"Entity ID"},"displayName":{"type":"string","description":"Entity display name"}},"required":["type","id"]},{"type":"object","properties":{"type":{"type":"string","enum":["GROUP"],"description":"Entity type"},"id":{"type":"number","description":"Entity ID"},"iamId":{"type":"string","description":"IAM ID"},"name":{"type":"string","description":"Entity display name"}},"required":["type","name"]},{"type":"object","properties":{"type":{"type":"string","enum":["PERMISSION"]},"permission":{"type":"string","enum":["GOVERNANCE","USER_ADMIN","AUDIT"],"description":"Global permission"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["DOMAIN PERMISSION"]},"permission":{"type":"string","enum":["Manage Policies","Audit Activity","Manage Data Products","Manage Identifiers"],"description":"Domain permission"},"domainId":{"type":"string","description":"Domain ID"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["ATTRIBUTE"]},"key":{"type":"string","description":"Attribute key"},"value":{"type":"string","description":"Attribute value"}},"required":["type","key","value"]}]},"minItems":1}},"required":["any"]}]},"description":"Array of stages for manual review"}},"required":["stages"]}},"required":["type","params"]}]}},"required":["rules","defaultEvent"],"description":"Data product data access policy","title":"Data Product Data Access Policy"},"maskingExceptionPolicy":{"default":{"rules":[],"defaultEvent":{"type":"review","params":{"stages":[{"any":[{"type":"PERMISSION","permission":"GOVERNANCE"},{"type":"DOMAIN PERMISSION","permission":"Manage Data Products"}]}]}}},"type":"object","properties":{"version":{"type":"string","description":"Policy schema version"},"rules":{"type":"array","items":{"type":"object","properties":{"conditions":{"oneOf":[{"type":"object","properties":{"all":{"type":"array","items":{}}},"required":["all"],"additionalProperties":false},{"type":"object","properties":{"any":{"type":"array","items":{}}},"required":["any"],"additionalProperties":false},{"type":"object","properties":{"not":{}},"required":["not"],"additionalProperties":false}]},"event":{"discriminator":{"propertyName":"type"},"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["approve"]},"params":{"type":"object","properties":{"comment":{"type":"string"},"duration":{"type":"number","minimum":1},"durationUnit":{"type":"string","enum":["HOURS","DAYS","WEEKS","MONTHS","YEARS"]}},"additionalProperties":false}},"required":["type","params"]},{"type":"object","properties":{"type":{"type":"string","enum":["deny"]},"params":{"type":"object","properties":{"comment":{"type":"string"}}}},"required":["type","params"]},{"type":"object","properties":{"type":{"type":"string","enum":["review"]},"params":{"type":"object","properties":{"stages":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"all":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["USER"],"description":"Entity type"},"id":{"type":"string","description":"Entity ID"},"displayName":{"type":"string","description":"Entity display name"}},"required":["type","id"]},{"type":"object","properties":{"type":{"type":"string","enum":["GROUP"],"description":"Entity type"},"id":{"type":"number","description":"Entity ID"},"iamId":{"type":"string","description":"IAM ID"},"name":{"type":"string","description":"Entity display name"}},"required":["type","name"]},{"type":"object","properties":{"type":{"type":"string","enum":["PERMISSION"]},"permission":{"type":"string","enum":["GOVERNANCE","USER_ADMIN","AUDIT"],"description":"Global permission"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["DOMAIN PERMISSION"]},"permission":{"type":"string","enum":["Manage Policies","Audit Activity","Manage Data Products","Manage Identifiers"],"description":"Domain permission"},"domainId":{"type":"string","description":"Domain ID"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["ATTRIBUTE"]},"key":{"type":"string","description":"Attribute key"},"value":{"type":"string","description":"Attribute value"}},"required":["type","key","value"]}]},"minItems":1}},"required":["all"]},{"type":"object","properties":{"any":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["USER"],"description":"Entity type"},"id":{"type":"string","description":"Entity ID"},"displayName":{"type":"string","description":"Entity display name"}},"required":["type","id"]},{"type":"object","properties":{"type":{"type":"string","enum":["GROUP"],"description":"Entity type"},"id":{"type":"number","description":"Entity ID"},"iamId":{"type":"string","description":"IAM ID"},"name":{"type":"string","description":"Entity display name"}},"required":["type","name"]},{"type":"object","properties":{"type":{"type":"string","enum":["PERMISSION"]},"permission":{"type":"string","enum":["GOVERNANCE","USER_ADMIN","AUDIT"],"description":"Global permission"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["DOMAIN PERMISSION"]},"permission":{"type":"string","enum":["Manage Policies","Audit Activity","Manage Data Products","Manage Identifiers"],"description":"Domain permission"},"domainId":{"type":"string","description":"Domain ID"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["ATTRIBUTE"]},"key":{"type":"string","description":"Attribute key"},"value":{"type":"string","description":"Attribute value"}},"required":["type","key","value"]}]},"minItems":1}},"required":["any"]}]},"description":"Array of stages for manual review"}},"required":["stages"]}},"required":["type","params"]},{"type":"object","properties":{"type":{"type":"string","enum":["dataProductPolicy"]}},"required":["type"]}]}},"required":["conditions","event"]}},"defaultEvent":{"discriminator":{"propertyName":"type"},"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["approve"]},"params":{"type":"object","properties":{"comment":{"type":"string"},"duration":{"type":"number","minimum":1},"durationUnit":{"type":"string","enum":["HOURS","DAYS","WEEKS","MONTHS","YEARS"]}},"additionalProperties":false}},"required":["type","params"]},{"type":"object","properties":{"type":{"type":"string","enum":["review"]},"params":{"type":"object","properties":{"stages":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"all":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["USER"],"description":"Entity type"},"id":{"type":"string","description":"Entity ID"},"displayName":{"type":"string","description":"Entity display name"}},"required":["type","id"]},{"type":"object","properties":{"type":{"type":"string","enum":["GROUP"],"description":"Entity type"},"id":{"type":"number","description":"Entity ID"},"iamId":{"type":"string","description":"IAM ID"},"name":{"type":"string","description":"Entity display name"}},"required":["type","name"]},{"type":"object","properties":{"type":{"type":"string","enum":["PERMISSION"]},"permission":{"type":"string","enum":["GOVERNANCE","USER_ADMIN","AUDIT"],"description":"Global permission"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["DOMAIN PERMISSION"]},"permission":{"type":"string","enum":["Manage Policies","Audit Activity","Manage Data Products","Manage Identifiers"],"description":"Domain permission"},"domainId":{"type":"string","description":"Domain ID"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["ATTRIBUTE"]},"key":{"type":"string","description":"Attribute key"},"value":{"type":"string","description":"Attribute value"}},"required":["type","key","value"]}]},"minItems":1}},"required":["all"]},{"type":"object","properties":{"any":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["USER"],"description":"Entity type"},"id":{"type":"string","description":"Entity ID"},"displayName":{"type":"string","description":"Entity display name"}},"required":["type","id"]},{"type":"object","properties":{"type":{"type":"string","enum":["GROUP"],"description":"Entity type"},"id":{"type":"number","description":"Entity ID"},"iamId":{"type":"string","description":"IAM ID"},"name":{"type":"string","description":"Entity display name"}},"required":["type","name"]},{"type":"object","properties":{"type":{"type":"string","enum":["PERMISSION"]},"permission":{"type":"string","enum":["GOVERNANCE","USER_ADMIN","AUDIT"],"description":"Global permission"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["DOMAIN PERMISSION"]},"permission":{"type":"string","enum":["Manage Policies","Audit Activity","Manage Data Products","Manage Identifiers"],"description":"Domain permission"},"domainId":{"type":"string","description":"Domain ID"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["ATTRIBUTE"]},"key":{"type":"string","description":"Attribute key"},"value":{"type":"string","description":"Attribute value"}},"required":["type","key","value"]}]},"minItems":1}},"required":["any"]}]},"description":"Array of stages for manual review"}},"required":["stages"]}},"required":["type","params"]}]}},"required":["rules","defaultEvent"],"description":"Data product masking exception policy","title":"Data Product Masking Exception Policy"}},"required":["id","name","domains","suspended","createdBy","createdAt","updatedAt","metadata"]}}},"paths":{"/api/data-product":{"post":{"description":"Add one or more data products to the marketplace","operationId":"createDataProduct","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateDataProduct"}}}},"responses":{"201":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataProduct"}}}},"409":{"description":"Data Product name in use."}},"summary":"Add new data products to the marketplace","tags":["Data Product"]}}}}
```

## Get data product by ID

> Get data product metadata for the specified data product ID

```json
{"openapi":"3.0.0","info":{"title":"Immuta Data Marketplace","version":"1.0"},"tags":[{"name":"Data Product","description":"APIs for managing data products"}],"servers":[{"url":"https://{global-segment}.api.immutacloud.com/marketplace","description":"Marketplace API Endpoint","variables":{"global-segment":{"default":"na","enum":["na","eu","ap"],"description":"Marketplace API global segment"}}}],"security":[{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"scheme":"bearer","bearerFormat":"JWT","type":"http"}},"schemas":{"DataProduct":{"type":"object","properties":{"id":{"oneOf":[{"type":"string","format":"cuid"},{"type":"string","format":"uuid"}]},"name":{"type":"string","minLength":1,"maxLength":255,"pattern":"^[a-zA-Z0-9)(\\-_/\\\\\\s]*$","description":"Data product name"},"description":{"oneOf":[{"type":"string","description":"Data product description"}],"nullable":true,"description":"Data product description"},"domains":{"type":"array","items":{"type":"string"},"minItems":1},"suspended":{"type":"boolean","description":"Whether access to the data product's data sources is suspended"},"createdBy":{"type":"string","format":"uuid","description":"Immuta global user ID of the user who created the data product"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"status":{"type":"string","enum":["APPROVED","CANCELED","DENIED","PENDING","NONE","PUBLISHER","REVOKED","EXPIRED"]},"expiration":{"oneOf":[{"type":"string","format":"date-time"}],"nullable":true},"stats":{"type":"object","properties":{"dataSourceCount":{"type":"integer","description":"Count of data sources in a data product"},"pendingRequestCount":{"type":"integer","description":"Count of pending requests for a data product"},"approvedRequestCount":{"type":"integer","description":"Count of approved requests for a data product"},"revokedRequestCount":{"type":"integer","description":"Count of revoked requests for a data product"},"canceledRequestCount":{"type":"integer","description":"Count of canceled requests for a data product"},"deniedRequestCount":{"type":"integer","description":"Count of denied requests for a data product"},"totalRequestCount":{"type":"integer","description":"Count of total requests for a data product"}},"required":["dataSourceCount","pendingRequestCount","approvedRequestCount","revokedRequestCount","canceledRequestCount","deniedRequestCount","totalRequestCount"],"description":"Data product statistics","title":"Data Product Stats"},"requestId":{"type":"string","format":"cuid","description":"If requested, the ID of the access request for the data product"},"sourceTypes":{"type":"array","items":{"type":"string"},"description":"The types of data sources contained in the data product."},"metadata":{"oneOf":[{"type":"object","properties":{"subjectMatterExpert":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Immuta global user ID of the subject matter expert for this data product"},"username":{"type":"string"},"name":{"type":"string"}},"required":["id"]}},"required":["subjectMatterExpert"]}],"nullable":true},"dataAccessPolicy":{"default":{"rules":[],"defaultEvent":{"type":"review","params":{"stages":[{"any":[{"type":"PERMISSION","permission":"GOVERNANCE"},{"type":"DOMAIN PERMISSION","permission":"Manage Data Products"}]}]}}},"type":"object","properties":{"version":{"type":"string","description":"Policy schema version"},"rules":{"type":"array","items":{"type":"object","properties":{"conditions":{"oneOf":[{"type":"object","properties":{"all":{"type":"array","items":{}}},"required":["all"],"additionalProperties":false},{"type":"object","properties":{"any":{"type":"array","items":{}}},"required":["any"],"additionalProperties":false},{"type":"object","properties":{"not":{}},"required":["not"],"additionalProperties":false}]},"event":{"discriminator":{"propertyName":"type"},"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["approve"]},"params":{"type":"object","properties":{"comment":{"type":"string"},"duration":{"type":"number","minimum":1},"durationUnit":{"type":"string","enum":["HOURS","DAYS","WEEKS","MONTHS","YEARS"]}},"additionalProperties":false}},"required":["type","params"]},{"type":"object","properties":{"type":{"type":"string","enum":["deny"]},"params":{"type":"object","properties":{"comment":{"type":"string"}}}},"required":["type","params"]},{"type":"object","properties":{"type":{"type":"string","enum":["review"]},"params":{"type":"object","properties":{"stages":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"all":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["USER"],"description":"Entity type"},"id":{"type":"string","description":"Entity ID"},"displayName":{"type":"string","description":"Entity display name"}},"required":["type","id"]},{"type":"object","properties":{"type":{"type":"string","enum":["GROUP"],"description":"Entity type"},"id":{"type":"number","description":"Entity ID"},"iamId":{"type":"string","description":"IAM ID"},"name":{"type":"string","description":"Entity display name"}},"required":["type","name"]},{"type":"object","properties":{"type":{"type":"string","enum":["PERMISSION"]},"permission":{"type":"string","enum":["GOVERNANCE","USER_ADMIN","AUDIT"],"description":"Global permission"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["DOMAIN PERMISSION"]},"permission":{"type":"string","enum":["Manage Policies","Audit Activity","Manage Data Products","Manage Identifiers"],"description":"Domain permission"},"domainId":{"type":"string","description":"Domain ID"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["ATTRIBUTE"]},"key":{"type":"string","description":"Attribute key"},"value":{"type":"string","description":"Attribute value"}},"required":["type","key","value"]}]},"minItems":1}},"required":["all"]},{"type":"object","properties":{"any":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["USER"],"description":"Entity type"},"id":{"type":"string","description":"Entity ID"},"displayName":{"type":"string","description":"Entity display name"}},"required":["type","id"]},{"type":"object","properties":{"type":{"type":"string","enum":["GROUP"],"description":"Entity type"},"id":{"type":"number","description":"Entity ID"},"iamId":{"type":"string","description":"IAM ID"},"name":{"type":"string","description":"Entity display name"}},"required":["type","name"]},{"type":"object","properties":{"type":{"type":"string","enum":["PERMISSION"]},"permission":{"type":"string","enum":["GOVERNANCE","USER_ADMIN","AUDIT"],"description":"Global permission"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["DOMAIN PERMISSION"]},"permission":{"type":"string","enum":["Manage Policies","Audit Activity","Manage Data Products","Manage Identifiers"],"description":"Domain permission"},"domainId":{"type":"string","description":"Domain ID"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["ATTRIBUTE"]},"key":{"type":"string","description":"Attribute key"},"value":{"type":"string","description":"Attribute value"}},"required":["type","key","value"]}]},"minItems":1}},"required":["any"]}]},"description":"Array of stages for manual review"}},"required":["stages"]}},"required":["type","params"]},{"type":"object","properties":{"type":{"type":"string","enum":["dataProductPolicy"]}},"required":["type"]}]}},"required":["conditions","event"]}},"defaultEvent":{"discriminator":{"propertyName":"type"},"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["approve"]},"params":{"type":"object","properties":{"comment":{"type":"string"},"duration":{"type":"number","minimum":1},"durationUnit":{"type":"string","enum":["HOURS","DAYS","WEEKS","MONTHS","YEARS"]}},"additionalProperties":false}},"required":["type","params"]},{"type":"object","properties":{"type":{"type":"string","enum":["review"]},"params":{"type":"object","properties":{"stages":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"all":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["USER"],"description":"Entity type"},"id":{"type":"string","description":"Entity ID"},"displayName":{"type":"string","description":"Entity display name"}},"required":["type","id"]},{"type":"object","properties":{"type":{"type":"string","enum":["GROUP"],"description":"Entity type"},"id":{"type":"number","description":"Entity ID"},"iamId":{"type":"string","description":"IAM ID"},"name":{"type":"string","description":"Entity display name"}},"required":["type","name"]},{"type":"object","properties":{"type":{"type":"string","enum":["PERMISSION"]},"permission":{"type":"string","enum":["GOVERNANCE","USER_ADMIN","AUDIT"],"description":"Global permission"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["DOMAIN PERMISSION"]},"permission":{"type":"string","enum":["Manage Policies","Audit Activity","Manage Data Products","Manage Identifiers"],"description":"Domain permission"},"domainId":{"type":"string","description":"Domain ID"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["ATTRIBUTE"]},"key":{"type":"string","description":"Attribute key"},"value":{"type":"string","description":"Attribute value"}},"required":["type","key","value"]}]},"minItems":1}},"required":["all"]},{"type":"object","properties":{"any":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["USER"],"description":"Entity type"},"id":{"type":"string","description":"Entity ID"},"displayName":{"type":"string","description":"Entity display name"}},"required":["type","id"]},{"type":"object","properties":{"type":{"type":"string","enum":["GROUP"],"description":"Entity type"},"id":{"type":"number","description":"Entity ID"},"iamId":{"type":"string","description":"IAM ID"},"name":{"type":"string","description":"Entity display name"}},"required":["type","name"]},{"type":"object","properties":{"type":{"type":"string","enum":["PERMISSION"]},"permission":{"type":"string","enum":["GOVERNANCE","USER_ADMIN","AUDIT"],"description":"Global permission"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["DOMAIN PERMISSION"]},"permission":{"type":"string","enum":["Manage Policies","Audit Activity","Manage Data Products","Manage Identifiers"],"description":"Domain permission"},"domainId":{"type":"string","description":"Domain ID"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["ATTRIBUTE"]},"key":{"type":"string","description":"Attribute key"},"value":{"type":"string","description":"Attribute value"}},"required":["type","key","value"]}]},"minItems":1}},"required":["any"]}]},"description":"Array of stages for manual review"}},"required":["stages"]}},"required":["type","params"]}]}},"required":["rules","defaultEvent"],"description":"Data product data access policy","title":"Data Product Data Access Policy"},"maskingExceptionPolicy":{"default":{"rules":[],"defaultEvent":{"type":"review","params":{"stages":[{"any":[{"type":"PERMISSION","permission":"GOVERNANCE"},{"type":"DOMAIN PERMISSION","permission":"Manage Data Products"}]}]}}},"type":"object","properties":{"version":{"type":"string","description":"Policy schema version"},"rules":{"type":"array","items":{"type":"object","properties":{"conditions":{"oneOf":[{"type":"object","properties":{"all":{"type":"array","items":{}}},"required":["all"],"additionalProperties":false},{"type":"object","properties":{"any":{"type":"array","items":{}}},"required":["any"],"additionalProperties":false},{"type":"object","properties":{"not":{}},"required":["not"],"additionalProperties":false}]},"event":{"discriminator":{"propertyName":"type"},"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["approve"]},"params":{"type":"object","properties":{"comment":{"type":"string"},"duration":{"type":"number","minimum":1},"durationUnit":{"type":"string","enum":["HOURS","DAYS","WEEKS","MONTHS","YEARS"]}},"additionalProperties":false}},"required":["type","params"]},{"type":"object","properties":{"type":{"type":"string","enum":["deny"]},"params":{"type":"object","properties":{"comment":{"type":"string"}}}},"required":["type","params"]},{"type":"object","properties":{"type":{"type":"string","enum":["review"]},"params":{"type":"object","properties":{"stages":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"all":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["USER"],"description":"Entity type"},"id":{"type":"string","description":"Entity ID"},"displayName":{"type":"string","description":"Entity display name"}},"required":["type","id"]},{"type":"object","properties":{"type":{"type":"string","enum":["GROUP"],"description":"Entity type"},"id":{"type":"number","description":"Entity ID"},"iamId":{"type":"string","description":"IAM ID"},"name":{"type":"string","description":"Entity display name"}},"required":["type","name"]},{"type":"object","properties":{"type":{"type":"string","enum":["PERMISSION"]},"permission":{"type":"string","enum":["GOVERNANCE","USER_ADMIN","AUDIT"],"description":"Global permission"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["DOMAIN PERMISSION"]},"permission":{"type":"string","enum":["Manage Policies","Audit Activity","Manage Data Products","Manage Identifiers"],"description":"Domain permission"},"domainId":{"type":"string","description":"Domain ID"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["ATTRIBUTE"]},"key":{"type":"string","description":"Attribute key"},"value":{"type":"string","description":"Attribute value"}},"required":["type","key","value"]}]},"minItems":1}},"required":["all"]},{"type":"object","properties":{"any":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["USER"],"description":"Entity type"},"id":{"type":"string","description":"Entity ID"},"displayName":{"type":"string","description":"Entity display name"}},"required":["type","id"]},{"type":"object","properties":{"type":{"type":"string","enum":["GROUP"],"description":"Entity type"},"id":{"type":"number","description":"Entity ID"},"iamId":{"type":"string","description":"IAM ID"},"name":{"type":"string","description":"Entity display name"}},"required":["type","name"]},{"type":"object","properties":{"type":{"type":"string","enum":["PERMISSION"]},"permission":{"type":"string","enum":["GOVERNANCE","USER_ADMIN","AUDIT"],"description":"Global permission"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["DOMAIN PERMISSION"]},"permission":{"type":"string","enum":["Manage Policies","Audit Activity","Manage Data Products","Manage Identifiers"],"description":"Domain permission"},"domainId":{"type":"string","description":"Domain ID"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["ATTRIBUTE"]},"key":{"type":"string","description":"Attribute key"},"value":{"type":"string","description":"Attribute value"}},"required":["type","key","value"]}]},"minItems":1}},"required":["any"]}]},"description":"Array of stages for manual review"}},"required":["stages"]}},"required":["type","params"]},{"type":"object","properties":{"type":{"type":"string","enum":["dataProductPolicy"]}},"required":["type"]}]}},"required":["conditions","event"]}},"defaultEvent":{"discriminator":{"propertyName":"type"},"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["approve"]},"params":{"type":"object","properties":{"comment":{"type":"string"},"duration":{"type":"number","minimum":1},"durationUnit":{"type":"string","enum":["HOURS","DAYS","WEEKS","MONTHS","YEARS"]}},"additionalProperties":false}},"required":["type","params"]},{"type":"object","properties":{"type":{"type":"string","enum":["review"]},"params":{"type":"object","properties":{"stages":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"all":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["USER"],"description":"Entity type"},"id":{"type":"string","description":"Entity ID"},"displayName":{"type":"string","description":"Entity display name"}},"required":["type","id"]},{"type":"object","properties":{"type":{"type":"string","enum":["GROUP"],"description":"Entity type"},"id":{"type":"number","description":"Entity ID"},"iamId":{"type":"string","description":"IAM ID"},"name":{"type":"string","description":"Entity display name"}},"required":["type","name"]},{"type":"object","properties":{"type":{"type":"string","enum":["PERMISSION"]},"permission":{"type":"string","enum":["GOVERNANCE","USER_ADMIN","AUDIT"],"description":"Global permission"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["DOMAIN PERMISSION"]},"permission":{"type":"string","enum":["Manage Policies","Audit Activity","Manage Data Products","Manage Identifiers"],"description":"Domain permission"},"domainId":{"type":"string","description":"Domain ID"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["ATTRIBUTE"]},"key":{"type":"string","description":"Attribute key"},"value":{"type":"string","description":"Attribute value"}},"required":["type","key","value"]}]},"minItems":1}},"required":["all"]},{"type":"object","properties":{"any":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["USER"],"description":"Entity type"},"id":{"type":"string","description":"Entity ID"},"displayName":{"type":"string","description":"Entity display name"}},"required":["type","id"]},{"type":"object","properties":{"type":{"type":"string","enum":["GROUP"],"description":"Entity type"},"id":{"type":"number","description":"Entity ID"},"iamId":{"type":"string","description":"IAM ID"},"name":{"type":"string","description":"Entity display name"}},"required":["type","name"]},{"type":"object","properties":{"type":{"type":"string","enum":["PERMISSION"]},"permission":{"type":"string","enum":["GOVERNANCE","USER_ADMIN","AUDIT"],"description":"Global permission"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["DOMAIN PERMISSION"]},"permission":{"type":"string","enum":["Manage Policies","Audit Activity","Manage Data Products","Manage Identifiers"],"description":"Domain permission"},"domainId":{"type":"string","description":"Domain ID"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["ATTRIBUTE"]},"key":{"type":"string","description":"Attribute key"},"value":{"type":"string","description":"Attribute value"}},"required":["type","key","value"]}]},"minItems":1}},"required":["any"]}]},"description":"Array of stages for manual review"}},"required":["stages"]}},"required":["type","params"]}]}},"required":["rules","defaultEvent"],"description":"Data product masking exception policy","title":"Data Product Masking Exception Policy"}},"required":["id","name","domains","suspended","createdBy","createdAt","updatedAt","metadata"]}}},"paths":{"/api/data-product/{id}":{"get":{"description":"Get data product metadata for the specified data product ID","operationId":"getDataProductById","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataProduct"}}}}},"summary":"Get data product by ID","tags":["Data Product"]}}}}
```

## Update an existing data product

> Update an existing data product by ID

```json
{"openapi":"3.0.0","info":{"title":"Immuta Data Marketplace","version":"1.0"},"tags":[{"name":"Data Product","description":"APIs for managing data products"}],"servers":[{"url":"https://{global-segment}.api.immutacloud.com/marketplace","description":"Marketplace API Endpoint","variables":{"global-segment":{"default":"na","enum":["na","eu","ap"],"description":"Marketplace API global segment"}}}],"security":[{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"scheme":"bearer","bearerFormat":"JWT","type":"http"}},"schemas":{"UpdateDataProduct":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":255,"pattern":"^[a-zA-Z0-9)(\\-_/\\\\\\s]*$","description":"Data product name"},"description":{"oneOf":[{"type":"string","description":"Data product description"}],"nullable":true,"description":"Data product description"},"metadata":{"oneOf":[{"type":"object","properties":{"subjectMatterExpert":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Immuta global user ID of the subject matter expert for this data product"},"username":{"type":"string"},"name":{"type":"string"}},"required":["id"]}},"required":["subjectMatterExpert"]}],"nullable":true},"domains":{"type":"array","items":{"type":"string"},"minItems":1},"dataAccessPolicy":{"type":"object","properties":{"version":{"type":"string","description":"Policy schema version"},"rules":{"type":"array","items":{"type":"object","properties":{"conditions":{"oneOf":[{"type":"object","properties":{"all":{"type":"array","items":{}}},"required":["all"],"additionalProperties":false},{"type":"object","properties":{"any":{"type":"array","items":{}}},"required":["any"],"additionalProperties":false},{"type":"object","properties":{"not":{}},"required":["not"],"additionalProperties":false}]},"event":{"discriminator":{"propertyName":"type"},"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["approve"]},"params":{"type":"object","properties":{"comment":{"type":"string"},"duration":{"type":"number","minimum":1},"durationUnit":{"type":"string","enum":["HOURS","DAYS","WEEKS","MONTHS","YEARS"]}},"additionalProperties":false}},"required":["type","params"]},{"type":"object","properties":{"type":{"type":"string","enum":["deny"]},"params":{"type":"object","properties":{"comment":{"type":"string"}}}},"required":["type","params"]},{"type":"object","properties":{"type":{"type":"string","enum":["review"]},"params":{"type":"object","properties":{"stages":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"all":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["USER"],"description":"Entity type"},"id":{"type":"string","description":"Entity ID"},"displayName":{"type":"string","description":"Entity display name"}},"required":["type","id"]},{"type":"object","properties":{"type":{"type":"string","enum":["GROUP"],"description":"Entity type"},"id":{"type":"number","description":"Entity ID"},"iamId":{"type":"string","description":"IAM ID"},"name":{"type":"string","description":"Entity display name"}},"required":["type","name"]},{"type":"object","properties":{"type":{"type":"string","enum":["PERMISSION"]},"permission":{"type":"string","enum":["GOVERNANCE","USER_ADMIN","AUDIT"],"description":"Global permission"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["DOMAIN PERMISSION"]},"permission":{"type":"string","enum":["Manage Policies","Audit Activity","Manage Data Products","Manage Identifiers"],"description":"Domain permission"},"domainId":{"type":"string","description":"Domain ID"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["ATTRIBUTE"]},"key":{"type":"string","description":"Attribute key"},"value":{"type":"string","description":"Attribute value"}},"required":["type","key","value"]}]},"minItems":1}},"required":["all"]},{"type":"object","properties":{"any":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["USER"],"description":"Entity type"},"id":{"type":"string","description":"Entity ID"},"displayName":{"type":"string","description":"Entity display name"}},"required":["type","id"]},{"type":"object","properties":{"type":{"type":"string","enum":["GROUP"],"description":"Entity type"},"id":{"type":"number","description":"Entity ID"},"iamId":{"type":"string","description":"IAM ID"},"name":{"type":"string","description":"Entity display name"}},"required":["type","name"]},{"type":"object","properties":{"type":{"type":"string","enum":["PERMISSION"]},"permission":{"type":"string","enum":["GOVERNANCE","USER_ADMIN","AUDIT"],"description":"Global permission"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["DOMAIN PERMISSION"]},"permission":{"type":"string","enum":["Manage Policies","Audit Activity","Manage Data Products","Manage Identifiers"],"description":"Domain permission"},"domainId":{"type":"string","description":"Domain ID"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["ATTRIBUTE"]},"key":{"type":"string","description":"Attribute key"},"value":{"type":"string","description":"Attribute value"}},"required":["type","key","value"]}]},"minItems":1}},"required":["any"]}]},"description":"Array of stages for manual review"}},"required":["stages"]}},"required":["type","params"]},{"type":"object","properties":{"type":{"type":"string","enum":["dataProductPolicy"]}},"required":["type"]}]}},"required":["conditions","event"]}},"defaultEvent":{"discriminator":{"propertyName":"type"},"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["approve"]},"params":{"type":"object","properties":{"comment":{"type":"string"},"duration":{"type":"number","minimum":1},"durationUnit":{"type":"string","enum":["HOURS","DAYS","WEEKS","MONTHS","YEARS"]}},"additionalProperties":false}},"required":["type","params"]},{"type":"object","properties":{"type":{"type":"string","enum":["review"]},"params":{"type":"object","properties":{"stages":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"all":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["USER"],"description":"Entity type"},"id":{"type":"string","description":"Entity ID"},"displayName":{"type":"string","description":"Entity display name"}},"required":["type","id"]},{"type":"object","properties":{"type":{"type":"string","enum":["GROUP"],"description":"Entity type"},"id":{"type":"number","description":"Entity ID"},"iamId":{"type":"string","description":"IAM ID"},"name":{"type":"string","description":"Entity display name"}},"required":["type","name"]},{"type":"object","properties":{"type":{"type":"string","enum":["PERMISSION"]},"permission":{"type":"string","enum":["GOVERNANCE","USER_ADMIN","AUDIT"],"description":"Global permission"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["DOMAIN PERMISSION"]},"permission":{"type":"string","enum":["Manage Policies","Audit Activity","Manage Data Products","Manage Identifiers"],"description":"Domain permission"},"domainId":{"type":"string","description":"Domain ID"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["ATTRIBUTE"]},"key":{"type":"string","description":"Attribute key"},"value":{"type":"string","description":"Attribute value"}},"required":["type","key","value"]}]},"minItems":1}},"required":["all"]},{"type":"object","properties":{"any":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["USER"],"description":"Entity type"},"id":{"type":"string","description":"Entity ID"},"displayName":{"type":"string","description":"Entity display name"}},"required":["type","id"]},{"type":"object","properties":{"type":{"type":"string","enum":["GROUP"],"description":"Entity type"},"id":{"type":"number","description":"Entity ID"},"iamId":{"type":"string","description":"IAM ID"},"name":{"type":"string","description":"Entity display name"}},"required":["type","name"]},{"type":"object","properties":{"type":{"type":"string","enum":["PERMISSION"]},"permission":{"type":"string","enum":["GOVERNANCE","USER_ADMIN","AUDIT"],"description":"Global permission"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["DOMAIN PERMISSION"]},"permission":{"type":"string","enum":["Manage Policies","Audit Activity","Manage Data Products","Manage Identifiers"],"description":"Domain permission"},"domainId":{"type":"string","description":"Domain ID"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["ATTRIBUTE"]},"key":{"type":"string","description":"Attribute key"},"value":{"type":"string","description":"Attribute value"}},"required":["type","key","value"]}]},"minItems":1}},"required":["any"]}]},"description":"Array of stages for manual review"}},"required":["stages"]}},"required":["type","params"]}]}},"required":["rules","defaultEvent"]},"maskingExceptionPolicy":{"type":"object","properties":{"version":{"type":"string","description":"Policy schema version"},"rules":{"type":"array","items":{"type":"object","properties":{"conditions":{"oneOf":[{"type":"object","properties":{"all":{"type":"array","items":{}}},"required":["all"],"additionalProperties":false},{"type":"object","properties":{"any":{"type":"array","items":{}}},"required":["any"],"additionalProperties":false},{"type":"object","properties":{"not":{}},"required":["not"],"additionalProperties":false}]},"event":{"discriminator":{"propertyName":"type"},"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["approve"]},"params":{"type":"object","properties":{"comment":{"type":"string"},"duration":{"type":"number","minimum":1},"durationUnit":{"type":"string","enum":["HOURS","DAYS","WEEKS","MONTHS","YEARS"]}},"additionalProperties":false}},"required":["type","params"]},{"type":"object","properties":{"type":{"type":"string","enum":["deny"]},"params":{"type":"object","properties":{"comment":{"type":"string"}}}},"required":["type","params"]},{"type":"object","properties":{"type":{"type":"string","enum":["review"]},"params":{"type":"object","properties":{"stages":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"all":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["USER"],"description":"Entity type"},"id":{"type":"string","description":"Entity ID"},"displayName":{"type":"string","description":"Entity display name"}},"required":["type","id"]},{"type":"object","properties":{"type":{"type":"string","enum":["GROUP"],"description":"Entity type"},"id":{"type":"number","description":"Entity ID"},"iamId":{"type":"string","description":"IAM ID"},"name":{"type":"string","description":"Entity display name"}},"required":["type","name"]},{"type":"object","properties":{"type":{"type":"string","enum":["PERMISSION"]},"permission":{"type":"string","enum":["GOVERNANCE","USER_ADMIN","AUDIT"],"description":"Global permission"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["DOMAIN PERMISSION"]},"permission":{"type":"string","enum":["Manage Policies","Audit Activity","Manage Data Products","Manage Identifiers"],"description":"Domain permission"},"domainId":{"type":"string","description":"Domain ID"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["ATTRIBUTE"]},"key":{"type":"string","description":"Attribute key"},"value":{"type":"string","description":"Attribute value"}},"required":["type","key","value"]}]},"minItems":1}},"required":["all"]},{"type":"object","properties":{"any":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["USER"],"description":"Entity type"},"id":{"type":"string","description":"Entity ID"},"displayName":{"type":"string","description":"Entity display name"}},"required":["type","id"]},{"type":"object","properties":{"type":{"type":"string","enum":["GROUP"],"description":"Entity type"},"id":{"type":"number","description":"Entity ID"},"iamId":{"type":"string","description":"IAM ID"},"name":{"type":"string","description":"Entity display name"}},"required":["type","name"]},{"type":"object","properties":{"type":{"type":"string","enum":["PERMISSION"]},"permission":{"type":"string","enum":["GOVERNANCE","USER_ADMIN","AUDIT"],"description":"Global permission"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["DOMAIN PERMISSION"]},"permission":{"type":"string","enum":["Manage Policies","Audit Activity","Manage Data Products","Manage Identifiers"],"description":"Domain permission"},"domainId":{"type":"string","description":"Domain ID"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["ATTRIBUTE"]},"key":{"type":"string","description":"Attribute key"},"value":{"type":"string","description":"Attribute value"}},"required":["type","key","value"]}]},"minItems":1}},"required":["any"]}]},"description":"Array of stages for manual review"}},"required":["stages"]}},"required":["type","params"]},{"type":"object","properties":{"type":{"type":"string","enum":["dataProductPolicy"]}},"required":["type"]}]}},"required":["conditions","event"]}},"defaultEvent":{"discriminator":{"propertyName":"type"},"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["approve"]},"params":{"type":"object","properties":{"comment":{"type":"string"},"duration":{"type":"number","minimum":1},"durationUnit":{"type":"string","enum":["HOURS","DAYS","WEEKS","MONTHS","YEARS"]}},"additionalProperties":false}},"required":["type","params"]},{"type":"object","properties":{"type":{"type":"string","enum":["review"]},"params":{"type":"object","properties":{"stages":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"all":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["USER"],"description":"Entity type"},"id":{"type":"string","description":"Entity ID"},"displayName":{"type":"string","description":"Entity display name"}},"required":["type","id"]},{"type":"object","properties":{"type":{"type":"string","enum":["GROUP"],"description":"Entity type"},"id":{"type":"number","description":"Entity ID"},"iamId":{"type":"string","description":"IAM ID"},"name":{"type":"string","description":"Entity display name"}},"required":["type","name"]},{"type":"object","properties":{"type":{"type":"string","enum":["PERMISSION"]},"permission":{"type":"string","enum":["GOVERNANCE","USER_ADMIN","AUDIT"],"description":"Global permission"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["DOMAIN PERMISSION"]},"permission":{"type":"string","enum":["Manage Policies","Audit Activity","Manage Data Products","Manage Identifiers"],"description":"Domain permission"},"domainId":{"type":"string","description":"Domain ID"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["ATTRIBUTE"]},"key":{"type":"string","description":"Attribute key"},"value":{"type":"string","description":"Attribute value"}},"required":["type","key","value"]}]},"minItems":1}},"required":["all"]},{"type":"object","properties":{"any":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["USER"],"description":"Entity type"},"id":{"type":"string","description":"Entity ID"},"displayName":{"type":"string","description":"Entity display name"}},"required":["type","id"]},{"type":"object","properties":{"type":{"type":"string","enum":["GROUP"],"description":"Entity type"},"id":{"type":"number","description":"Entity ID"},"iamId":{"type":"string","description":"IAM ID"},"name":{"type":"string","description":"Entity display name"}},"required":["type","name"]},{"type":"object","properties":{"type":{"type":"string","enum":["PERMISSION"]},"permission":{"type":"string","enum":["GOVERNANCE","USER_ADMIN","AUDIT"],"description":"Global permission"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["DOMAIN PERMISSION"]},"permission":{"type":"string","enum":["Manage Policies","Audit Activity","Manage Data Products","Manage Identifiers"],"description":"Domain permission"},"domainId":{"type":"string","description":"Domain ID"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["ATTRIBUTE"]},"key":{"type":"string","description":"Attribute key"},"value":{"type":"string","description":"Attribute value"}},"required":["type","key","value"]}]},"minItems":1}},"required":["any"]}]},"description":"Array of stages for manual review"}},"required":["stages"]}},"required":["type","params"]}]}},"required":["rules","defaultEvent"]},"id":{"type":"string","format":"uuid","description":"Data product ID"},"dataSources":{"type":"array","items":{"type":"object","properties":{"sourceId":{"type":"string"}},"required":["sourceId"]}},"requestFormId":{"oneOf":[{"type":"string","format":"cuid"},{"type":"string","format":"uuid"}]},"suspended":{"type":"boolean","description":"Whether access to the data product's data sources is suspended"}}},"DataProduct":{"type":"object","properties":{"id":{"oneOf":[{"type":"string","format":"cuid"},{"type":"string","format":"uuid"}]},"name":{"type":"string","minLength":1,"maxLength":255,"pattern":"^[a-zA-Z0-9)(\\-_/\\\\\\s]*$","description":"Data product name"},"description":{"oneOf":[{"type":"string","description":"Data product description"}],"nullable":true,"description":"Data product description"},"domains":{"type":"array","items":{"type":"string"},"minItems":1},"suspended":{"type":"boolean","description":"Whether access to the data product's data sources is suspended"},"createdBy":{"type":"string","format":"uuid","description":"Immuta global user ID of the user who created the data product"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"status":{"type":"string","enum":["APPROVED","CANCELED","DENIED","PENDING","NONE","PUBLISHER","REVOKED","EXPIRED"]},"expiration":{"oneOf":[{"type":"string","format":"date-time"}],"nullable":true},"stats":{"type":"object","properties":{"dataSourceCount":{"type":"integer","description":"Count of data sources in a data product"},"pendingRequestCount":{"type":"integer","description":"Count of pending requests for a data product"},"approvedRequestCount":{"type":"integer","description":"Count of approved requests for a data product"},"revokedRequestCount":{"type":"integer","description":"Count of revoked requests for a data product"},"canceledRequestCount":{"type":"integer","description":"Count of canceled requests for a data product"},"deniedRequestCount":{"type":"integer","description":"Count of denied requests for a data product"},"totalRequestCount":{"type":"integer","description":"Count of total requests for a data product"}},"required":["dataSourceCount","pendingRequestCount","approvedRequestCount","revokedRequestCount","canceledRequestCount","deniedRequestCount","totalRequestCount"],"description":"Data product statistics","title":"Data Product Stats"},"requestId":{"type":"string","format":"cuid","description":"If requested, the ID of the access request for the data product"},"sourceTypes":{"type":"array","items":{"type":"string"},"description":"The types of data sources contained in the data product."},"metadata":{"oneOf":[{"type":"object","properties":{"subjectMatterExpert":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Immuta global user ID of the subject matter expert for this data product"},"username":{"type":"string"},"name":{"type":"string"}},"required":["id"]}},"required":["subjectMatterExpert"]}],"nullable":true},"dataAccessPolicy":{"default":{"rules":[],"defaultEvent":{"type":"review","params":{"stages":[{"any":[{"type":"PERMISSION","permission":"GOVERNANCE"},{"type":"DOMAIN PERMISSION","permission":"Manage Data Products"}]}]}}},"type":"object","properties":{"version":{"type":"string","description":"Policy schema version"},"rules":{"type":"array","items":{"type":"object","properties":{"conditions":{"oneOf":[{"type":"object","properties":{"all":{"type":"array","items":{}}},"required":["all"],"additionalProperties":false},{"type":"object","properties":{"any":{"type":"array","items":{}}},"required":["any"],"additionalProperties":false},{"type":"object","properties":{"not":{}},"required":["not"],"additionalProperties":false}]},"event":{"discriminator":{"propertyName":"type"},"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["approve"]},"params":{"type":"object","properties":{"comment":{"type":"string"},"duration":{"type":"number","minimum":1},"durationUnit":{"type":"string","enum":["HOURS","DAYS","WEEKS","MONTHS","YEARS"]}},"additionalProperties":false}},"required":["type","params"]},{"type":"object","properties":{"type":{"type":"string","enum":["deny"]},"params":{"type":"object","properties":{"comment":{"type":"string"}}}},"required":["type","params"]},{"type":"object","properties":{"type":{"type":"string","enum":["review"]},"params":{"type":"object","properties":{"stages":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"all":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["USER"],"description":"Entity type"},"id":{"type":"string","description":"Entity ID"},"displayName":{"type":"string","description":"Entity display name"}},"required":["type","id"]},{"type":"object","properties":{"type":{"type":"string","enum":["GROUP"],"description":"Entity type"},"id":{"type":"number","description":"Entity ID"},"iamId":{"type":"string","description":"IAM ID"},"name":{"type":"string","description":"Entity display name"}},"required":["type","name"]},{"type":"object","properties":{"type":{"type":"string","enum":["PERMISSION"]},"permission":{"type":"string","enum":["GOVERNANCE","USER_ADMIN","AUDIT"],"description":"Global permission"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["DOMAIN PERMISSION"]},"permission":{"type":"string","enum":["Manage Policies","Audit Activity","Manage Data Products","Manage Identifiers"],"description":"Domain permission"},"domainId":{"type":"string","description":"Domain ID"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["ATTRIBUTE"]},"key":{"type":"string","description":"Attribute key"},"value":{"type":"string","description":"Attribute value"}},"required":["type","key","value"]}]},"minItems":1}},"required":["all"]},{"type":"object","properties":{"any":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["USER"],"description":"Entity type"},"id":{"type":"string","description":"Entity ID"},"displayName":{"type":"string","description":"Entity display name"}},"required":["type","id"]},{"type":"object","properties":{"type":{"type":"string","enum":["GROUP"],"description":"Entity type"},"id":{"type":"number","description":"Entity ID"},"iamId":{"type":"string","description":"IAM ID"},"name":{"type":"string","description":"Entity display name"}},"required":["type","name"]},{"type":"object","properties":{"type":{"type":"string","enum":["PERMISSION"]},"permission":{"type":"string","enum":["GOVERNANCE","USER_ADMIN","AUDIT"],"description":"Global permission"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["DOMAIN PERMISSION"]},"permission":{"type":"string","enum":["Manage Policies","Audit Activity","Manage Data Products","Manage Identifiers"],"description":"Domain permission"},"domainId":{"type":"string","description":"Domain ID"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["ATTRIBUTE"]},"key":{"type":"string","description":"Attribute key"},"value":{"type":"string","description":"Attribute value"}},"required":["type","key","value"]}]},"minItems":1}},"required":["any"]}]},"description":"Array of stages for manual review"}},"required":["stages"]}},"required":["type","params"]},{"type":"object","properties":{"type":{"type":"string","enum":["dataProductPolicy"]}},"required":["type"]}]}},"required":["conditions","event"]}},"defaultEvent":{"discriminator":{"propertyName":"type"},"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["approve"]},"params":{"type":"object","properties":{"comment":{"type":"string"},"duration":{"type":"number","minimum":1},"durationUnit":{"type":"string","enum":["HOURS","DAYS","WEEKS","MONTHS","YEARS"]}},"additionalProperties":false}},"required":["type","params"]},{"type":"object","properties":{"type":{"type":"string","enum":["review"]},"params":{"type":"object","properties":{"stages":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"all":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["USER"],"description":"Entity type"},"id":{"type":"string","description":"Entity ID"},"displayName":{"type":"string","description":"Entity display name"}},"required":["type","id"]},{"type":"object","properties":{"type":{"type":"string","enum":["GROUP"],"description":"Entity type"},"id":{"type":"number","description":"Entity ID"},"iamId":{"type":"string","description":"IAM ID"},"name":{"type":"string","description":"Entity display name"}},"required":["type","name"]},{"type":"object","properties":{"type":{"type":"string","enum":["PERMISSION"]},"permission":{"type":"string","enum":["GOVERNANCE","USER_ADMIN","AUDIT"],"description":"Global permission"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["DOMAIN PERMISSION"]},"permission":{"type":"string","enum":["Manage Policies","Audit Activity","Manage Data Products","Manage Identifiers"],"description":"Domain permission"},"domainId":{"type":"string","description":"Domain ID"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["ATTRIBUTE"]},"key":{"type":"string","description":"Attribute key"},"value":{"type":"string","description":"Attribute value"}},"required":["type","key","value"]}]},"minItems":1}},"required":["all"]},{"type":"object","properties":{"any":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["USER"],"description":"Entity type"},"id":{"type":"string","description":"Entity ID"},"displayName":{"type":"string","description":"Entity display name"}},"required":["type","id"]},{"type":"object","properties":{"type":{"type":"string","enum":["GROUP"],"description":"Entity type"},"id":{"type":"number","description":"Entity ID"},"iamId":{"type":"string","description":"IAM ID"},"name":{"type":"string","description":"Entity display name"}},"required":["type","name"]},{"type":"object","properties":{"type":{"type":"string","enum":["PERMISSION"]},"permission":{"type":"string","enum":["GOVERNANCE","USER_ADMIN","AUDIT"],"description":"Global permission"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["DOMAIN PERMISSION"]},"permission":{"type":"string","enum":["Manage Policies","Audit Activity","Manage Data Products","Manage Identifiers"],"description":"Domain permission"},"domainId":{"type":"string","description":"Domain ID"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["ATTRIBUTE"]},"key":{"type":"string","description":"Attribute key"},"value":{"type":"string","description":"Attribute value"}},"required":["type","key","value"]}]},"minItems":1}},"required":["any"]}]},"description":"Array of stages for manual review"}},"required":["stages"]}},"required":["type","params"]}]}},"required":["rules","defaultEvent"],"description":"Data product data access policy","title":"Data Product Data Access Policy"},"maskingExceptionPolicy":{"default":{"rules":[],"defaultEvent":{"type":"review","params":{"stages":[{"any":[{"type":"PERMISSION","permission":"GOVERNANCE"},{"type":"DOMAIN PERMISSION","permission":"Manage Data Products"}]}]}}},"type":"object","properties":{"version":{"type":"string","description":"Policy schema version"},"rules":{"type":"array","items":{"type":"object","properties":{"conditions":{"oneOf":[{"type":"object","properties":{"all":{"type":"array","items":{}}},"required":["all"],"additionalProperties":false},{"type":"object","properties":{"any":{"type":"array","items":{}}},"required":["any"],"additionalProperties":false},{"type":"object","properties":{"not":{}},"required":["not"],"additionalProperties":false}]},"event":{"discriminator":{"propertyName":"type"},"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["approve"]},"params":{"type":"object","properties":{"comment":{"type":"string"},"duration":{"type":"number","minimum":1},"durationUnit":{"type":"string","enum":["HOURS","DAYS","WEEKS","MONTHS","YEARS"]}},"additionalProperties":false}},"required":["type","params"]},{"type":"object","properties":{"type":{"type":"string","enum":["deny"]},"params":{"type":"object","properties":{"comment":{"type":"string"}}}},"required":["type","params"]},{"type":"object","properties":{"type":{"type":"string","enum":["review"]},"params":{"type":"object","properties":{"stages":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"all":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["USER"],"description":"Entity type"},"id":{"type":"string","description":"Entity ID"},"displayName":{"type":"string","description":"Entity display name"}},"required":["type","id"]},{"type":"object","properties":{"type":{"type":"string","enum":["GROUP"],"description":"Entity type"},"id":{"type":"number","description":"Entity ID"},"iamId":{"type":"string","description":"IAM ID"},"name":{"type":"string","description":"Entity display name"}},"required":["type","name"]},{"type":"object","properties":{"type":{"type":"string","enum":["PERMISSION"]},"permission":{"type":"string","enum":["GOVERNANCE","USER_ADMIN","AUDIT"],"description":"Global permission"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["DOMAIN PERMISSION"]},"permission":{"type":"string","enum":["Manage Policies","Audit Activity","Manage Data Products","Manage Identifiers"],"description":"Domain permission"},"domainId":{"type":"string","description":"Domain ID"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["ATTRIBUTE"]},"key":{"type":"string","description":"Attribute key"},"value":{"type":"string","description":"Attribute value"}},"required":["type","key","value"]}]},"minItems":1}},"required":["all"]},{"type":"object","properties":{"any":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["USER"],"description":"Entity type"},"id":{"type":"string","description":"Entity ID"},"displayName":{"type":"string","description":"Entity display name"}},"required":["type","id"]},{"type":"object","properties":{"type":{"type":"string","enum":["GROUP"],"description":"Entity type"},"id":{"type":"number","description":"Entity ID"},"iamId":{"type":"string","description":"IAM ID"},"name":{"type":"string","description":"Entity display name"}},"required":["type","name"]},{"type":"object","properties":{"type":{"type":"string","enum":["PERMISSION"]},"permission":{"type":"string","enum":["GOVERNANCE","USER_ADMIN","AUDIT"],"description":"Global permission"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["DOMAIN PERMISSION"]},"permission":{"type":"string","enum":["Manage Policies","Audit Activity","Manage Data Products","Manage Identifiers"],"description":"Domain permission"},"domainId":{"type":"string","description":"Domain ID"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["ATTRIBUTE"]},"key":{"type":"string","description":"Attribute key"},"value":{"type":"string","description":"Attribute value"}},"required":["type","key","value"]}]},"minItems":1}},"required":["any"]}]},"description":"Array of stages for manual review"}},"required":["stages"]}},"required":["type","params"]},{"type":"object","properties":{"type":{"type":"string","enum":["dataProductPolicy"]}},"required":["type"]}]}},"required":["conditions","event"]}},"defaultEvent":{"discriminator":{"propertyName":"type"},"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["approve"]},"params":{"type":"object","properties":{"comment":{"type":"string"},"duration":{"type":"number","minimum":1},"durationUnit":{"type":"string","enum":["HOURS","DAYS","WEEKS","MONTHS","YEARS"]}},"additionalProperties":false}},"required":["type","params"]},{"type":"object","properties":{"type":{"type":"string","enum":["review"]},"params":{"type":"object","properties":{"stages":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"all":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["USER"],"description":"Entity type"},"id":{"type":"string","description":"Entity ID"},"displayName":{"type":"string","description":"Entity display name"}},"required":["type","id"]},{"type":"object","properties":{"type":{"type":"string","enum":["GROUP"],"description":"Entity type"},"id":{"type":"number","description":"Entity ID"},"iamId":{"type":"string","description":"IAM ID"},"name":{"type":"string","description":"Entity display name"}},"required":["type","name"]},{"type":"object","properties":{"type":{"type":"string","enum":["PERMISSION"]},"permission":{"type":"string","enum":["GOVERNANCE","USER_ADMIN","AUDIT"],"description":"Global permission"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["DOMAIN PERMISSION"]},"permission":{"type":"string","enum":["Manage Policies","Audit Activity","Manage Data Products","Manage Identifiers"],"description":"Domain permission"},"domainId":{"type":"string","description":"Domain ID"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["ATTRIBUTE"]},"key":{"type":"string","description":"Attribute key"},"value":{"type":"string","description":"Attribute value"}},"required":["type","key","value"]}]},"minItems":1}},"required":["all"]},{"type":"object","properties":{"any":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["USER"],"description":"Entity type"},"id":{"type":"string","description":"Entity ID"},"displayName":{"type":"string","description":"Entity display name"}},"required":["type","id"]},{"type":"object","properties":{"type":{"type":"string","enum":["GROUP"],"description":"Entity type"},"id":{"type":"number","description":"Entity ID"},"iamId":{"type":"string","description":"IAM ID"},"name":{"type":"string","description":"Entity display name"}},"required":["type","name"]},{"type":"object","properties":{"type":{"type":"string","enum":["PERMISSION"]},"permission":{"type":"string","enum":["GOVERNANCE","USER_ADMIN","AUDIT"],"description":"Global permission"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["DOMAIN PERMISSION"]},"permission":{"type":"string","enum":["Manage Policies","Audit Activity","Manage Data Products","Manage Identifiers"],"description":"Domain permission"},"domainId":{"type":"string","description":"Domain ID"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["ATTRIBUTE"]},"key":{"type":"string","description":"Attribute key"},"value":{"type":"string","description":"Attribute value"}},"required":["type","key","value"]}]},"minItems":1}},"required":["any"]}]},"description":"Array of stages for manual review"}},"required":["stages"]}},"required":["type","params"]}]}},"required":["rules","defaultEvent"],"description":"Data product masking exception policy","title":"Data Product Masking Exception Policy"}},"required":["id","name","domains","suspended","createdBy","createdAt","updatedAt","metadata"]}}},"paths":{"/api/data-product/{id}":{"put":{"description":"Update an existing data product by ID","operationId":"updateDataProduct","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateDataProduct"}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataProduct"}}}}},"summary":"Update an existing data product","tags":["Data Product"]}}}}
```

## Delete data product by ID

> Delete the specified data product from the system

```json
{"openapi":"3.0.0","info":{"title":"Immuta Data Marketplace","version":"1.0"},"tags":[{"name":"Data Product","description":"APIs for managing data products"}],"servers":[{"url":"https://{global-segment}.api.immutacloud.com/marketplace","description":"Marketplace API Endpoint","variables":{"global-segment":{"default":"na","enum":["na","eu","ap"],"description":"Marketplace API global segment"}}}],"security":[{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"scheme":"bearer","bearerFormat":"JWT","type":"http"}}},"paths":{"/api/data-product/{id}":{"delete":{"description":"Delete the specified data product from the system","operationId":"deleteDataProduct","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"summary":"Delete data product by ID","tags":["Data Product"]}}}}
```

## Get data product by name

> Get data product metadata for the specified data product name

```json
{"openapi":"3.0.0","info":{"title":"Immuta Data Marketplace","version":"1.0"},"tags":[{"name":"Data Product","description":"APIs for managing data products"}],"servers":[{"url":"https://{global-segment}.api.immutacloud.com/marketplace","description":"Marketplace API Endpoint","variables":{"global-segment":{"default":"na","enum":["na","eu","ap"],"description":"Marketplace API global segment"}}}],"security":[{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"scheme":"bearer","bearerFormat":"JWT","type":"http"}},"schemas":{"DataProduct":{"type":"object","properties":{"id":{"oneOf":[{"type":"string","format":"cuid"},{"type":"string","format":"uuid"}]},"name":{"type":"string","minLength":1,"maxLength":255,"pattern":"^[a-zA-Z0-9)(\\-_/\\\\\\s]*$","description":"Data product name"},"description":{"oneOf":[{"type":"string","description":"Data product description"}],"nullable":true,"description":"Data product description"},"domains":{"type":"array","items":{"type":"string"},"minItems":1},"suspended":{"type":"boolean","description":"Whether access to the data product's data sources is suspended"},"createdBy":{"type":"string","format":"uuid","description":"Immuta global user ID of the user who created the data product"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"status":{"type":"string","enum":["APPROVED","CANCELED","DENIED","PENDING","NONE","PUBLISHER","REVOKED","EXPIRED"]},"expiration":{"oneOf":[{"type":"string","format":"date-time"}],"nullable":true},"stats":{"type":"object","properties":{"dataSourceCount":{"type":"integer","description":"Count of data sources in a data product"},"pendingRequestCount":{"type":"integer","description":"Count of pending requests for a data product"},"approvedRequestCount":{"type":"integer","description":"Count of approved requests for a data product"},"revokedRequestCount":{"type":"integer","description":"Count of revoked requests for a data product"},"canceledRequestCount":{"type":"integer","description":"Count of canceled requests for a data product"},"deniedRequestCount":{"type":"integer","description":"Count of denied requests for a data product"},"totalRequestCount":{"type":"integer","description":"Count of total requests for a data product"}},"required":["dataSourceCount","pendingRequestCount","approvedRequestCount","revokedRequestCount","canceledRequestCount","deniedRequestCount","totalRequestCount"],"description":"Data product statistics","title":"Data Product Stats"},"requestId":{"type":"string","format":"cuid","description":"If requested, the ID of the access request for the data product"},"sourceTypes":{"type":"array","items":{"type":"string"},"description":"The types of data sources contained in the data product."},"metadata":{"oneOf":[{"type":"object","properties":{"subjectMatterExpert":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Immuta global user ID of the subject matter expert for this data product"},"username":{"type":"string"},"name":{"type":"string"}},"required":["id"]}},"required":["subjectMatterExpert"]}],"nullable":true},"dataAccessPolicy":{"default":{"rules":[],"defaultEvent":{"type":"review","params":{"stages":[{"any":[{"type":"PERMISSION","permission":"GOVERNANCE"},{"type":"DOMAIN PERMISSION","permission":"Manage Data Products"}]}]}}},"type":"object","properties":{"version":{"type":"string","description":"Policy schema version"},"rules":{"type":"array","items":{"type":"object","properties":{"conditions":{"oneOf":[{"type":"object","properties":{"all":{"type":"array","items":{}}},"required":["all"],"additionalProperties":false},{"type":"object","properties":{"any":{"type":"array","items":{}}},"required":["any"],"additionalProperties":false},{"type":"object","properties":{"not":{}},"required":["not"],"additionalProperties":false}]},"event":{"discriminator":{"propertyName":"type"},"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["approve"]},"params":{"type":"object","properties":{"comment":{"type":"string"},"duration":{"type":"number","minimum":1},"durationUnit":{"type":"string","enum":["HOURS","DAYS","WEEKS","MONTHS","YEARS"]}},"additionalProperties":false}},"required":["type","params"]},{"type":"object","properties":{"type":{"type":"string","enum":["deny"]},"params":{"type":"object","properties":{"comment":{"type":"string"}}}},"required":["type","params"]},{"type":"object","properties":{"type":{"type":"string","enum":["review"]},"params":{"type":"object","properties":{"stages":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"all":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["USER"],"description":"Entity type"},"id":{"type":"string","description":"Entity ID"},"displayName":{"type":"string","description":"Entity display name"}},"required":["type","id"]},{"type":"object","properties":{"type":{"type":"string","enum":["GROUP"],"description":"Entity type"},"id":{"type":"number","description":"Entity ID"},"iamId":{"type":"string","description":"IAM ID"},"name":{"type":"string","description":"Entity display name"}},"required":["type","name"]},{"type":"object","properties":{"type":{"type":"string","enum":["PERMISSION"]},"permission":{"type":"string","enum":["GOVERNANCE","USER_ADMIN","AUDIT"],"description":"Global permission"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["DOMAIN PERMISSION"]},"permission":{"type":"string","enum":["Manage Policies","Audit Activity","Manage Data Products","Manage Identifiers"],"description":"Domain permission"},"domainId":{"type":"string","description":"Domain ID"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["ATTRIBUTE"]},"key":{"type":"string","description":"Attribute key"},"value":{"type":"string","description":"Attribute value"}},"required":["type","key","value"]}]},"minItems":1}},"required":["all"]},{"type":"object","properties":{"any":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["USER"],"description":"Entity type"},"id":{"type":"string","description":"Entity ID"},"displayName":{"type":"string","description":"Entity display name"}},"required":["type","id"]},{"type":"object","properties":{"type":{"type":"string","enum":["GROUP"],"description":"Entity type"},"id":{"type":"number","description":"Entity ID"},"iamId":{"type":"string","description":"IAM ID"},"name":{"type":"string","description":"Entity display name"}},"required":["type","name"]},{"type":"object","properties":{"type":{"type":"string","enum":["PERMISSION"]},"permission":{"type":"string","enum":["GOVERNANCE","USER_ADMIN","AUDIT"],"description":"Global permission"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["DOMAIN PERMISSION"]},"permission":{"type":"string","enum":["Manage Policies","Audit Activity","Manage Data Products","Manage Identifiers"],"description":"Domain permission"},"domainId":{"type":"string","description":"Domain ID"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["ATTRIBUTE"]},"key":{"type":"string","description":"Attribute key"},"value":{"type":"string","description":"Attribute value"}},"required":["type","key","value"]}]},"minItems":1}},"required":["any"]}]},"description":"Array of stages for manual review"}},"required":["stages"]}},"required":["type","params"]},{"type":"object","properties":{"type":{"type":"string","enum":["dataProductPolicy"]}},"required":["type"]}]}},"required":["conditions","event"]}},"defaultEvent":{"discriminator":{"propertyName":"type"},"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["approve"]},"params":{"type":"object","properties":{"comment":{"type":"string"},"duration":{"type":"number","minimum":1},"durationUnit":{"type":"string","enum":["HOURS","DAYS","WEEKS","MONTHS","YEARS"]}},"additionalProperties":false}},"required":["type","params"]},{"type":"object","properties":{"type":{"type":"string","enum":["review"]},"params":{"type":"object","properties":{"stages":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"all":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["USER"],"description":"Entity type"},"id":{"type":"string","description":"Entity ID"},"displayName":{"type":"string","description":"Entity display name"}},"required":["type","id"]},{"type":"object","properties":{"type":{"type":"string","enum":["GROUP"],"description":"Entity type"},"id":{"type":"number","description":"Entity ID"},"iamId":{"type":"string","description":"IAM ID"},"name":{"type":"string","description":"Entity display name"}},"required":["type","name"]},{"type":"object","properties":{"type":{"type":"string","enum":["PERMISSION"]},"permission":{"type":"string","enum":["GOVERNANCE","USER_ADMIN","AUDIT"],"description":"Global permission"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["DOMAIN PERMISSION"]},"permission":{"type":"string","enum":["Manage Policies","Audit Activity","Manage Data Products","Manage Identifiers"],"description":"Domain permission"},"domainId":{"type":"string","description":"Domain ID"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["ATTRIBUTE"]},"key":{"type":"string","description":"Attribute key"},"value":{"type":"string","description":"Attribute value"}},"required":["type","key","value"]}]},"minItems":1}},"required":["all"]},{"type":"object","properties":{"any":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["USER"],"description":"Entity type"},"id":{"type":"string","description":"Entity ID"},"displayName":{"type":"string","description":"Entity display name"}},"required":["type","id"]},{"type":"object","properties":{"type":{"type":"string","enum":["GROUP"],"description":"Entity type"},"id":{"type":"number","description":"Entity ID"},"iamId":{"type":"string","description":"IAM ID"},"name":{"type":"string","description":"Entity display name"}},"required":["type","name"]},{"type":"object","properties":{"type":{"type":"string","enum":["PERMISSION"]},"permission":{"type":"string","enum":["GOVERNANCE","USER_ADMIN","AUDIT"],"description":"Global permission"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["DOMAIN PERMISSION"]},"permission":{"type":"string","enum":["Manage Policies","Audit Activity","Manage Data Products","Manage Identifiers"],"description":"Domain permission"},"domainId":{"type":"string","description":"Domain ID"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["ATTRIBUTE"]},"key":{"type":"string","description":"Attribute key"},"value":{"type":"string","description":"Attribute value"}},"required":["type","key","value"]}]},"minItems":1}},"required":["any"]}]},"description":"Array of stages for manual review"}},"required":["stages"]}},"required":["type","params"]}]}},"required":["rules","defaultEvent"],"description":"Data product data access policy","title":"Data Product Data Access Policy"},"maskingExceptionPolicy":{"default":{"rules":[],"defaultEvent":{"type":"review","params":{"stages":[{"any":[{"type":"PERMISSION","permission":"GOVERNANCE"},{"type":"DOMAIN PERMISSION","permission":"Manage Data Products"}]}]}}},"type":"object","properties":{"version":{"type":"string","description":"Policy schema version"},"rules":{"type":"array","items":{"type":"object","properties":{"conditions":{"oneOf":[{"type":"object","properties":{"all":{"type":"array","items":{}}},"required":["all"],"additionalProperties":false},{"type":"object","properties":{"any":{"type":"array","items":{}}},"required":["any"],"additionalProperties":false},{"type":"object","properties":{"not":{}},"required":["not"],"additionalProperties":false}]},"event":{"discriminator":{"propertyName":"type"},"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["approve"]},"params":{"type":"object","properties":{"comment":{"type":"string"},"duration":{"type":"number","minimum":1},"durationUnit":{"type":"string","enum":["HOURS","DAYS","WEEKS","MONTHS","YEARS"]}},"additionalProperties":false}},"required":["type","params"]},{"type":"object","properties":{"type":{"type":"string","enum":["deny"]},"params":{"type":"object","properties":{"comment":{"type":"string"}}}},"required":["type","params"]},{"type":"object","properties":{"type":{"type":"string","enum":["review"]},"params":{"type":"object","properties":{"stages":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"all":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["USER"],"description":"Entity type"},"id":{"type":"string","description":"Entity ID"},"displayName":{"type":"string","description":"Entity display name"}},"required":["type","id"]},{"type":"object","properties":{"type":{"type":"string","enum":["GROUP"],"description":"Entity type"},"id":{"type":"number","description":"Entity ID"},"iamId":{"type":"string","description":"IAM ID"},"name":{"type":"string","description":"Entity display name"}},"required":["type","name"]},{"type":"object","properties":{"type":{"type":"string","enum":["PERMISSION"]},"permission":{"type":"string","enum":["GOVERNANCE","USER_ADMIN","AUDIT"],"description":"Global permission"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["DOMAIN PERMISSION"]},"permission":{"type":"string","enum":["Manage Policies","Audit Activity","Manage Data Products","Manage Identifiers"],"description":"Domain permission"},"domainId":{"type":"string","description":"Domain ID"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["ATTRIBUTE"]},"key":{"type":"string","description":"Attribute key"},"value":{"type":"string","description":"Attribute value"}},"required":["type","key","value"]}]},"minItems":1}},"required":["all"]},{"type":"object","properties":{"any":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["USER"],"description":"Entity type"},"id":{"type":"string","description":"Entity ID"},"displayName":{"type":"string","description":"Entity display name"}},"required":["type","id"]},{"type":"object","properties":{"type":{"type":"string","enum":["GROUP"],"description":"Entity type"},"id":{"type":"number","description":"Entity ID"},"iamId":{"type":"string","description":"IAM ID"},"name":{"type":"string","description":"Entity display name"}},"required":["type","name"]},{"type":"object","properties":{"type":{"type":"string","enum":["PERMISSION"]},"permission":{"type":"string","enum":["GOVERNANCE","USER_ADMIN","AUDIT"],"description":"Global permission"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["DOMAIN PERMISSION"]},"permission":{"type":"string","enum":["Manage Policies","Audit Activity","Manage Data Products","Manage Identifiers"],"description":"Domain permission"},"domainId":{"type":"string","description":"Domain ID"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["ATTRIBUTE"]},"key":{"type":"string","description":"Attribute key"},"value":{"type":"string","description":"Attribute value"}},"required":["type","key","value"]}]},"minItems":1}},"required":["any"]}]},"description":"Array of stages for manual review"}},"required":["stages"]}},"required":["type","params"]},{"type":"object","properties":{"type":{"type":"string","enum":["dataProductPolicy"]}},"required":["type"]}]}},"required":["conditions","event"]}},"defaultEvent":{"discriminator":{"propertyName":"type"},"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["approve"]},"params":{"type":"object","properties":{"comment":{"type":"string"},"duration":{"type":"number","minimum":1},"durationUnit":{"type":"string","enum":["HOURS","DAYS","WEEKS","MONTHS","YEARS"]}},"additionalProperties":false}},"required":["type","params"]},{"type":"object","properties":{"type":{"type":"string","enum":["review"]},"params":{"type":"object","properties":{"stages":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"all":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["USER"],"description":"Entity type"},"id":{"type":"string","description":"Entity ID"},"displayName":{"type":"string","description":"Entity display name"}},"required":["type","id"]},{"type":"object","properties":{"type":{"type":"string","enum":["GROUP"],"description":"Entity type"},"id":{"type":"number","description":"Entity ID"},"iamId":{"type":"string","description":"IAM ID"},"name":{"type":"string","description":"Entity display name"}},"required":["type","name"]},{"type":"object","properties":{"type":{"type":"string","enum":["PERMISSION"]},"permission":{"type":"string","enum":["GOVERNANCE","USER_ADMIN","AUDIT"],"description":"Global permission"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["DOMAIN PERMISSION"]},"permission":{"type":"string","enum":["Manage Policies","Audit Activity","Manage Data Products","Manage Identifiers"],"description":"Domain permission"},"domainId":{"type":"string","description":"Domain ID"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["ATTRIBUTE"]},"key":{"type":"string","description":"Attribute key"},"value":{"type":"string","description":"Attribute value"}},"required":["type","key","value"]}]},"minItems":1}},"required":["all"]},{"type":"object","properties":{"any":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["USER"],"description":"Entity type"},"id":{"type":"string","description":"Entity ID"},"displayName":{"type":"string","description":"Entity display name"}},"required":["type","id"]},{"type":"object","properties":{"type":{"type":"string","enum":["GROUP"],"description":"Entity type"},"id":{"type":"number","description":"Entity ID"},"iamId":{"type":"string","description":"IAM ID"},"name":{"type":"string","description":"Entity display name"}},"required":["type","name"]},{"type":"object","properties":{"type":{"type":"string","enum":["PERMISSION"]},"permission":{"type":"string","enum":["GOVERNANCE","USER_ADMIN","AUDIT"],"description":"Global permission"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["DOMAIN PERMISSION"]},"permission":{"type":"string","enum":["Manage Policies","Audit Activity","Manage Data Products","Manage Identifiers"],"description":"Domain permission"},"domainId":{"type":"string","description":"Domain ID"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["ATTRIBUTE"]},"key":{"type":"string","description":"Attribute key"},"value":{"type":"string","description":"Attribute value"}},"required":["type","key","value"]}]},"minItems":1}},"required":["any"]}]},"description":"Array of stages for manual review"}},"required":["stages"]}},"required":["type","params"]}]}},"required":["rules","defaultEvent"],"description":"Data product masking exception policy","title":"Data Product Masking Exception Policy"}},"required":["id","name","domains","suspended","createdBy","createdAt","updatedAt","metadata"]}}},"paths":{"/api/data-product/{name}/byName":{"get":{"description":"Get data product metadata for the specified data product name","operationId":"getDataProductByName","parameters":[{"name":"name","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataProduct"}}}}},"summary":"Get data product by name","tags":["Data Product"]}}}}
```

## Search all data sources in the data product

> Search all data sources for the data product using the provided filters

```json
{"openapi":"3.0.0","info":{"title":"Immuta Data Marketplace","version":"1.0"},"tags":[{"name":"Data Product","description":"APIs for managing data products"},{"name":"Data Source","description":"APIs for managing data sources"}],"servers":[{"url":"https://{global-segment}.api.immutacloud.com/marketplace","description":"Marketplace API Endpoint","variables":{"global-segment":{"default":"na","enum":["na","eu","ap"],"description":"Marketplace API global segment"}}}],"security":[{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"scheme":"bearer","bearerFormat":"JWT","type":"http"}},"schemas":{"PaginatedDataSourceWithStatus":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"cuid"},"name":{"type":"string"},"type":{"type":"string"},"sourceId":{"type":"string"},"hostname":{"oneOf":[{"type":"string","description":"Data source hostname"}],"nullable":true,"description":"Data source hostname"},"database":{"oneOf":[{"type":"string","description":"Data source database name"}],"nullable":true,"description":"Data source database name"},"schema":{"oneOf":[{"type":"string","description":"Data source schema name"}],"nullable":true,"description":"Data source schema name"},"table":{"oneOf":[{"type":"string","description":"Data source table name"}],"nullable":true,"description":"Data source table name"},"prefix":{"oneOf":[{"type":"string","description":"The native S3 prefix"}],"nullable":true,"description":"The native S3 prefix"},"status":{"type":"string","enum":["NONE","RESTRICTED","SUBSCRIBED"],"description":"DAG Subscription Status"}},"required":["id","name","type","sourceId","status"]}},"meta":{"type":"object","properties":{"nextToken":{"oneOf":[{"type":"string","description":"Pagination token to fetch the next page of results, or null if there are no more pages."}],"nullable":true,"description":"Pagination token to fetch the next page of results, or null if there are no more pages."},"limit":{"default":10,"type":"number","minimum":1,"maximum":100,"description":"The number of items to return per page"}},"required":["nextToken"]}},"required":["data","meta"]}}},"paths":{"/api/data-product/{id}/datasources":{"get":{"description":"Search all data sources for the data product using the provided filters","operationId":"searchDataSources","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"nextToken","required":false,"in":"query","description":"Pagination token to fetch the next page of results","schema":{"type":"string"}},{"name":"limit","required":false,"in":"query","description":"The number of items to return per page","schema":{"minimum":1,"maximum":100,"default":10,"type":"number"}},{"name":"user","required":false,"in":"query","description":"The global user ID to search data source access status for","schema":{"format":"uuid","type":"string"}},{"name":"nameFilter","required":false,"in":"query","description":"Data source name to filter by","schema":{"default":"","oneOf":[{"type":"string","description":"Data source name to filter by"},{"type":"string","minLength":0,"maxLength":0}]}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedDataSourceWithStatus"}}}}},"summary":"Search all data sources in the data product","tags":["Data Product","Data Source"]}}}}
```

## Update the data product's data sources

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

```json
{"openapi":"3.0.0","info":{"title":"Immuta Data Marketplace","version":"1.0"},"tags":[{"name":"Data Product","description":"APIs for managing data products"},{"name":"Data Source","description":"APIs for managing data sources"}],"servers":[{"url":"https://{global-segment}.api.immutacloud.com/marketplace","description":"Marketplace API Endpoint","variables":{"global-segment":{"default":"na","enum":["na","eu","ap"],"description":"Marketplace API global segment"}}}],"security":[{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"scheme":"bearer","bearerFormat":"JWT","type":"http"}},"schemas":{"UpdateDataSources":{"type":"object","properties":{"dataSources":{"type":"array","items":{"type":"object","properties":{"sourceId":{"type":"string"}},"required":["sourceId"]}}},"required":["dataSources"]},"DataProduct":{"type":"object","properties":{"id":{"oneOf":[{"type":"string","format":"cuid"},{"type":"string","format":"uuid"}]},"name":{"type":"string","minLength":1,"maxLength":255,"pattern":"^[a-zA-Z0-9)(\\-_/\\\\\\s]*$","description":"Data product name"},"description":{"oneOf":[{"type":"string","description":"Data product description"}],"nullable":true,"description":"Data product description"},"domains":{"type":"array","items":{"type":"string"},"minItems":1},"suspended":{"type":"boolean","description":"Whether access to the data product's data sources is suspended"},"createdBy":{"type":"string","format":"uuid","description":"Immuta global user ID of the user who created the data product"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"status":{"type":"string","enum":["APPROVED","CANCELED","DENIED","PENDING","NONE","PUBLISHER","REVOKED","EXPIRED"]},"expiration":{"oneOf":[{"type":"string","format":"date-time"}],"nullable":true},"stats":{"type":"object","properties":{"dataSourceCount":{"type":"integer","description":"Count of data sources in a data product"},"pendingRequestCount":{"type":"integer","description":"Count of pending requests for a data product"},"approvedRequestCount":{"type":"integer","description":"Count of approved requests for a data product"},"revokedRequestCount":{"type":"integer","description":"Count of revoked requests for a data product"},"canceledRequestCount":{"type":"integer","description":"Count of canceled requests for a data product"},"deniedRequestCount":{"type":"integer","description":"Count of denied requests for a data product"},"totalRequestCount":{"type":"integer","description":"Count of total requests for a data product"}},"required":["dataSourceCount","pendingRequestCount","approvedRequestCount","revokedRequestCount","canceledRequestCount","deniedRequestCount","totalRequestCount"],"description":"Data product statistics","title":"Data Product Stats"},"requestId":{"type":"string","format":"cuid","description":"If requested, the ID of the access request for the data product"},"sourceTypes":{"type":"array","items":{"type":"string"},"description":"The types of data sources contained in the data product."},"metadata":{"oneOf":[{"type":"object","properties":{"subjectMatterExpert":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Immuta global user ID of the subject matter expert for this data product"},"username":{"type":"string"},"name":{"type":"string"}},"required":["id"]}},"required":["subjectMatterExpert"]}],"nullable":true},"dataAccessPolicy":{"default":{"rules":[],"defaultEvent":{"type":"review","params":{"stages":[{"any":[{"type":"PERMISSION","permission":"GOVERNANCE"},{"type":"DOMAIN PERMISSION","permission":"Manage Data Products"}]}]}}},"type":"object","properties":{"version":{"type":"string","description":"Policy schema version"},"rules":{"type":"array","items":{"type":"object","properties":{"conditions":{"oneOf":[{"type":"object","properties":{"all":{"type":"array","items":{}}},"required":["all"],"additionalProperties":false},{"type":"object","properties":{"any":{"type":"array","items":{}}},"required":["any"],"additionalProperties":false},{"type":"object","properties":{"not":{}},"required":["not"],"additionalProperties":false}]},"event":{"discriminator":{"propertyName":"type"},"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["approve"]},"params":{"type":"object","properties":{"comment":{"type":"string"},"duration":{"type":"number","minimum":1},"durationUnit":{"type":"string","enum":["HOURS","DAYS","WEEKS","MONTHS","YEARS"]}},"additionalProperties":false}},"required":["type","params"]},{"type":"object","properties":{"type":{"type":"string","enum":["deny"]},"params":{"type":"object","properties":{"comment":{"type":"string"}}}},"required":["type","params"]},{"type":"object","properties":{"type":{"type":"string","enum":["review"]},"params":{"type":"object","properties":{"stages":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"all":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["USER"],"description":"Entity type"},"id":{"type":"string","description":"Entity ID"},"displayName":{"type":"string","description":"Entity display name"}},"required":["type","id"]},{"type":"object","properties":{"type":{"type":"string","enum":["GROUP"],"description":"Entity type"},"id":{"type":"number","description":"Entity ID"},"iamId":{"type":"string","description":"IAM ID"},"name":{"type":"string","description":"Entity display name"}},"required":["type","name"]},{"type":"object","properties":{"type":{"type":"string","enum":["PERMISSION"]},"permission":{"type":"string","enum":["GOVERNANCE","USER_ADMIN","AUDIT"],"description":"Global permission"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["DOMAIN PERMISSION"]},"permission":{"type":"string","enum":["Manage Policies","Audit Activity","Manage Data Products","Manage Identifiers"],"description":"Domain permission"},"domainId":{"type":"string","description":"Domain ID"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["ATTRIBUTE"]},"key":{"type":"string","description":"Attribute key"},"value":{"type":"string","description":"Attribute value"}},"required":["type","key","value"]}]},"minItems":1}},"required":["all"]},{"type":"object","properties":{"any":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["USER"],"description":"Entity type"},"id":{"type":"string","description":"Entity ID"},"displayName":{"type":"string","description":"Entity display name"}},"required":["type","id"]},{"type":"object","properties":{"type":{"type":"string","enum":["GROUP"],"description":"Entity type"},"id":{"type":"number","description":"Entity ID"},"iamId":{"type":"string","description":"IAM ID"},"name":{"type":"string","description":"Entity display name"}},"required":["type","name"]},{"type":"object","properties":{"type":{"type":"string","enum":["PERMISSION"]},"permission":{"type":"string","enum":["GOVERNANCE","USER_ADMIN","AUDIT"],"description":"Global permission"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["DOMAIN PERMISSION"]},"permission":{"type":"string","enum":["Manage Policies","Audit Activity","Manage Data Products","Manage Identifiers"],"description":"Domain permission"},"domainId":{"type":"string","description":"Domain ID"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["ATTRIBUTE"]},"key":{"type":"string","description":"Attribute key"},"value":{"type":"string","description":"Attribute value"}},"required":["type","key","value"]}]},"minItems":1}},"required":["any"]}]},"description":"Array of stages for manual review"}},"required":["stages"]}},"required":["type","params"]},{"type":"object","properties":{"type":{"type":"string","enum":["dataProductPolicy"]}},"required":["type"]}]}},"required":["conditions","event"]}},"defaultEvent":{"discriminator":{"propertyName":"type"},"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["approve"]},"params":{"type":"object","properties":{"comment":{"type":"string"},"duration":{"type":"number","minimum":1},"durationUnit":{"type":"string","enum":["HOURS","DAYS","WEEKS","MONTHS","YEARS"]}},"additionalProperties":false}},"required":["type","params"]},{"type":"object","properties":{"type":{"type":"string","enum":["review"]},"params":{"type":"object","properties":{"stages":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"all":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["USER"],"description":"Entity type"},"id":{"type":"string","description":"Entity ID"},"displayName":{"type":"string","description":"Entity display name"}},"required":["type","id"]},{"type":"object","properties":{"type":{"type":"string","enum":["GROUP"],"description":"Entity type"},"id":{"type":"number","description":"Entity ID"},"iamId":{"type":"string","description":"IAM ID"},"name":{"type":"string","description":"Entity display name"}},"required":["type","name"]},{"type":"object","properties":{"type":{"type":"string","enum":["PERMISSION"]},"permission":{"type":"string","enum":["GOVERNANCE","USER_ADMIN","AUDIT"],"description":"Global permission"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["DOMAIN PERMISSION"]},"permission":{"type":"string","enum":["Manage Policies","Audit Activity","Manage Data Products","Manage Identifiers"],"description":"Domain permission"},"domainId":{"type":"string","description":"Domain ID"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["ATTRIBUTE"]},"key":{"type":"string","description":"Attribute key"},"value":{"type":"string","description":"Attribute value"}},"required":["type","key","value"]}]},"minItems":1}},"required":["all"]},{"type":"object","properties":{"any":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["USER"],"description":"Entity type"},"id":{"type":"string","description":"Entity ID"},"displayName":{"type":"string","description":"Entity display name"}},"required":["type","id"]},{"type":"object","properties":{"type":{"type":"string","enum":["GROUP"],"description":"Entity type"},"id":{"type":"number","description":"Entity ID"},"iamId":{"type":"string","description":"IAM ID"},"name":{"type":"string","description":"Entity display name"}},"required":["type","name"]},{"type":"object","properties":{"type":{"type":"string","enum":["PERMISSION"]},"permission":{"type":"string","enum":["GOVERNANCE","USER_ADMIN","AUDIT"],"description":"Global permission"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["DOMAIN PERMISSION"]},"permission":{"type":"string","enum":["Manage Policies","Audit Activity","Manage Data Products","Manage Identifiers"],"description":"Domain permission"},"domainId":{"type":"string","description":"Domain ID"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["ATTRIBUTE"]},"key":{"type":"string","description":"Attribute key"},"value":{"type":"string","description":"Attribute value"}},"required":["type","key","value"]}]},"minItems":1}},"required":["any"]}]},"description":"Array of stages for manual review"}},"required":["stages"]}},"required":["type","params"]}]}},"required":["rules","defaultEvent"],"description":"Data product data access policy","title":"Data Product Data Access Policy"},"maskingExceptionPolicy":{"default":{"rules":[],"defaultEvent":{"type":"review","params":{"stages":[{"any":[{"type":"PERMISSION","permission":"GOVERNANCE"},{"type":"DOMAIN PERMISSION","permission":"Manage Data Products"}]}]}}},"type":"object","properties":{"version":{"type":"string","description":"Policy schema version"},"rules":{"type":"array","items":{"type":"object","properties":{"conditions":{"oneOf":[{"type":"object","properties":{"all":{"type":"array","items":{}}},"required":["all"],"additionalProperties":false},{"type":"object","properties":{"any":{"type":"array","items":{}}},"required":["any"],"additionalProperties":false},{"type":"object","properties":{"not":{}},"required":["not"],"additionalProperties":false}]},"event":{"discriminator":{"propertyName":"type"},"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["approve"]},"params":{"type":"object","properties":{"comment":{"type":"string"},"duration":{"type":"number","minimum":1},"durationUnit":{"type":"string","enum":["HOURS","DAYS","WEEKS","MONTHS","YEARS"]}},"additionalProperties":false}},"required":["type","params"]},{"type":"object","properties":{"type":{"type":"string","enum":["deny"]},"params":{"type":"object","properties":{"comment":{"type":"string"}}}},"required":["type","params"]},{"type":"object","properties":{"type":{"type":"string","enum":["review"]},"params":{"type":"object","properties":{"stages":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"all":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["USER"],"description":"Entity type"},"id":{"type":"string","description":"Entity ID"},"displayName":{"type":"string","description":"Entity display name"}},"required":["type","id"]},{"type":"object","properties":{"type":{"type":"string","enum":["GROUP"],"description":"Entity type"},"id":{"type":"number","description":"Entity ID"},"iamId":{"type":"string","description":"IAM ID"},"name":{"type":"string","description":"Entity display name"}},"required":["type","name"]},{"type":"object","properties":{"type":{"type":"string","enum":["PERMISSION"]},"permission":{"type":"string","enum":["GOVERNANCE","USER_ADMIN","AUDIT"],"description":"Global permission"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["DOMAIN PERMISSION"]},"permission":{"type":"string","enum":["Manage Policies","Audit Activity","Manage Data Products","Manage Identifiers"],"description":"Domain permission"},"domainId":{"type":"string","description":"Domain ID"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["ATTRIBUTE"]},"key":{"type":"string","description":"Attribute key"},"value":{"type":"string","description":"Attribute value"}},"required":["type","key","value"]}]},"minItems":1}},"required":["all"]},{"type":"object","properties":{"any":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["USER"],"description":"Entity type"},"id":{"type":"string","description":"Entity ID"},"displayName":{"type":"string","description":"Entity display name"}},"required":["type","id"]},{"type":"object","properties":{"type":{"type":"string","enum":["GROUP"],"description":"Entity type"},"id":{"type":"number","description":"Entity ID"},"iamId":{"type":"string","description":"IAM ID"},"name":{"type":"string","description":"Entity display name"}},"required":["type","name"]},{"type":"object","properties":{"type":{"type":"string","enum":["PERMISSION"]},"permission":{"type":"string","enum":["GOVERNANCE","USER_ADMIN","AUDIT"],"description":"Global permission"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["DOMAIN PERMISSION"]},"permission":{"type":"string","enum":["Manage Policies","Audit Activity","Manage Data Products","Manage Identifiers"],"description":"Domain permission"},"domainId":{"type":"string","description":"Domain ID"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["ATTRIBUTE"]},"key":{"type":"string","description":"Attribute key"},"value":{"type":"string","description":"Attribute value"}},"required":["type","key","value"]}]},"minItems":1}},"required":["any"]}]},"description":"Array of stages for manual review"}},"required":["stages"]}},"required":["type","params"]},{"type":"object","properties":{"type":{"type":"string","enum":["dataProductPolicy"]}},"required":["type"]}]}},"required":["conditions","event"]}},"defaultEvent":{"discriminator":{"propertyName":"type"},"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["approve"]},"params":{"type":"object","properties":{"comment":{"type":"string"},"duration":{"type":"number","minimum":1},"durationUnit":{"type":"string","enum":["HOURS","DAYS","WEEKS","MONTHS","YEARS"]}},"additionalProperties":false}},"required":["type","params"]},{"type":"object","properties":{"type":{"type":"string","enum":["review"]},"params":{"type":"object","properties":{"stages":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"all":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["USER"],"description":"Entity type"},"id":{"type":"string","description":"Entity ID"},"displayName":{"type":"string","description":"Entity display name"}},"required":["type","id"]},{"type":"object","properties":{"type":{"type":"string","enum":["GROUP"],"description":"Entity type"},"id":{"type":"number","description":"Entity ID"},"iamId":{"type":"string","description":"IAM ID"},"name":{"type":"string","description":"Entity display name"}},"required":["type","name"]},{"type":"object","properties":{"type":{"type":"string","enum":["PERMISSION"]},"permission":{"type":"string","enum":["GOVERNANCE","USER_ADMIN","AUDIT"],"description":"Global permission"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["DOMAIN PERMISSION"]},"permission":{"type":"string","enum":["Manage Policies","Audit Activity","Manage Data Products","Manage Identifiers"],"description":"Domain permission"},"domainId":{"type":"string","description":"Domain ID"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["ATTRIBUTE"]},"key":{"type":"string","description":"Attribute key"},"value":{"type":"string","description":"Attribute value"}},"required":["type","key","value"]}]},"minItems":1}},"required":["all"]},{"type":"object","properties":{"any":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["USER"],"description":"Entity type"},"id":{"type":"string","description":"Entity ID"},"displayName":{"type":"string","description":"Entity display name"}},"required":["type","id"]},{"type":"object","properties":{"type":{"type":"string","enum":["GROUP"],"description":"Entity type"},"id":{"type":"number","description":"Entity ID"},"iamId":{"type":"string","description":"IAM ID"},"name":{"type":"string","description":"Entity display name"}},"required":["type","name"]},{"type":"object","properties":{"type":{"type":"string","enum":["PERMISSION"]},"permission":{"type":"string","enum":["GOVERNANCE","USER_ADMIN","AUDIT"],"description":"Global permission"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["DOMAIN PERMISSION"]},"permission":{"type":"string","enum":["Manage Policies","Audit Activity","Manage Data Products","Manage Identifiers"],"description":"Domain permission"},"domainId":{"type":"string","description":"Domain ID"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["ATTRIBUTE"]},"key":{"type":"string","description":"Attribute key"},"value":{"type":"string","description":"Attribute value"}},"required":["type","key","value"]}]},"minItems":1}},"required":["any"]}]},"description":"Array of stages for manual review"}},"required":["stages"]}},"required":["type","params"]}]}},"required":["rules","defaultEvent"],"description":"Data product masking exception policy","title":"Data Product Masking Exception Policy"}},"required":["id","name","domains","suspended","createdBy","createdAt","updatedAt","metadata"]}}},"paths":{"/api/data-product/{id}/datasources":{"put":{"description":"Update the data sources associated with the data product. Any currently associated data sources not included in the payload will be removed.","operationId":"updateDataSources","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateDataSources"}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataProduct"}}}}},"summary":"Update the data product's data sources","tags":["Data Product","Data Source"]}}}}
```

## Search all access requests for the data product

> Search all access requests for the data product using the provided filters

```json
{"openapi":"3.0.0","info":{"title":"Immuta Data Marketplace","version":"1.0"},"tags":[{"name":"Data Product","description":"APIs for managing data products"},{"name":"Access Request","description":"APIs for managing data access"}],"servers":[{"url":"https://{global-segment}.api.immutacloud.com/marketplace","description":"Marketplace API Endpoint","variables":{"global-segment":{"default":"na","enum":["na","eu","ap"],"description":"Marketplace API global segment"}}}],"security":[{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"scheme":"bearer","bearerFormat":"JWT","type":"http"}},"schemas":{"PaginatedAccessRequest":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"cuid"},"requestingUser":{"type":"object","properties":{"id":{"type":"number"},"iamId":{"type":"string","description":"ID of the IAM the user is associated with"},"globalUserId":{"type":"string","format":"uuid","description":"Immuta global user ID"},"username":{"type":"string","description":"Username/login name for the user"},"name":{"type":"string","description":"Display name"},"email":{"type":"string","description":"Email address","nullable":true},"authorizations":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}}},"required":["id","iamId","globalUserId","username","name"],"title":"Immuta User"},"user":{"type":"object","properties":{"id":{"type":"number"},"iamId":{"type":"string","description":"ID of the IAM the user is associated with"},"globalUserId":{"type":"string","format":"uuid","description":"Immuta global user ID"},"username":{"type":"string","description":"Username/login name for the user"},"name":{"type":"string","description":"Display name"},"email":{"type":"string","description":"Email address","nullable":true},"authorizations":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}}},"required":["id","iamId","globalUserId","username","name"],"title":"Immuta User"},"formVersion":{"type":"string"},"form":{"description":"The request form submission"},"type":{"type":"string","enum":["DATA_ACCESS","MASKING_EXCEPTION"]},"metadata":{"description":"Metadata associated with the access request"},"status":{"type":"string","enum":["APPROVED","CANCELED","DENIED","PENDING","NONE","PUBLISHER","REVOKED","EXPIRED"]},"expiration":{"type":"string","format":"date-time","description":"When the temporary access will expire"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"dataProduct":{"type":"object","properties":{"id":{"oneOf":[{"type":"string","format":"cuid"},{"type":"string","format":"uuid"}]},"name":{"type":"string","minLength":1,"maxLength":255,"pattern":"^[a-zA-Z0-9)(\\-_/\\\\\\s]*$","description":"Data product name"},"description":{"oneOf":[{"type":"string","description":"Data product description"}],"nullable":true,"description":"Data product description"}},"required":["id","name"]},"asset":{"discriminator":{"propertyName":"type"},"oneOf":[{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Asset ID"},"name":{"type":"string","minLength":1,"description":"Asset name"},"type":{"type":"string","enum":["DATA_PRODUCT"]},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}]},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}]},"dagTagId":{"oneOf":[{"type":"number"}],"nullable":true},"requestId":{"type":"string","format":"cuid","description":"If requested, the ID of the access request for the asset"},"status":{"type":"string","enum":["APPROVED","CANCELED","DENIED","PENDING","NONE","PUBLISHER","REVOKED","EXPIRED"]},"metadata":{"type":"object","properties":{"subjectMatterExperts":{"default":[],"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Immuta global user ID of the subject matter expert"},"username":{"type":"string"},"name":{"type":"string"}},"required":["id"]}},"domains":{"type":"array","items":{"type":"string","format":"uuid"},"minItems":1,"description":"Array of domain IDs associated with the data product"},"description":{"oneOf":[{"type":"string","description":"Data product description"}],"nullable":true,"description":"Data product description"}},"required":["domains"],"description":"Data product asset metadata"},"createdBy":{"type":"string","format":"uuid","description":"Immuta global user ID of the user who created the data product"}},"required":["id","name","type","metadata","createdBy"],"title":"Data Product Asset"},{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Asset ID"},"name":{"type":"string","minLength":1,"description":"Asset name"},"type":{"type":"string","enum":["DATA_OBJECT"]},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}]},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}]},"dagTagId":{"oneOf":[{"type":"number"}],"nullable":true},"requestId":{"type":"string","format":"cuid","description":"If requested, the ID of the access request for the asset"},"status":{"type":"string","enum":["APPROVED","CANCELED","DENIED","PENDING","NONE","PUBLISHER","REVOKED","EXPIRED"]},"metadata":{"type":"object","properties":{"subjectMatterExperts":{"default":[],"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Immuta global user ID of the subject matter expert"},"username":{"type":"string"},"name":{"type":"string"}},"required":["id"]}},"objectPath":{"type":"array","items":{"type":"string"}},"technology":{"type":"string","enum":["Snowflake","PostgreSQL","Databricks","Glue","MySQL","Teradata","MariaDB","Oracle","SQLServer","Trino","Redshift"]},"legacyType":{"type":"string"},"dataSourceId":{"type":"number"},"description":{"oneOf":[{"type":"string"}],"nullable":true},"externalLink":{"oneOf":[{"type":"string"}],"nullable":true}},"required":["objectPath"],"description":"Data object asset metadata"},"registered":{"default":true,"type":"boolean","description":"Whether the asset has been registered"}},"required":["id","name","type","metadata"],"title":"Data Object Asset"}],"title":"Asset"}},"required":["id","requestingUser","user","formVersion","type","status","createdAt","updatedAt"],"title":"Hydrated Access Request","description":"Access request with user and data product metadata"}},"meta":{"type":"object","properties":{"offset":{"default":0,"type":"number","minimum":0},"limit":{"default":10,"type":"number","minimum":1},"totalCount":{"type":"number"},"pageCount":{"type":"number"},"currentPage":{"type":"number"},"totalPages":{"type":"number"}},"required":["totalCount","pageCount","currentPage","totalPages"]}},"required":["data","meta"]}}},"paths":{"/api/data-product/{id}/request":{"get":{"description":"Search all access requests for the data product using the provided filters","operationId":"searchDataProductAccessRequests","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"searchText","required":false,"in":"query","schema":{"type":"string"}},{"name":"status","required":false,"in":"query","schema":{"type":"array","items":{"type":"string","enum":["APPROVED","CANCELED","DENIED","PENDING","NONE","PUBLISHER","REVOKED","EXPIRED"]}}},{"name":"type","required":false,"in":"query","schema":{"type":"array","items":{"type":"string","enum":["DATA_ACCESS","MASKING_EXCEPTION"]}}},{"name":"userIds","required":false,"in":"query","schema":{"type":"array","items":{"type":"string"}}},{"name":"historical","required":false,"in":"query","description":"Whether to include historical access requests","schema":{"default":true,"type":"boolean"}},{"name":"includeTemporary","required":false,"in":"query","description":"Whether to include temporary access requests","deprecated":true,"schema":{"default":false,"type":"boolean"}},{"name":"expiration","required":false,"in":"query","description":"Filter access requests by whether it has an expiration","schema":{"type":"boolean"}},{"name":"dataProductId","required":false,"in":"query","description":"The ID of the data product to filter requests by","schema":{"oneOf":[{"type":"string","format":"cuid","description":"The ID of the data product to filter requests by"},{"type":"string","format":"uuid"}]}},{"name":"assetId","required":false,"in":"query","description":"The ID of the asset to filter requests by","schema":{"format":"uuid","type":"string"}},{"name":"assetType","required":false,"in":"query","description":"Filter access requests by asset type","schema":{"type":"array","items":{"type":"string","enum":["DATA_PRODUCT","DATA_OBJECT"]}}},{"name":"reviewStatus","required":false,"in":"query","description":"Filter access requests by review status","schema":{"type":"array","items":{"type":"string","enum":["noReviews","reviewedByYou","awaitingReviewFromYou"]}}},{"name":"offset","required":false,"in":"query","schema":{"minimum":0,"default":0,"type":"number"}},{"name":"limit","required":false,"in":"query","schema":{"minimum":1,"default":10,"type":"number"}},{"name":"sortOrder","required":false,"in":"query","schema":{"default":"desc","type":"string","enum":["asc","desc"]}},{"name":"sortBy","required":false,"in":"query","schema":{"default":"createdAt","type":"string","enum":["status","dataProduct","createdAt","updatedAt","expiration"]}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedAccessRequest"}}}}},"summary":"Search all access requests for the data product","tags":["Data Product","Access Request"]}}}}
```

## Request access to a data product

> Create a new data access request for the specified data product

```json
{"openapi":"3.0.0","info":{"title":"Immuta Data Marketplace","version":"1.0"},"tags":[{"name":"Data Product","description":"APIs for managing data products"},{"name":"Access Request","description":"APIs for managing data access"}],"servers":[{"url":"https://{global-segment}.api.immutacloud.com/marketplace","description":"Marketplace API Endpoint","variables":{"global-segment":{"default":"na","enum":["na","eu","ap"],"description":"Marketplace API global segment"}}}],"security":[{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"scheme":"bearer","bearerFormat":"JWT","type":"http"}},"schemas":{"CreateAccessRequest":{"type":"object","properties":{"user":{"type":"string","format":"uuid","description":"Immuta global user ID of the user for whom access is being requested"},"form":{"description":"The request form submission"}},"required":["user"]},"HydratedAccessRequest":{"type":"object","properties":{"id":{"type":"string","format":"cuid"},"requestingUser":{"type":"object","properties":{"id":{"type":"number"},"iamId":{"type":"string","description":"ID of the IAM the user is associated with"},"globalUserId":{"type":"string","format":"uuid","description":"Immuta global user ID"},"username":{"type":"string","description":"Username/login name for the user"},"name":{"type":"string","description":"Display name"},"email":{"type":"string","description":"Email address","nullable":true},"authorizations":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}}},"required":["id","iamId","globalUserId","username","name"],"title":"Immuta User"},"user":{"type":"object","properties":{"id":{"type":"number"},"iamId":{"type":"string","description":"ID of the IAM the user is associated with"},"globalUserId":{"type":"string","format":"uuid","description":"Immuta global user ID"},"username":{"type":"string","description":"Username/login name for the user"},"name":{"type":"string","description":"Display name"},"email":{"type":"string","description":"Email address","nullable":true},"authorizations":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}}},"required":["id","iamId","globalUserId","username","name"],"title":"Immuta User"},"formVersion":{"type":"string"},"form":{"description":"The request form submission"},"type":{"type":"string","enum":["DATA_ACCESS","MASKING_EXCEPTION"]},"metadata":{"description":"Metadata associated with the access request"},"status":{"type":"string","enum":["APPROVED","CANCELED","DENIED","PENDING","NONE","PUBLISHER","REVOKED","EXPIRED"]},"expiration":{"type":"string","format":"date-time","description":"When the temporary access will expire"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"dataProduct":{"type":"object","properties":{"id":{"oneOf":[{"type":"string","format":"cuid"},{"type":"string","format":"uuid"}]},"name":{"type":"string","minLength":1,"maxLength":255,"pattern":"^[a-zA-Z0-9)(\\-_/\\\\\\s]*$","description":"Data product name"},"description":{"oneOf":[{"type":"string","description":"Data product description"}],"nullable":true,"description":"Data product description"}},"required":["id","name"]},"asset":{"discriminator":{"propertyName":"type"},"oneOf":[{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Asset ID"},"name":{"type":"string","minLength":1,"description":"Asset name"},"type":{"type":"string","enum":["DATA_PRODUCT"]},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}]},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}]},"dagTagId":{"oneOf":[{"type":"number"}],"nullable":true},"requestId":{"type":"string","format":"cuid","description":"If requested, the ID of the access request for the asset"},"status":{"type":"string","enum":["APPROVED","CANCELED","DENIED","PENDING","NONE","PUBLISHER","REVOKED","EXPIRED"]},"metadata":{"type":"object","properties":{"subjectMatterExperts":{"default":[],"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Immuta global user ID of the subject matter expert"},"username":{"type":"string"},"name":{"type":"string"}},"required":["id"]}},"domains":{"type":"array","items":{"type":"string","format":"uuid"},"minItems":1,"description":"Array of domain IDs associated with the data product"},"description":{"oneOf":[{"type":"string","description":"Data product description"}],"nullable":true,"description":"Data product description"}},"required":["domains"],"description":"Data product asset metadata"},"createdBy":{"type":"string","format":"uuid","description":"Immuta global user ID of the user who created the data product"}},"required":["id","name","type","metadata","createdBy"],"title":"Data Product Asset"},{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Asset ID"},"name":{"type":"string","minLength":1,"description":"Asset name"},"type":{"type":"string","enum":["DATA_OBJECT"]},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}]},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}]},"dagTagId":{"oneOf":[{"type":"number"}],"nullable":true},"requestId":{"type":"string","format":"cuid","description":"If requested, the ID of the access request for the asset"},"status":{"type":"string","enum":["APPROVED","CANCELED","DENIED","PENDING","NONE","PUBLISHER","REVOKED","EXPIRED"]},"metadata":{"type":"object","properties":{"subjectMatterExperts":{"default":[],"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Immuta global user ID of the subject matter expert"},"username":{"type":"string"},"name":{"type":"string"}},"required":["id"]}},"objectPath":{"type":"array","items":{"type":"string"}},"technology":{"type":"string","enum":["Snowflake","PostgreSQL","Databricks","Glue","MySQL","Teradata","MariaDB","Oracle","SQLServer","Trino","Redshift"]},"legacyType":{"type":"string"},"dataSourceId":{"type":"number"},"description":{"oneOf":[{"type":"string"}],"nullable":true},"externalLink":{"oneOf":[{"type":"string"}],"nullable":true}},"required":["objectPath"],"description":"Data object asset metadata"},"registered":{"default":true,"type":"boolean","description":"Whether the asset has been registered"}},"required":["id","name","type","metadata"],"title":"Data Object Asset"}],"title":"Asset"}},"required":["id","requestingUser","user","formVersion","type","status","createdAt","updatedAt"],"title":"Hydrated Access Request","description":"Access request with user and data product metadata"}}},"paths":{"/api/data-product/{id}/request":{"post":{"description":"Create a new data access request for the specified data product","operationId":"requestAccess","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateAccessRequest"}}}},"responses":{"201":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HydratedAccessRequest"}}}}},"summary":"Request access to a data product","tags":["Data Product","Access Request"]}}}}
```

## Search all access requests for the data product

> Search all approved access requests for the data product

```json
{"openapi":"3.0.0","info":{"title":"Immuta Data Marketplace","version":"1.0"},"tags":[{"name":"Data Product","description":"APIs for managing data products"},{"name":"Access Request","description":"APIs for managing data access"}],"servers":[{"url":"https://{global-segment}.api.immutacloud.com/marketplace","description":"Marketplace API Endpoint","variables":{"global-segment":{"default":"na","enum":["na","eu","ap"],"description":"Marketplace API global segment"}}}],"security":[{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"scheme":"bearer","bearerFormat":"JWT","type":"http"}},"schemas":{"PaginatedAccessRequest":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"cuid"},"requestingUser":{"type":"object","properties":{"id":{"type":"number"},"iamId":{"type":"string","description":"ID of the IAM the user is associated with"},"globalUserId":{"type":"string","format":"uuid","description":"Immuta global user ID"},"username":{"type":"string","description":"Username/login name for the user"},"name":{"type":"string","description":"Display name"},"email":{"type":"string","description":"Email address","nullable":true},"authorizations":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}}},"required":["id","iamId","globalUserId","username","name"],"title":"Immuta User"},"user":{"type":"object","properties":{"id":{"type":"number"},"iamId":{"type":"string","description":"ID of the IAM the user is associated with"},"globalUserId":{"type":"string","format":"uuid","description":"Immuta global user ID"},"username":{"type":"string","description":"Username/login name for the user"},"name":{"type":"string","description":"Display name"},"email":{"type":"string","description":"Email address","nullable":true},"authorizations":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}}},"required":["id","iamId","globalUserId","username","name"],"title":"Immuta User"},"formVersion":{"type":"string"},"form":{"description":"The request form submission"},"type":{"type":"string","enum":["DATA_ACCESS","MASKING_EXCEPTION"]},"metadata":{"description":"Metadata associated with the access request"},"status":{"type":"string","enum":["APPROVED","CANCELED","DENIED","PENDING","NONE","PUBLISHER","REVOKED","EXPIRED"]},"expiration":{"type":"string","format":"date-time","description":"When the temporary access will expire"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"dataProduct":{"type":"object","properties":{"id":{"oneOf":[{"type":"string","format":"cuid"},{"type":"string","format":"uuid"}]},"name":{"type":"string","minLength":1,"maxLength":255,"pattern":"^[a-zA-Z0-9)(\\-_/\\\\\\s]*$","description":"Data product name"},"description":{"oneOf":[{"type":"string","description":"Data product description"}],"nullable":true,"description":"Data product description"}},"required":["id","name"]},"asset":{"discriminator":{"propertyName":"type"},"oneOf":[{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Asset ID"},"name":{"type":"string","minLength":1,"description":"Asset name"},"type":{"type":"string","enum":["DATA_PRODUCT"]},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}]},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}]},"dagTagId":{"oneOf":[{"type":"number"}],"nullable":true},"requestId":{"type":"string","format":"cuid","description":"If requested, the ID of the access request for the asset"},"status":{"type":"string","enum":["APPROVED","CANCELED","DENIED","PENDING","NONE","PUBLISHER","REVOKED","EXPIRED"]},"metadata":{"type":"object","properties":{"subjectMatterExperts":{"default":[],"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Immuta global user ID of the subject matter expert"},"username":{"type":"string"},"name":{"type":"string"}},"required":["id"]}},"domains":{"type":"array","items":{"type":"string","format":"uuid"},"minItems":1,"description":"Array of domain IDs associated with the data product"},"description":{"oneOf":[{"type":"string","description":"Data product description"}],"nullable":true,"description":"Data product description"}},"required":["domains"],"description":"Data product asset metadata"},"createdBy":{"type":"string","format":"uuid","description":"Immuta global user ID of the user who created the data product"}},"required":["id","name","type","metadata","createdBy"],"title":"Data Product Asset"},{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Asset ID"},"name":{"type":"string","minLength":1,"description":"Asset name"},"type":{"type":"string","enum":["DATA_OBJECT"]},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}]},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}]},"dagTagId":{"oneOf":[{"type":"number"}],"nullable":true},"requestId":{"type":"string","format":"cuid","description":"If requested, the ID of the access request for the asset"},"status":{"type":"string","enum":["APPROVED","CANCELED","DENIED","PENDING","NONE","PUBLISHER","REVOKED","EXPIRED"]},"metadata":{"type":"object","properties":{"subjectMatterExperts":{"default":[],"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Immuta global user ID of the subject matter expert"},"username":{"type":"string"},"name":{"type":"string"}},"required":["id"]}},"objectPath":{"type":"array","items":{"type":"string"}},"technology":{"type":"string","enum":["Snowflake","PostgreSQL","Databricks","Glue","MySQL","Teradata","MariaDB","Oracle","SQLServer","Trino","Redshift"]},"legacyType":{"type":"string"},"dataSourceId":{"type":"number"},"description":{"oneOf":[{"type":"string"}],"nullable":true},"externalLink":{"oneOf":[{"type":"string"}],"nullable":true}},"required":["objectPath"],"description":"Data object asset metadata"},"registered":{"default":true,"type":"boolean","description":"Whether the asset has been registered"}},"required":["id","name","type","metadata"],"title":"Data Object Asset"}],"title":"Asset"}},"required":["id","requestingUser","user","formVersion","type","status","createdAt","updatedAt"],"title":"Hydrated Access Request","description":"Access request with user and data product metadata"}},"meta":{"type":"object","properties":{"offset":{"default":0,"type":"number","minimum":0},"limit":{"default":10,"type":"number","minimum":1},"totalCount":{"type":"number"},"pageCount":{"type":"number"},"currentPage":{"type":"number"},"totalPages":{"type":"number"}},"required":["totalCount","pageCount","currentPage","totalPages"]}},"required":["data","meta"]}}},"paths":{"/api/data-product/{id}/members":{"get":{"description":"Search all approved access requests for the data product","operationId":"searchDataProductMembers","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"searchText","required":false,"in":"query","schema":{"type":"string"}},{"name":"status","required":false,"in":"query","schema":{"type":"array","items":{"type":"string","enum":["APPROVED","CANCELED","DENIED","PENDING","NONE","PUBLISHER","REVOKED","EXPIRED"]}}},{"name":"type","required":false,"in":"query","schema":{"type":"array","items":{"type":"string","enum":["DATA_ACCESS","MASKING_EXCEPTION"]}}},{"name":"userIds","required":false,"in":"query","schema":{"type":"array","items":{"type":"string"}}},{"name":"expiration","required":false,"in":"query","description":"Filter access requests by whether it has an expiration","schema":{"type":"boolean"}},{"name":"dataProductId","required":false,"in":"query","description":"The ID of the data product to filter requests by","schema":{"oneOf":[{"type":"string","format":"cuid","description":"The ID of the data product to filter requests by"},{"type":"string","format":"uuid"}]}},{"name":"assetId","required":false,"in":"query","description":"The ID of the asset to filter requests by","schema":{"format":"uuid","type":"string"}},{"name":"assetType","required":false,"in":"query","description":"Filter access requests by asset type","schema":{"type":"array","items":{"type":"string","enum":["DATA_PRODUCT","DATA_OBJECT"]}}},{"name":"reviewStatus","required":false,"in":"query","description":"Filter access requests by review status","schema":{"type":"array","items":{"type":"string","enum":["noReviews","reviewedByYou","awaitingReviewFromYou"]}}},{"name":"offset","required":false,"in":"query","schema":{"minimum":0,"default":0,"type":"number"}},{"name":"limit","required":false,"in":"query","schema":{"minimum":1,"default":10,"type":"number"}},{"name":"sortOrder","required":false,"in":"query","schema":{"default":"desc","type":"string","enum":["asc","desc"]}},{"name":"sortBy","required":false,"in":"query","schema":{"default":"createdAt","type":"string","enum":["status","dataProduct","createdAt","updatedAt","expiration"]}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedAccessRequest"}}}}},"summary":"Search all access requests for the data product","tags":["Data Product","Access Request"]}}}}
```

## Request masking exception to columns in a data product

> Create a new masking exception request for specific columns in the specified data product

```json
{"openapi":"3.0.0","info":{"title":"Immuta Data Marketplace","version":"1.0"},"tags":[{"name":"Data Product","description":"APIs for managing data products"},{"name":"Access Request","description":"APIs for managing data access"}],"servers":[{"url":"https://{global-segment}.api.immutacloud.com/marketplace","description":"Marketplace API Endpoint","variables":{"global-segment":{"default":"na","enum":["na","eu","ap"],"description":"Marketplace API global segment"}}}],"security":[{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"scheme":"bearer","bearerFormat":"JWT","type":"http"}},"schemas":{"CreateMaskingExceptionRequest":{"type":"object","properties":{"user":{"type":"string","format":"uuid","description":"Immuta global user ID of the user for whom access is being requested"},"form":{"description":"The request form submission"},"columns":{"type":"array","items":{"type":"object","properties":{"columnName":{"type":"string","description":"The name of the column to request masking exception for"},"sourceId":{"type":"string","description":"The ID of the data source this column belongs to"}},"required":["columnName","sourceId"],"description":"Column in the data source to request masking exception for"},"description":"List of columns to request masking exception for"}},"required":["user","columns"]},"HydratedAccessRequest":{"type":"object","properties":{"id":{"type":"string","format":"cuid"},"requestingUser":{"type":"object","properties":{"id":{"type":"number"},"iamId":{"type":"string","description":"ID of the IAM the user is associated with"},"globalUserId":{"type":"string","format":"uuid","description":"Immuta global user ID"},"username":{"type":"string","description":"Username/login name for the user"},"name":{"type":"string","description":"Display name"},"email":{"type":"string","description":"Email address","nullable":true},"authorizations":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}}},"required":["id","iamId","globalUserId","username","name"],"title":"Immuta User"},"user":{"type":"object","properties":{"id":{"type":"number"},"iamId":{"type":"string","description":"ID of the IAM the user is associated with"},"globalUserId":{"type":"string","format":"uuid","description":"Immuta global user ID"},"username":{"type":"string","description":"Username/login name for the user"},"name":{"type":"string","description":"Display name"},"email":{"type":"string","description":"Email address","nullable":true},"authorizations":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}}},"required":["id","iamId","globalUserId","username","name"],"title":"Immuta User"},"formVersion":{"type":"string"},"form":{"description":"The request form submission"},"type":{"type":"string","enum":["DATA_ACCESS","MASKING_EXCEPTION"]},"metadata":{"description":"Metadata associated with the access request"},"status":{"type":"string","enum":["APPROVED","CANCELED","DENIED","PENDING","NONE","PUBLISHER","REVOKED","EXPIRED"]},"expiration":{"type":"string","format":"date-time","description":"When the temporary access will expire"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"dataProduct":{"type":"object","properties":{"id":{"oneOf":[{"type":"string","format":"cuid"},{"type":"string","format":"uuid"}]},"name":{"type":"string","minLength":1,"maxLength":255,"pattern":"^[a-zA-Z0-9)(\\-_/\\\\\\s]*$","description":"Data product name"},"description":{"oneOf":[{"type":"string","description":"Data product description"}],"nullable":true,"description":"Data product description"}},"required":["id","name"]},"asset":{"discriminator":{"propertyName":"type"},"oneOf":[{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Asset ID"},"name":{"type":"string","minLength":1,"description":"Asset name"},"type":{"type":"string","enum":["DATA_PRODUCT"]},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}]},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}]},"dagTagId":{"oneOf":[{"type":"number"}],"nullable":true},"requestId":{"type":"string","format":"cuid","description":"If requested, the ID of the access request for the asset"},"status":{"type":"string","enum":["APPROVED","CANCELED","DENIED","PENDING","NONE","PUBLISHER","REVOKED","EXPIRED"]},"metadata":{"type":"object","properties":{"subjectMatterExperts":{"default":[],"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Immuta global user ID of the subject matter expert"},"username":{"type":"string"},"name":{"type":"string"}},"required":["id"]}},"domains":{"type":"array","items":{"type":"string","format":"uuid"},"minItems":1,"description":"Array of domain IDs associated with the data product"},"description":{"oneOf":[{"type":"string","description":"Data product description"}],"nullable":true,"description":"Data product description"}},"required":["domains"],"description":"Data product asset metadata"},"createdBy":{"type":"string","format":"uuid","description":"Immuta global user ID of the user who created the data product"}},"required":["id","name","type","metadata","createdBy"],"title":"Data Product Asset"},{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Asset ID"},"name":{"type":"string","minLength":1,"description":"Asset name"},"type":{"type":"string","enum":["DATA_OBJECT"]},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}]},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}]},"dagTagId":{"oneOf":[{"type":"number"}],"nullable":true},"requestId":{"type":"string","format":"cuid","description":"If requested, the ID of the access request for the asset"},"status":{"type":"string","enum":["APPROVED","CANCELED","DENIED","PENDING","NONE","PUBLISHER","REVOKED","EXPIRED"]},"metadata":{"type":"object","properties":{"subjectMatterExperts":{"default":[],"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Immuta global user ID of the subject matter expert"},"username":{"type":"string"},"name":{"type":"string"}},"required":["id"]}},"objectPath":{"type":"array","items":{"type":"string"}},"technology":{"type":"string","enum":["Snowflake","PostgreSQL","Databricks","Glue","MySQL","Teradata","MariaDB","Oracle","SQLServer","Trino","Redshift"]},"legacyType":{"type":"string"},"dataSourceId":{"type":"number"},"description":{"oneOf":[{"type":"string"}],"nullable":true},"externalLink":{"oneOf":[{"type":"string"}],"nullable":true}},"required":["objectPath"],"description":"Data object asset metadata"},"registered":{"default":true,"type":"boolean","description":"Whether the asset has been registered"}},"required":["id","name","type","metadata"],"title":"Data Object Asset"}],"title":"Asset"}},"required":["id","requestingUser","user","formVersion","type","status","createdAt","updatedAt"],"title":"Hydrated Access Request","description":"Access request with user and data product metadata"}}},"paths":{"/api/data-product/{id}/request/masking-exception":{"post":{"description":"Create a new masking exception request for specific columns in the specified data product","operationId":"requestMaskingException","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateMaskingExceptionRequest"}}}},"responses":{"201":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HydratedAccessRequest"}}}}},"summary":"Request masking exception to columns in a data product","tags":["Data Product","Access Request"]}}}}
```

## Revoke access to a data product

> Updates the specified access request to revoked and revokes access to data sources associated with the data product

```json
{"openapi":"3.0.0","info":{"title":"Immuta Data Marketplace","version":"1.0"},"tags":[{"name":"Data Product","description":"APIs for managing data products"},{"name":"Access Request","description":"APIs for managing data access"}],"servers":[{"url":"https://{global-segment}.api.immutacloud.com/marketplace","description":"Marketplace API Endpoint","variables":{"global-segment":{"default":"na","enum":["na","eu","ap"],"description":"Marketplace API global segment"}}}],"security":[{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"scheme":"bearer","bearerFormat":"JWT","type":"http"}}},"paths":{"/api/data-product/{id}/request/{requestId}":{"delete":{"description":"Updates the specified access request to revoked and revokes access to data sources associated with the data product","operationId":"revokeAccess","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"requestId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"204":{"description":""}},"summary":"Revoke access to a data product","tags":["Data Product","Access Request"]}}}}
```

## Get all data sources in the data product

> Get all data sources in the data product

```json
{"openapi":"3.0.0","info":{"title":"Immuta Data Marketplace","version":"1.0"},"tags":[{"name":"Data Product","description":"APIs for managing data products"},{"name":"Data Source","description":"APIs for managing data sources"}],"servers":[{"url":"https://{global-segment}.api.immutacloud.com/marketplace","description":"Marketplace API Endpoint","variables":{"global-segment":{"default":"na","enum":["na","eu","ap"],"description":"Marketplace API global segment"}}}],"security":[{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"scheme":"bearer","bearerFormat":"JWT","type":"http"}},"schemas":{"AllDataSources":{"type":"object","properties":{"dataSources":{"type":"array","items":{"type":"object","properties":{"sourceId":{"type":"string"}},"required":["sourceId"]}}},"required":["dataSources"]}}},"paths":{"/api/data-product/{id}/datasources/all":{"get":{"description":"Get all data sources in the data product","operationId":"getAllDataSources","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AllDataSources"}}}}},"summary":"Get all data sources in the data product","tags":["Data Product","Data Source"]}}}}
```

## Returns 5 most recent manual access determinations

> Returns 5 most recent data access requests with a terminal status as well as the approval records which contributed to that status.

```json
{"openapi":"3.0.0","info":{"title":"Immuta Data Marketplace","version":"1.0"},"tags":[{"name":"Data Product","description":"APIs for managing data products"},{"name":"Access Request","description":"APIs for managing data access"}],"servers":[{"url":"https://{global-segment}.api.immutacloud.com/marketplace","description":"Marketplace API Endpoint","variables":{"global-segment":{"default":"na","enum":["na","eu","ap"],"description":"Marketplace API global segment"}}}],"security":[{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"scheme":"bearer","bearerFormat":"JWT","type":"http"}},"schemas":{"RecentDeterminations":{"type":"object","properties":{"determinations":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"cuid"},"requestingUser":{"type":"object","properties":{"id":{"type":"number"},"iamId":{"type":"string","description":"ID of the IAM the user is associated with"},"globalUserId":{"type":"string","format":"uuid","description":"Immuta global user ID"},"username":{"type":"string","description":"Username/login name for the user"},"name":{"type":"string","description":"Display name"},"email":{"type":"string","description":"Email address","nullable":true},"authorizations":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}}},"required":["id","iamId","globalUserId","username","name"],"title":"Immuta User"},"user":{"type":"object","properties":{"id":{"type":"number"},"iamId":{"type":"string","description":"ID of the IAM the user is associated with"},"globalUserId":{"type":"string","format":"uuid","description":"Immuta global user ID"},"username":{"type":"string","description":"Username/login name for the user"},"name":{"type":"string","description":"Display name"},"email":{"type":"string","description":"Email address","nullable":true},"authorizations":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}}},"required":["id","iamId","globalUserId","username","name"],"title":"Immuta User"},"actionBy":{"type":"object","properties":{"id":{"type":"number"},"iamId":{"type":"string","description":"ID of the IAM the user is associated with"},"globalUserId":{"type":"string","format":"uuid","description":"Immuta global user ID"},"username":{"type":"string","description":"Username/login name for the user"},"name":{"type":"string","description":"Display name"},"email":{"type":"string","description":"Email address","nullable":true},"authorizations":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}}},"required":["id","iamId","globalUserId","username","name"],"title":"Immuta User","nullable":true},"reason":{"type":"string"},"status":{"type":"string","enum":["APPROVED","BLOCKED","CANCELED","DENIED","PENDING"]},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"expiration":{"type":"string","format":"date-time"}},"required":["id","requestingUser","user","actionBy","status","createdAt","updatedAt"]}}},"required":["determinations"],"title":"Recent Data Product Manual Determinations"}}},"paths":{"/api/data-product/{id}/recent-determinations":{"get":{"description":"Returns 5 most recent data access requests with a terminal status as well as the approval records which contributed to that status.","operationId":"recentDeterminations","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"type","required":false,"in":"query","schema":{"default":"DATA_ACCESS","type":"string","enum":["DATA_ACCESS","MASKING_EXCEPTION"]}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecentDeterminations"}}}}},"summary":"Returns 5 most recent manual access determinations","tags":["Data Product","Access Request"]}}}}
```

## View all request forms for a data product

> Get all the request forms for the specified data product

```json
{"openapi":"3.0.0","info":{"title":"Immuta Data Marketplace","version":"1.0"},"tags":[{"name":"Data Product","description":"APIs for managing data products"},{"name":"Request Form","description":"APIs for managing request forms"}],"servers":[{"url":"https://{global-segment}.api.immutacloud.com/marketplace","description":"Marketplace API Endpoint","variables":{"global-segment":{"default":"na","enum":["na","eu","ap"],"description":"Marketplace API global segment"}}}],"security":[{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"scheme":"bearer","bearerFormat":"JWT","type":"http"}},"schemas":{"RequestForms":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"fields":{"type":"array","items":{"discriminator":{"propertyName":"type"},"oneOf":[{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"type":{"type":"string","enum":["DROPDOWN","CHECKBOXES"]},"label":{"type":"string"},"required":{"default":true,"type":"boolean"},"options":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string"}},"required":["value"]}}},"required":["id","type","label","options"],"title":"Selection Form Field"},{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"type":{"type":"string","enum":["SHORT_ANSWER"]},"label":{"type":"string"},"required":{"default":true,"type":"boolean"}},"required":["id","type","label"],"title":"Short Answer Form Field"},{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"type":{"type":"string","enum":["ACCESS_DURATION"]},"label":{"type":"string","enum":["How long do you need access to this data?"]},"required":{"type":"boolean","enum":[true]}},"required":["id","type","label","required"],"title":"Access Duration Form Field"}]},"title":"RequestFormFields"},"policy":{"type":"object","properties":{"version":{"type":"string","description":"Policy schema version"},"rules":{"type":"array","items":{"type":"object","properties":{"conditions":{"oneOf":[{"type":"object","properties":{"all":{"type":"array","items":{}}},"required":["all"],"additionalProperties":false},{"type":"object","properties":{"any":{"type":"array","items":{}}},"required":["any"],"additionalProperties":false},{"type":"object","properties":{"not":{}},"required":["not"],"additionalProperties":false}]},"event":{"discriminator":{"propertyName":"type"},"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["approve"]},"params":{"type":"object","properties":{"comment":{"type":"string"},"duration":{"type":"number","minimum":1},"durationUnit":{"type":"string","enum":["HOURS","DAYS","WEEKS","MONTHS","YEARS"]}},"additionalProperties":false}},"required":["type","params"]},{"type":"object","properties":{"type":{"type":"string","enum":["deny"]},"params":{"type":"object","properties":{"comment":{"type":"string"}}}},"required":["type","params"]},{"type":"object","properties":{"type":{"type":"string","enum":["review"]},"params":{"type":"object","properties":{"stages":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"all":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["USER"],"description":"Entity type"},"id":{"type":"string","description":"Entity ID"},"displayName":{"type":"string","description":"Entity display name"}},"required":["type","id"]},{"type":"object","properties":{"type":{"type":"string","enum":["GROUP"],"description":"Entity type"},"id":{"type":"number","description":"Entity ID"},"iamId":{"type":"string","description":"IAM ID"},"name":{"type":"string","description":"Entity display name"}},"required":["type","name"]},{"type":"object","properties":{"type":{"type":"string","enum":["PERMISSION"]},"permission":{"type":"string","enum":["GOVERNANCE","USER_ADMIN","AUDIT"],"description":"Global permission"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["DOMAIN PERMISSION"]},"permission":{"type":"string","enum":["Manage Policies","Audit Activity","Manage Data Products","Manage Identifiers"],"description":"Domain permission"},"domainId":{"type":"string","description":"Domain ID"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["ATTRIBUTE"]},"key":{"type":"string","description":"Attribute key"},"value":{"type":"string","description":"Attribute value"}},"required":["type","key","value"]}]},"minItems":1}},"required":["all"]},{"type":"object","properties":{"any":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["USER"],"description":"Entity type"},"id":{"type":"string","description":"Entity ID"},"displayName":{"type":"string","description":"Entity display name"}},"required":["type","id"]},{"type":"object","properties":{"type":{"type":"string","enum":["GROUP"],"description":"Entity type"},"id":{"type":"number","description":"Entity ID"},"iamId":{"type":"string","description":"IAM ID"},"name":{"type":"string","description":"Entity display name"}},"required":["type","name"]},{"type":"object","properties":{"type":{"type":"string","enum":["PERMISSION"]},"permission":{"type":"string","enum":["GOVERNANCE","USER_ADMIN","AUDIT"],"description":"Global permission"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["DOMAIN PERMISSION"]},"permission":{"type":"string","enum":["Manage Policies","Audit Activity","Manage Data Products","Manage Identifiers"],"description":"Domain permission"},"domainId":{"type":"string","description":"Domain ID"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["ATTRIBUTE"]},"key":{"type":"string","description":"Attribute key"},"value":{"type":"string","description":"Attribute value"}},"required":["type","key","value"]}]},"minItems":1}},"required":["any"]}]},"description":"Array of stages for manual review"}},"required":["stages"]}},"required":["type","params"]},{"type":"object","properties":{"type":{"type":"string","enum":["dataProductPolicy"]}},"required":["type"]}]}},"required":["conditions","event"]}},"defaultEvent":{"discriminator":{"propertyName":"type"},"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["approve"]},"params":{"type":"object","properties":{"comment":{"type":"string"},"duration":{"type":"number","minimum":1},"durationUnit":{"type":"string","enum":["HOURS","DAYS","WEEKS","MONTHS","YEARS"]}},"additionalProperties":false}},"required":["type","params"]},{"type":"object","properties":{"type":{"type":"string","enum":["deny"]},"params":{"type":"object","properties":{"comment":{"type":"string"}}}},"required":["type","params"]},{"type":"object","properties":{"type":{"type":"string","enum":["review"]},"params":{"type":"object","properties":{"stages":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"all":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["USER"],"description":"Entity type"},"id":{"type":"string","description":"Entity ID"},"displayName":{"type":"string","description":"Entity display name"}},"required":["type","id"]},{"type":"object","properties":{"type":{"type":"string","enum":["GROUP"],"description":"Entity type"},"id":{"type":"number","description":"Entity ID"},"iamId":{"type":"string","description":"IAM ID"},"name":{"type":"string","description":"Entity display name"}},"required":["type","name"]},{"type":"object","properties":{"type":{"type":"string","enum":["PERMISSION"]},"permission":{"type":"string","enum":["GOVERNANCE","USER_ADMIN","AUDIT"],"description":"Global permission"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["DOMAIN PERMISSION"]},"permission":{"type":"string","enum":["Manage Policies","Audit Activity","Manage Data Products","Manage Identifiers"],"description":"Domain permission"},"domainId":{"type":"string","description":"Domain ID"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["ATTRIBUTE"]},"key":{"type":"string","description":"Attribute key"},"value":{"type":"string","description":"Attribute value"}},"required":["type","key","value"]}]},"minItems":1}},"required":["all"]},{"type":"object","properties":{"any":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["USER"],"description":"Entity type"},"id":{"type":"string","description":"Entity ID"},"displayName":{"type":"string","description":"Entity display name"}},"required":["type","id"]},{"type":"object","properties":{"type":{"type":"string","enum":["GROUP"],"description":"Entity type"},"id":{"type":"number","description":"Entity ID"},"iamId":{"type":"string","description":"IAM ID"},"name":{"type":"string","description":"Entity display name"}},"required":["type","name"]},{"type":"object","properties":{"type":{"type":"string","enum":["PERMISSION"]},"permission":{"type":"string","enum":["GOVERNANCE","USER_ADMIN","AUDIT"],"description":"Global permission"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["DOMAIN PERMISSION"]},"permission":{"type":"string","enum":["Manage Policies","Audit Activity","Manage Data Products","Manage Identifiers"],"description":"Domain permission"},"domainId":{"type":"string","description":"Domain ID"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["ATTRIBUTE"]},"key":{"type":"string","description":"Attribute key"},"value":{"type":"string","description":"Attribute value"}},"required":["type","key","value"]}]},"minItems":1}},"required":["any"]}]},"description":"Array of stages for manual review"}},"required":["stages"]}},"required":["type","params"]},{"type":"object","properties":{"type":{"type":"string","enum":["dataProductPolicy"]}},"required":["type"]}]}},"required":["rules","defaultEvent"]},"dataUseAgreements":{"default":[],"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string","description":"The name of data use agreement"},"body":{"type":"string","description":"The contents of data use agreement"}},"required":["id","name","body"]},"title":"Request Form Data Use Agreements"},"createdBy":{"type":"object","properties":{"globalUserId":{"type":"string","format":"uuid","description":"Immuta global user ID"},"name":{"type":"string","description":"Display name"}},"required":["globalUserId","name"],"description":"The user who originally created the request form"},"createdAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}]},"updatedBy":{"type":"object","properties":{"globalUserId":{"type":"string","format":"uuid","description":"Immuta global user ID"},"name":{"type":"string","description":"Display name"}},"required":["globalUserId","name"],"description":"The user who last updated the request form"},"updatedAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"string","format":"date-time"}]},"version":{"type":"string","format":"cuid","description":"The current version of the request form"}},"required":["id","name","fields","policy","createdBy","createdAt","updatedBy","updatedAt","version"],"title":"Request Form"}}}},"paths":{"/api/data-product/{id}/request-forms":{"get":{"description":"Get all the request forms for the specified data product","operationId":"getRequestForms","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RequestForms"}}}}},"summary":"View all request forms for a data product","tags":["Data Product","Request Form"]}}}}
```

## Search columns in data product

> Search and filter columns in the data product using the provided filters

```json
{"openapi":"3.0.0","info":{"title":"Immuta Data Marketplace","version":"1.0"},"tags":[{"name":"Data Product","description":"APIs for managing data products"}],"servers":[{"url":"https://{global-segment}.api.immutacloud.com/marketplace","description":"Marketplace API Endpoint","variables":{"global-segment":{"default":"na","enum":["na","eu","ap"],"description":"Marketplace API global segment"}}}],"security":[{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"scheme":"bearer","bearerFormat":"JWT","type":"http"}},"schemas":{"PaginatedImmutaDataSourceColumns":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Name of the column"},"sourceId":{"type":"string","description":"The ID of the data source containing the column"},"sourceName":{"type":"string","description":"The name of the data source containing the column"},"tags":{"type":"array","items":{"type":"string"},"description":"Tags associated with the column"},"type":{"type":"string","description":"The data source technology/platform type"},"masking":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","description":"Type of masking policy"},"global":{"type":"boolean","description":"Indicates if the masking policy is global (or local)"}},"required":["type","global"]},"description":"Masking policies applied to the column"}},"required":["name","sourceId","sourceName","tags","masking"]}},"meta":{"type":"object","properties":{"offset":{"default":0,"type":"number","minimum":0},"limit":{"default":10,"type":"number","minimum":1},"totalCount":{"type":"number"},"pageCount":{"type":"number"},"currentPage":{"type":"number"},"totalPages":{"type":"number"}},"required":["totalCount","pageCount","currentPage","totalPages"]}},"required":["data","meta"]}}},"paths":{"/api/data-product/{id}/columns":{"get":{"description":"Search and filter columns in the data product using the provided filters","operationId":"searchDataProductColumns","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"offset","required":false,"in":"query","schema":{"minimum":0,"default":0,"type":"number"}},{"name":"limit","required":false,"in":"query","schema":{"minimum":1,"default":10,"type":"number"}},{"name":"sortOrder","required":false,"in":"query","schema":{"default":"asc","type":"string","enum":["asc","desc"]}},{"name":"dataObjectId","required":false,"in":"query","description":"The data object ID to search columns for","schema":{"format":"uuid","type":"string"}},{"name":"dataSourceIds","required":false,"in":"query","schema":{"default":[],"type":"array","items":{"type":"string"}}},{"name":"searchText","required":false,"in":"query","description":"Search text to filter data source columns","schema":{"type":"string"}},{"name":"maskedOnly","required":false,"in":"query","description":"Whether to filter columns that have a masking policy applied to them","schema":{"default":false,"type":"boolean"}},{"name":"tagIds","required":false,"in":"query","schema":{"default":[],"type":"array","items":{"type":"string"}}},{"name":"dir","required":false,"in":"query","schema":{"default":"ASC","type":"string","enum":["ASC","DESC"]}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedImmutaDataSourceColumns"}}}}},"summary":"Search columns in data product","tags":["Data Product"]}}}}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://documentation.immuta.com/saas/developer-guides/api-intro/marketplace-api/data-product.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.