> For the complete documentation index, see [llms.txt](https://documentation.immuta.com/saas/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documentation.immuta.com/saas/developer-guides/api-intro/marketplace-api/asset.md).

# Asset

APIs for managing assets

## Get asset by metadata

> Search for assets by their metadata.

```json
{"openapi":"3.0.0","info":{"title":"Immuta Data Marketplace","version":"1.0"},"tags":[{"name":"Asset","description":"APIs for managing assets"}],"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":{"Asset":{"title":"Asset","oneOf":[{"$ref":"#/components/schemas/DataProductAsset"},{"$ref":"#/components/schemas/DataObjectAsset"}],"discriminator":{"propertyName":"type","mapping":{"DATA_PRODUCT":"#/components/schemas/DataProductAsset","DATA_OBJECT":"#/components/schemas/DataObjectAsset"}}},"DataProductAsset":{"title":"Data Product Asset","type":"object","properties":{"id":{"oneOf":[{"type":"string","format":"cuid","pattern":"^[cC][^\\s-]{8,}$"},{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"}]},"name":{"description":"Asset name","type":"string","minLength":1},"type":{"type":"string","enum":["DATA_PRODUCT"]},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"updatedBy":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$","description":"Immuta global user ID of the user who last updated the data product","nullable":true},"dagTagId":{"type":"number","nullable":true},"requestId":{"description":"If requested, the ID of the access request for the data product","type":"string","format":"cuid","pattern":"^[cC][^\\s-]{8,}$"},"status":{"type":"string","enum":["APPROVED","CANCELED","DENIED","PENDING","NONE","PUBLISHER","REVOKED","EXPIRED"]},"description":{"type":"string","description":"Data product description","nullable":true},"domains":{"description":"Array of domain IDs associated with the data product","minItems":1,"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"}},"subjectMatterExperts":{"default":[],"type":"array","items":{"type":"object","properties":{"id":{"description":"Immuta global user ID of the subject matter expert","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"},"username":{"type":"string"},"name":{"type":"string"}},"required":["id"]}},"suspended":{"description":"Whether access to the data product's data sources is suspended","default":false,"type":"boolean"},"createdBy":{"description":"Immuta global user ID of the user who created the data product","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"},"expiration":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$","nullable":true},"stats":{"$ref":"#/components/schemas/DataProductStats1"},"dataAccessPolicy":{"$ref":"#/components/schemas/DataProductDataAccessPolicy1"},"maskingExceptionPolicy":{"$ref":"#/components/schemas/DataProductMaskingExceptionPolicy1"}},"required":["id","name","type","createdAt","updatedAt","domains","createdBy"]},"DataProductStats1":{"description":"Data product statistics","title":"Data Product Stats","type":"object","properties":{"dataSourceCount":{"description":"Count of data sources in a data product","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"pendingRequestCount":{"description":"Count of pending requests for a data product","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"approvedRequestCount":{"description":"Count of approved requests for a data product","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"revokedRequestCount":{"description":"Count of revoked requests for a data product","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"canceledRequestCount":{"description":"Count of canceled requests for a data product","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"deniedRequestCount":{"description":"Count of denied requests for a data product","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"expiredRequestCount":{"description":"Count of expired requests for a data product","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"totalRequestCount":{"description":"Count of total requests for a data product","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["dataSourceCount","pendingRequestCount","approvedRequestCount","revokedRequestCount","canceledRequestCount","deniedRequestCount","expiredRequestCount","totalRequestCount"]},"DataProductDataAccessPolicy1":{"title":"Data Product Data Access Policy","type":"object","properties":{"version":{"description":"Policy schema version","type":"string"},"rules":{"type":"array","items":{"$ref":"#/components/schemas/RuleProperties"}},"defaultEvent":{"oneOf":[{"$ref":"#/components/schemas/ApproveEvent"},{"$ref":"#/components/schemas/ReviewEvent"}],"discriminator":{"propertyName":"type","mapping":{"approve":"#/components/schemas/ApproveEvent","review":"#/components/schemas/ReviewEvent"}}}},"required":["rules","defaultEvent"]},"RuleProperties":{"type":"object","properties":{"conditions":{"oneOf":[{"$ref":"#/components/schemas/AllConditions"},{"$ref":"#/components/schemas/AnyConditions"},{"$ref":"#/components/schemas/NotConditions"}]},"event":{"$ref":"#/components/schemas/ReviewPolicyEvent"}},"required":["conditions","event"]},"AllConditions":{"type":"object","properties":{"all":{"type":"array","items":{}}},"required":["all"],"additionalProperties":false},"AnyConditions":{"type":"object","properties":{"any":{"type":"array","items":{}}},"required":["any"],"additionalProperties":false},"NotConditions":{"type":"object","properties":{"not":{}},"required":["not"],"additionalProperties":false},"ReviewPolicyEvent":{"oneOf":[{"$ref":"#/components/schemas/ApproveEvent"},{"$ref":"#/components/schemas/DenyEvent"},{"$ref":"#/components/schemas/ReviewEvent"},{"$ref":"#/components/schemas/DataProductPolicyEvent"}],"discriminator":{"propertyName":"type","mapping":{"approve":"#/components/schemas/ApproveEvent","deny":"#/components/schemas/DenyEvent","review":"#/components/schemas/ReviewEvent","dataProductPolicy":"#/components/schemas/DataProductPolicyEvent"}}},"ApproveEvent":{"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"]}}}},"required":["type","params"]},"DenyEvent":{"type":"object","properties":{"type":{"type":"string","enum":["deny"]},"params":{"type":"object","properties":{"comment":{"type":"string"}}}},"required":["type","params"]},"ReviewEvent":{"type":"object","properties":{"type":{"type":"string","enum":["review"]},"params":{"type":"object","properties":{"stages":{"description":"Array of stages for manual review","type":"array","items":{"oneOf":[{"type":"object","properties":{"all":{"minItems":1,"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"description":"Entity type","type":"string","enum":["USER"]},"id":{"description":"Entity ID","type":"string"},"displayName":{"description":"Entity display name","type":"string"}},"required":["type","id"]},{"type":"object","properties":{"type":{"description":"Entity type","type":"string","enum":["GROUP"]},"id":{"description":"Entity ID","type":"number"},"iamId":{"description":"IAM ID","type":"string"},"name":{"description":"Entity display name","type":"string"}},"required":["type","name"]},{"type":"object","properties":{"type":{"type":"string","enum":["PERMISSION"]},"permission":{"description":"Global permission","type":"string","enum":["GOVERNANCE","USER_ADMIN","AUDIT"]}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["DOMAIN PERMISSION"]},"permission":{"description":"Domain permission","type":"string","enum":["Manage Policies","Audit Activity","Manage Data Products","Manage Identifiers"]},"domainId":{"description":"Domain ID","type":"string"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["ATTRIBUTE"]},"key":{"description":"Attribute key","type":"string"},"value":{"description":"Attribute value","type":"string"}},"required":["type","key","value"]},{"type":"object","properties":{"type":{"type":"string","enum":["CATALOG PERMISSION"]}},"required":["type"]}]}}},"required":["all"]},{"type":"object","properties":{"any":{"minItems":1,"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"description":"Entity type","type":"string","enum":["USER"]},"id":{"description":"Entity ID","type":"string"},"displayName":{"description":"Entity display name","type":"string"}},"required":["type","id"]},{"type":"object","properties":{"type":{"description":"Entity type","type":"string","enum":["GROUP"]},"id":{"description":"Entity ID","type":"number"},"iamId":{"description":"IAM ID","type":"string"},"name":{"description":"Entity display name","type":"string"}},"required":["type","name"]},{"type":"object","properties":{"type":{"type":"string","enum":["PERMISSION"]},"permission":{"description":"Global permission","type":"string","enum":["GOVERNANCE","USER_ADMIN","AUDIT"]}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["DOMAIN PERMISSION"]},"permission":{"description":"Domain permission","type":"string","enum":["Manage Policies","Audit Activity","Manage Data Products","Manage Identifiers"]},"domainId":{"description":"Domain ID","type":"string"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["ATTRIBUTE"]},"key":{"description":"Attribute key","type":"string"},"value":{"description":"Attribute value","type":"string"}},"required":["type","key","value"]},{"type":"object","properties":{"type":{"type":"string","enum":["CATALOG PERMISSION"]}},"required":["type"]}]}}},"required":["any"]}]}}},"required":["stages"]}},"required":["type","params"]},"DataProductPolicyEvent":{"type":"object","properties":{"type":{"type":"string","enum":["dataProductPolicy"]}},"required":["type"]},"DataProductMaskingExceptionPolicy1":{"title":"Data Product Masking Exception Policy","type":"object","properties":{"version":{"description":"Policy schema version","type":"string"},"rules":{"type":"array","items":{"$ref":"#/components/schemas/RuleProperties"}},"defaultEvent":{"oneOf":[{"$ref":"#/components/schemas/ApproveEvent"},{"$ref":"#/components/schemas/ReviewEvent"}],"discriminator":{"propertyName":"type","mapping":{"approve":"#/components/schemas/ApproveEvent","review":"#/components/schemas/ReviewEvent"}}}},"required":["rules","defaultEvent"]},"DataObjectAsset":{"title":"Data Object Asset","type":"object","properties":{"id":{"oneOf":[{"type":"string","format":"cuid","pattern":"^[cC][^\\s-]{8,}$"},{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"}]},"name":{"description":"Asset name","type":"string","minLength":1},"type":{"type":"string","enum":["DATA_OBJECT"]},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"updatedBy":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$","description":"Immuta global user ID of the user who last updated the asset","nullable":true},"dagTagId":{"type":"number","nullable":true},"requestId":{"description":"If requested, the ID of the access request for the asset","type":"string","format":"cuid","pattern":"^[cC][^\\s-]{8,}$"},"status":{"type":"string","enum":["APPROVED","CANCELED","DENIED","PENDING","NONE","PUBLISHER","REVOKED","EXPIRED"]},"metadata":{"description":"Data object asset metadata","type":"object","properties":{"subjectMatterExperts":{"default":[],"type":"array","items":{"type":"object","properties":{"id":{"description":"Immuta global user ID of the subject matter expert","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"},"username":{"type":"string"},"name":{"type":"string"}},"required":["id"]}},"objectPath":{"type":"array","items":{"type":"string"}},"technology":{"type":"string","enum":["Snowflake","PostgreSQL","Databricks","Phantom","Glue","MySQL","Teradata","MariaDB","Oracle","SQLServer","Trino","Redshift","BigQuery","Custom"]},"host":{"type":"string"},"port":{"type":"integer","minimum":1,"maximum":65535},"legacyType":{"type":"string"},"dataSourceId":{"type":"number"},"description":{"type":"string","nullable":true},"externalLink":{"type":"string","nullable":true}},"required":["objectPath"]},"registered":{"description":"Whether the asset has been registered","default":true,"type":"boolean"},"stats":{"$ref":"#/components/schemas/DataObjectAssetStats"}},"required":["id","name","type","metadata"]},"DataObjectAssetStats":{"description":"Data object asset statistics","title":"Data Object Asset Stats","type":"object","properties":{"dataSourceCount":{"description":"Count of data sources in the data object (from DAG)","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["dataSourceCount"]},"AugmentedZodDto":{"type":"object","properties":{"statusCode":{"type":"number"},"message":{"type":"string"},"error":{"type":"string"}},"required":["statusCode","message"]}}},"paths":{"/api/asset/byMetadata":{"get":{"description":"Search for assets by their metadata.","operationId":"getAssetByMetadata","parameters":[{"description":"Dot-delimited fully qualified name of the asset.","required":true,"name":"fullyQualifiedName","in":"query","schema":{"type":"string"}},{"description":"Asset type to help narrow down the search if there are multiple assets with the same fullyQualifiedName.","required":false,"name":"assetType","in":"query","schema":{"type":"string"}},{"description":"Hostname or IP address of the asset.","required":false,"name":"host","in":"query","schema":{"type":"string"}},{"description":"Port to narrow connection matching.","required":false,"name":"port","in":"query","schema":{"minimum":1,"maximum":65535,"type":"integer"}},{"description":"Technology of the asset.","required":false,"name":"technology","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Asset"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AugmentedZodDto"}}}}},"summary":"Get asset by metadata","tags":["Asset"]}}}}
```

## Get asset by ID

> Get asset by ID

```json
{"openapi":"3.0.0","info":{"title":"Immuta Data Marketplace","version":"1.0"},"tags":[{"name":"Asset","description":"APIs for managing assets"}],"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":{"Asset":{"title":"Asset","oneOf":[{"$ref":"#/components/schemas/DataProductAsset"},{"$ref":"#/components/schemas/DataObjectAsset"}],"discriminator":{"propertyName":"type","mapping":{"DATA_PRODUCT":"#/components/schemas/DataProductAsset","DATA_OBJECT":"#/components/schemas/DataObjectAsset"}}},"DataProductAsset":{"title":"Data Product Asset","type":"object","properties":{"id":{"oneOf":[{"type":"string","format":"cuid","pattern":"^[cC][^\\s-]{8,}$"},{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"}]},"name":{"description":"Asset name","type":"string","minLength":1},"type":{"type":"string","enum":["DATA_PRODUCT"]},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"updatedBy":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$","description":"Immuta global user ID of the user who last updated the data product","nullable":true},"dagTagId":{"type":"number","nullable":true},"requestId":{"description":"If requested, the ID of the access request for the data product","type":"string","format":"cuid","pattern":"^[cC][^\\s-]{8,}$"},"status":{"type":"string","enum":["APPROVED","CANCELED","DENIED","PENDING","NONE","PUBLISHER","REVOKED","EXPIRED"]},"description":{"type":"string","description":"Data product description","nullable":true},"domains":{"description":"Array of domain IDs associated with the data product","minItems":1,"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"}},"subjectMatterExperts":{"default":[],"type":"array","items":{"type":"object","properties":{"id":{"description":"Immuta global user ID of the subject matter expert","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"},"username":{"type":"string"},"name":{"type":"string"}},"required":["id"]}},"suspended":{"description":"Whether access to the data product's data sources is suspended","default":false,"type":"boolean"},"createdBy":{"description":"Immuta global user ID of the user who created the data product","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"},"expiration":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$","nullable":true},"stats":{"$ref":"#/components/schemas/DataProductStats1"},"dataAccessPolicy":{"$ref":"#/components/schemas/DataProductDataAccessPolicy1"},"maskingExceptionPolicy":{"$ref":"#/components/schemas/DataProductMaskingExceptionPolicy1"}},"required":["id","name","type","createdAt","updatedAt","domains","createdBy"]},"DataProductStats1":{"description":"Data product statistics","title":"Data Product Stats","type":"object","properties":{"dataSourceCount":{"description":"Count of data sources in a data product","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"pendingRequestCount":{"description":"Count of pending requests for a data product","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"approvedRequestCount":{"description":"Count of approved requests for a data product","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"revokedRequestCount":{"description":"Count of revoked requests for a data product","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"canceledRequestCount":{"description":"Count of canceled requests for a data product","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"deniedRequestCount":{"description":"Count of denied requests for a data product","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"expiredRequestCount":{"description":"Count of expired requests for a data product","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"totalRequestCount":{"description":"Count of total requests for a data product","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["dataSourceCount","pendingRequestCount","approvedRequestCount","revokedRequestCount","canceledRequestCount","deniedRequestCount","expiredRequestCount","totalRequestCount"]},"DataProductDataAccessPolicy1":{"title":"Data Product Data Access Policy","type":"object","properties":{"version":{"description":"Policy schema version","type":"string"},"rules":{"type":"array","items":{"$ref":"#/components/schemas/RuleProperties"}},"defaultEvent":{"oneOf":[{"$ref":"#/components/schemas/ApproveEvent"},{"$ref":"#/components/schemas/ReviewEvent"}],"discriminator":{"propertyName":"type","mapping":{"approve":"#/components/schemas/ApproveEvent","review":"#/components/schemas/ReviewEvent"}}}},"required":["rules","defaultEvent"]},"RuleProperties":{"type":"object","properties":{"conditions":{"oneOf":[{"$ref":"#/components/schemas/AllConditions"},{"$ref":"#/components/schemas/AnyConditions"},{"$ref":"#/components/schemas/NotConditions"}]},"event":{"$ref":"#/components/schemas/ReviewPolicyEvent"}},"required":["conditions","event"]},"AllConditions":{"type":"object","properties":{"all":{"type":"array","items":{}}},"required":["all"],"additionalProperties":false},"AnyConditions":{"type":"object","properties":{"any":{"type":"array","items":{}}},"required":["any"],"additionalProperties":false},"NotConditions":{"type":"object","properties":{"not":{}},"required":["not"],"additionalProperties":false},"ReviewPolicyEvent":{"oneOf":[{"$ref":"#/components/schemas/ApproveEvent"},{"$ref":"#/components/schemas/DenyEvent"},{"$ref":"#/components/schemas/ReviewEvent"},{"$ref":"#/components/schemas/DataProductPolicyEvent"}],"discriminator":{"propertyName":"type","mapping":{"approve":"#/components/schemas/ApproveEvent","deny":"#/components/schemas/DenyEvent","review":"#/components/schemas/ReviewEvent","dataProductPolicy":"#/components/schemas/DataProductPolicyEvent"}}},"ApproveEvent":{"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"]}}}},"required":["type","params"]},"DenyEvent":{"type":"object","properties":{"type":{"type":"string","enum":["deny"]},"params":{"type":"object","properties":{"comment":{"type":"string"}}}},"required":["type","params"]},"ReviewEvent":{"type":"object","properties":{"type":{"type":"string","enum":["review"]},"params":{"type":"object","properties":{"stages":{"description":"Array of stages for manual review","type":"array","items":{"oneOf":[{"type":"object","properties":{"all":{"minItems":1,"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"description":"Entity type","type":"string","enum":["USER"]},"id":{"description":"Entity ID","type":"string"},"displayName":{"description":"Entity display name","type":"string"}},"required":["type","id"]},{"type":"object","properties":{"type":{"description":"Entity type","type":"string","enum":["GROUP"]},"id":{"description":"Entity ID","type":"number"},"iamId":{"description":"IAM ID","type":"string"},"name":{"description":"Entity display name","type":"string"}},"required":["type","name"]},{"type":"object","properties":{"type":{"type":"string","enum":["PERMISSION"]},"permission":{"description":"Global permission","type":"string","enum":["GOVERNANCE","USER_ADMIN","AUDIT"]}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["DOMAIN PERMISSION"]},"permission":{"description":"Domain permission","type":"string","enum":["Manage Policies","Audit Activity","Manage Data Products","Manage Identifiers"]},"domainId":{"description":"Domain ID","type":"string"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["ATTRIBUTE"]},"key":{"description":"Attribute key","type":"string"},"value":{"description":"Attribute value","type":"string"}},"required":["type","key","value"]},{"type":"object","properties":{"type":{"type":"string","enum":["CATALOG PERMISSION"]}},"required":["type"]}]}}},"required":["all"]},{"type":"object","properties":{"any":{"minItems":1,"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"description":"Entity type","type":"string","enum":["USER"]},"id":{"description":"Entity ID","type":"string"},"displayName":{"description":"Entity display name","type":"string"}},"required":["type","id"]},{"type":"object","properties":{"type":{"description":"Entity type","type":"string","enum":["GROUP"]},"id":{"description":"Entity ID","type":"number"},"iamId":{"description":"IAM ID","type":"string"},"name":{"description":"Entity display name","type":"string"}},"required":["type","name"]},{"type":"object","properties":{"type":{"type":"string","enum":["PERMISSION"]},"permission":{"description":"Global permission","type":"string","enum":["GOVERNANCE","USER_ADMIN","AUDIT"]}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["DOMAIN PERMISSION"]},"permission":{"description":"Domain permission","type":"string","enum":["Manage Policies","Audit Activity","Manage Data Products","Manage Identifiers"]},"domainId":{"description":"Domain ID","type":"string"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["ATTRIBUTE"]},"key":{"description":"Attribute key","type":"string"},"value":{"description":"Attribute value","type":"string"}},"required":["type","key","value"]},{"type":"object","properties":{"type":{"type":"string","enum":["CATALOG PERMISSION"]}},"required":["type"]}]}}},"required":["any"]}]}}},"required":["stages"]}},"required":["type","params"]},"DataProductPolicyEvent":{"type":"object","properties":{"type":{"type":"string","enum":["dataProductPolicy"]}},"required":["type"]},"DataProductMaskingExceptionPolicy1":{"title":"Data Product Masking Exception Policy","type":"object","properties":{"version":{"description":"Policy schema version","type":"string"},"rules":{"type":"array","items":{"$ref":"#/components/schemas/RuleProperties"}},"defaultEvent":{"oneOf":[{"$ref":"#/components/schemas/ApproveEvent"},{"$ref":"#/components/schemas/ReviewEvent"}],"discriminator":{"propertyName":"type","mapping":{"approve":"#/components/schemas/ApproveEvent","review":"#/components/schemas/ReviewEvent"}}}},"required":["rules","defaultEvent"]},"DataObjectAsset":{"title":"Data Object Asset","type":"object","properties":{"id":{"oneOf":[{"type":"string","format":"cuid","pattern":"^[cC][^\\s-]{8,}$"},{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"}]},"name":{"description":"Asset name","type":"string","minLength":1},"type":{"type":"string","enum":["DATA_OBJECT"]},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"updatedBy":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$","description":"Immuta global user ID of the user who last updated the asset","nullable":true},"dagTagId":{"type":"number","nullable":true},"requestId":{"description":"If requested, the ID of the access request for the asset","type":"string","format":"cuid","pattern":"^[cC][^\\s-]{8,}$"},"status":{"type":"string","enum":["APPROVED","CANCELED","DENIED","PENDING","NONE","PUBLISHER","REVOKED","EXPIRED"]},"metadata":{"description":"Data object asset metadata","type":"object","properties":{"subjectMatterExperts":{"default":[],"type":"array","items":{"type":"object","properties":{"id":{"description":"Immuta global user ID of the subject matter expert","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"},"username":{"type":"string"},"name":{"type":"string"}},"required":["id"]}},"objectPath":{"type":"array","items":{"type":"string"}},"technology":{"type":"string","enum":["Snowflake","PostgreSQL","Databricks","Phantom","Glue","MySQL","Teradata","MariaDB","Oracle","SQLServer","Trino","Redshift","BigQuery","Custom"]},"host":{"type":"string"},"port":{"type":"integer","minimum":1,"maximum":65535},"legacyType":{"type":"string"},"dataSourceId":{"type":"number"},"description":{"type":"string","nullable":true},"externalLink":{"type":"string","nullable":true}},"required":["objectPath"]},"registered":{"description":"Whether the asset has been registered","default":true,"type":"boolean"},"stats":{"$ref":"#/components/schemas/DataObjectAssetStats"}},"required":["id","name","type","metadata"]},"DataObjectAssetStats":{"description":"Data object asset statistics","title":"Data Object Asset Stats","type":"object","properties":{"dataSourceCount":{"description":"Count of data sources in the data object (from DAG)","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["dataSourceCount"]},"AugmentedZodDto":{"type":"object","properties":{"statusCode":{"type":"number"},"message":{"type":"string"},"error":{"type":"string"}},"required":["statusCode","message"]}}},"paths":{"/api/asset/{id}":{"get":{"description":"Get asset by ID","operationId":"getAssetById","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Asset"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AugmentedZodDto"}}}}},"summary":"Get asset by ID","tags":["Asset"]}}}}
```

## Update asset by ID

> Update an existing asset by ID

```json
{"openapi":"3.0.0","info":{"title":"Immuta Data Marketplace","version":"1.0"},"tags":[{"name":"Asset","description":"APIs for managing assets"}],"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":{"UpdateAssetDto":{"title":"Update Asset","oneOf":[{"$ref":"#/components/schemas/UpdateAssetDataProduct"},{"$ref":"#/components/schemas/UpdateDataObjectAsset"}],"discriminator":{"propertyName":"type","mapping":{"DATA_PRODUCT":"#/components/schemas/UpdateAssetDataProduct","DATA_OBJECT":"#/components/schemas/UpdateDataObjectAsset"}}},"UpdateAssetDataProduct":{"title":"Update Data Product Asset","type":"object","properties":{"type":{"type":"string","enum":["DATA_PRODUCT"]},"name":{"description":"Asset name","type":"string","minLength":1},"description":{"type":"string","description":"Data product description","nullable":true},"subjectMatterExperts":{"type":"array","items":{"type":"object","properties":{"id":{"description":"Immuta global user ID of the subject matter expert","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"},"username":{"type":"string"},"name":{"type":"string"}},"required":["id"]}},"dataAccessRequestFormId":{"oneOf":[{"type":"string","format":"cuid","pattern":"^[cC][^\\s-]{8,}$"},{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"}]},"maskingExceptionRequestFormId":{"oneOf":[{"type":"string","format":"cuid","pattern":"^[cC][^\\s-]{8,}$"},{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"}]},"suspended":{"type":"boolean"}},"required":["type","name"],"additionalProperties":false},"UpdateDataObjectAsset":{"title":"Update Data Object Asset","type":"object","properties":{"type":{"type":"string","enum":["DATA_OBJECT"]},"metadata":{"type":"object","properties":{"subjectMatterExperts":{"default":[],"type":"array","items":{"type":"object","properties":{"id":{"description":"Immuta global user ID of the subject matter expert","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"},"username":{"type":"string"},"name":{"type":"string"}},"required":["id"]}},"objectPath":{"type":"array","items":{"type":"string"}},"technology":{"type":"string","enum":["Snowflake","PostgreSQL","Databricks","Phantom","Glue","MySQL","Teradata","MariaDB","Oracle","SQLServer","Trino","Redshift","BigQuery","Custom"]},"legacyType":{"type":"string"},"dataSourceId":{"type":"number"},"description":{"type":"string","nullable":true},"externalLink":{"type":"string","nullable":true}},"required":["objectPath"]},"dataAccessRequestFormId":{"description":"Request form ID. If not provided, the asset will inherit from a parent asset.","nullable":true,"oneOf":[{"type":"string","format":"cuid","pattern":"^[cC][^\\s-]{8,}$"},{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"}]},"maskingExceptionRequestFormId":{"description":"Request form ID. If not provided, the asset will inherit from a parent asset.","nullable":true,"oneOf":[{"type":"string","format":"cuid","pattern":"^[cC][^\\s-]{8,}$"},{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"}]}},"required":["type","metadata"]},"Asset":{"title":"Asset","oneOf":[{"$ref":"#/components/schemas/DataProductAsset"},{"$ref":"#/components/schemas/DataObjectAsset"}],"discriminator":{"propertyName":"type","mapping":{"DATA_PRODUCT":"#/components/schemas/DataProductAsset","DATA_OBJECT":"#/components/schemas/DataObjectAsset"}}},"DataProductAsset":{"title":"Data Product Asset","type":"object","properties":{"id":{"oneOf":[{"type":"string","format":"cuid","pattern":"^[cC][^\\s-]{8,}$"},{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"}]},"name":{"description":"Asset name","type":"string","minLength":1},"type":{"type":"string","enum":["DATA_PRODUCT"]},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"updatedBy":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$","description":"Immuta global user ID of the user who last updated the data product","nullable":true},"dagTagId":{"type":"number","nullable":true},"requestId":{"description":"If requested, the ID of the access request for the data product","type":"string","format":"cuid","pattern":"^[cC][^\\s-]{8,}$"},"status":{"type":"string","enum":["APPROVED","CANCELED","DENIED","PENDING","NONE","PUBLISHER","REVOKED","EXPIRED"]},"description":{"type":"string","description":"Data product description","nullable":true},"domains":{"description":"Array of domain IDs associated with the data product","minItems":1,"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"}},"subjectMatterExperts":{"default":[],"type":"array","items":{"type":"object","properties":{"id":{"description":"Immuta global user ID of the subject matter expert","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"},"username":{"type":"string"},"name":{"type":"string"}},"required":["id"]}},"suspended":{"description":"Whether access to the data product's data sources is suspended","default":false,"type":"boolean"},"createdBy":{"description":"Immuta global user ID of the user who created the data product","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"},"expiration":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$","nullable":true},"stats":{"$ref":"#/components/schemas/DataProductStats1"},"dataAccessPolicy":{"$ref":"#/components/schemas/DataProductDataAccessPolicy1"},"maskingExceptionPolicy":{"$ref":"#/components/schemas/DataProductMaskingExceptionPolicy1"}},"required":["id","name","type","createdAt","updatedAt","domains","createdBy"]},"DataProductStats1":{"description":"Data product statistics","title":"Data Product Stats","type":"object","properties":{"dataSourceCount":{"description":"Count of data sources in a data product","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"pendingRequestCount":{"description":"Count of pending requests for a data product","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"approvedRequestCount":{"description":"Count of approved requests for a data product","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"revokedRequestCount":{"description":"Count of revoked requests for a data product","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"canceledRequestCount":{"description":"Count of canceled requests for a data product","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"deniedRequestCount":{"description":"Count of denied requests for a data product","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"expiredRequestCount":{"description":"Count of expired requests for a data product","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"totalRequestCount":{"description":"Count of total requests for a data product","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["dataSourceCount","pendingRequestCount","approvedRequestCount","revokedRequestCount","canceledRequestCount","deniedRequestCount","expiredRequestCount","totalRequestCount"]},"DataProductDataAccessPolicy1":{"title":"Data Product Data Access Policy","type":"object","properties":{"version":{"description":"Policy schema version","type":"string"},"rules":{"type":"array","items":{"$ref":"#/components/schemas/RuleProperties"}},"defaultEvent":{"oneOf":[{"$ref":"#/components/schemas/ApproveEvent"},{"$ref":"#/components/schemas/ReviewEvent"}],"discriminator":{"propertyName":"type","mapping":{"approve":"#/components/schemas/ApproveEvent","review":"#/components/schemas/ReviewEvent"}}}},"required":["rules","defaultEvent"]},"RuleProperties":{"type":"object","properties":{"conditions":{"oneOf":[{"$ref":"#/components/schemas/AllConditions"},{"$ref":"#/components/schemas/AnyConditions"},{"$ref":"#/components/schemas/NotConditions"}]},"event":{"$ref":"#/components/schemas/ReviewPolicyEvent"}},"required":["conditions","event"]},"AllConditions":{"type":"object","properties":{"all":{"type":"array","items":{}}},"required":["all"],"additionalProperties":false},"AnyConditions":{"type":"object","properties":{"any":{"type":"array","items":{}}},"required":["any"],"additionalProperties":false},"NotConditions":{"type":"object","properties":{"not":{}},"required":["not"],"additionalProperties":false},"ReviewPolicyEvent":{"oneOf":[{"$ref":"#/components/schemas/ApproveEvent"},{"$ref":"#/components/schemas/DenyEvent"},{"$ref":"#/components/schemas/ReviewEvent"},{"$ref":"#/components/schemas/DataProductPolicyEvent"}],"discriminator":{"propertyName":"type","mapping":{"approve":"#/components/schemas/ApproveEvent","deny":"#/components/schemas/DenyEvent","review":"#/components/schemas/ReviewEvent","dataProductPolicy":"#/components/schemas/DataProductPolicyEvent"}}},"ApproveEvent":{"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"]}}}},"required":["type","params"]},"DenyEvent":{"type":"object","properties":{"type":{"type":"string","enum":["deny"]},"params":{"type":"object","properties":{"comment":{"type":"string"}}}},"required":["type","params"]},"ReviewEvent":{"type":"object","properties":{"type":{"type":"string","enum":["review"]},"params":{"type":"object","properties":{"stages":{"description":"Array of stages for manual review","type":"array","items":{"oneOf":[{"type":"object","properties":{"all":{"minItems":1,"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"description":"Entity type","type":"string","enum":["USER"]},"id":{"description":"Entity ID","type":"string"},"displayName":{"description":"Entity display name","type":"string"}},"required":["type","id"]},{"type":"object","properties":{"type":{"description":"Entity type","type":"string","enum":["GROUP"]},"id":{"description":"Entity ID","type":"number"},"iamId":{"description":"IAM ID","type":"string"},"name":{"description":"Entity display name","type":"string"}},"required":["type","name"]},{"type":"object","properties":{"type":{"type":"string","enum":["PERMISSION"]},"permission":{"description":"Global permission","type":"string","enum":["GOVERNANCE","USER_ADMIN","AUDIT"]}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["DOMAIN PERMISSION"]},"permission":{"description":"Domain permission","type":"string","enum":["Manage Policies","Audit Activity","Manage Data Products","Manage Identifiers"]},"domainId":{"description":"Domain ID","type":"string"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["ATTRIBUTE"]},"key":{"description":"Attribute key","type":"string"},"value":{"description":"Attribute value","type":"string"}},"required":["type","key","value"]},{"type":"object","properties":{"type":{"type":"string","enum":["CATALOG PERMISSION"]}},"required":["type"]}]}}},"required":["all"]},{"type":"object","properties":{"any":{"minItems":1,"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"description":"Entity type","type":"string","enum":["USER"]},"id":{"description":"Entity ID","type":"string"},"displayName":{"description":"Entity display name","type":"string"}},"required":["type","id"]},{"type":"object","properties":{"type":{"description":"Entity type","type":"string","enum":["GROUP"]},"id":{"description":"Entity ID","type":"number"},"iamId":{"description":"IAM ID","type":"string"},"name":{"description":"Entity display name","type":"string"}},"required":["type","name"]},{"type":"object","properties":{"type":{"type":"string","enum":["PERMISSION"]},"permission":{"description":"Global permission","type":"string","enum":["GOVERNANCE","USER_ADMIN","AUDIT"]}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["DOMAIN PERMISSION"]},"permission":{"description":"Domain permission","type":"string","enum":["Manage Policies","Audit Activity","Manage Data Products","Manage Identifiers"]},"domainId":{"description":"Domain ID","type":"string"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["ATTRIBUTE"]},"key":{"description":"Attribute key","type":"string"},"value":{"description":"Attribute value","type":"string"}},"required":["type","key","value"]},{"type":"object","properties":{"type":{"type":"string","enum":["CATALOG PERMISSION"]}},"required":["type"]}]}}},"required":["any"]}]}}},"required":["stages"]}},"required":["type","params"]},"DataProductPolicyEvent":{"type":"object","properties":{"type":{"type":"string","enum":["dataProductPolicy"]}},"required":["type"]},"DataProductMaskingExceptionPolicy1":{"title":"Data Product Masking Exception Policy","type":"object","properties":{"version":{"description":"Policy schema version","type":"string"},"rules":{"type":"array","items":{"$ref":"#/components/schemas/RuleProperties"}},"defaultEvent":{"oneOf":[{"$ref":"#/components/schemas/ApproveEvent"},{"$ref":"#/components/schemas/ReviewEvent"}],"discriminator":{"propertyName":"type","mapping":{"approve":"#/components/schemas/ApproveEvent","review":"#/components/schemas/ReviewEvent"}}}},"required":["rules","defaultEvent"]},"DataObjectAsset":{"title":"Data Object Asset","type":"object","properties":{"id":{"oneOf":[{"type":"string","format":"cuid","pattern":"^[cC][^\\s-]{8,}$"},{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"}]},"name":{"description":"Asset name","type":"string","minLength":1},"type":{"type":"string","enum":["DATA_OBJECT"]},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"updatedBy":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$","description":"Immuta global user ID of the user who last updated the asset","nullable":true},"dagTagId":{"type":"number","nullable":true},"requestId":{"description":"If requested, the ID of the access request for the asset","type":"string","format":"cuid","pattern":"^[cC][^\\s-]{8,}$"},"status":{"type":"string","enum":["APPROVED","CANCELED","DENIED","PENDING","NONE","PUBLISHER","REVOKED","EXPIRED"]},"metadata":{"description":"Data object asset metadata","type":"object","properties":{"subjectMatterExperts":{"default":[],"type":"array","items":{"type":"object","properties":{"id":{"description":"Immuta global user ID of the subject matter expert","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"},"username":{"type":"string"},"name":{"type":"string"}},"required":["id"]}},"objectPath":{"type":"array","items":{"type":"string"}},"technology":{"type":"string","enum":["Snowflake","PostgreSQL","Databricks","Phantom","Glue","MySQL","Teradata","MariaDB","Oracle","SQLServer","Trino","Redshift","BigQuery","Custom"]},"host":{"type":"string"},"port":{"type":"integer","minimum":1,"maximum":65535},"legacyType":{"type":"string"},"dataSourceId":{"type":"number"},"description":{"type":"string","nullable":true},"externalLink":{"type":"string","nullable":true}},"required":["objectPath"]},"registered":{"description":"Whether the asset has been registered","default":true,"type":"boolean"},"stats":{"$ref":"#/components/schemas/DataObjectAssetStats"}},"required":["id","name","type","metadata"]},"DataObjectAssetStats":{"description":"Data object asset statistics","title":"Data Object Asset Stats","type":"object","properties":{"dataSourceCount":{"description":"Count of data sources in the data object (from DAG)","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["dataSourceCount"]},"AugmentedZodDto":{"type":"object","properties":{"statusCode":{"type":"number"},"message":{"type":"string"},"error":{"type":"string"}},"required":["statusCode","message"]}}},"paths":{"/api/asset/{id}":{"put":{"description":"Update an existing asset by ID","operationId":"updateAsset","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateAssetDto"}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Asset"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AugmentedZodDto"}}}}},"summary":"Update asset by ID","tags":["Asset"]}}}}
```

## Partially update asset by ID

> Partially update an existing asset by ID. Only provided fields will be updated. Use null to clear request forms or review flows.

```json
{"openapi":"3.0.0","info":{"title":"Immuta Data Marketplace","version":"1.0"},"tags":[{"name":"Asset","description":"APIs for managing assets"}],"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":{"PatchAssetDto":{"title":"Patch Asset","oneOf":[{"$ref":"#/components/schemas/PatchAssetDataProduct"},{"$ref":"#/components/schemas/PatchAssetDataObject"}],"discriminator":{"propertyName":"type","mapping":{"DATA_PRODUCT":"#/components/schemas/PatchAssetDataProduct","DATA_OBJECT":"#/components/schemas/PatchAssetDataObject"}}},"PatchAssetDataProduct":{"title":"Patch Data Product Asset","type":"object","properties":{"type":{"type":"string","enum":["DATA_PRODUCT"]},"name":{"description":"Asset name","type":"string","minLength":1},"description":{"type":"string","description":"Data product description","nullable":true},"subjectMatterExperts":{"type":"array","items":{"type":"object","properties":{"id":{"description":"Immuta global user ID of the subject matter expert","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"},"username":{"type":"string"},"name":{"type":"string"}},"required":["id"]}},"dataAccessRequestFormId":{"oneOf":[{"type":"string","format":"cuid","pattern":"^[cC][^\\s-]{8,}$"},{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"}]},"maskingExceptionRequestFormId":{"oneOf":[{"type":"string","format":"cuid","pattern":"^[cC][^\\s-]{8,}$"},{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"}]},"suspended":{"type":"boolean"},"dagTagId":{"type":"number"}},"required":["type"]},"PatchAssetDataObject":{"title":"Patch Data Object Asset","type":"object","properties":{"type":{"type":"string","enum":["DATA_OBJECT"]},"metadata":{"type":"object","properties":{"subjectMatterExperts":{"default":[],"type":"array","items":{"type":"object","properties":{"id":{"description":"Immuta global user ID of the subject matter expert","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"},"username":{"type":"string"},"name":{"type":"string"}},"required":["id"]}},"objectPath":{"type":"array","items":{"type":"string"}},"technology":{"type":"string","enum":["Snowflake","PostgreSQL","Databricks","Phantom","Glue","MySQL","Teradata","MariaDB","Oracle","SQLServer","Trino","Redshift","BigQuery","Custom"]},"legacyType":{"type":"string"},"dataSourceId":{"type":"number"},"description":{"type":"string","nullable":true},"externalLink":{"type":"string","nullable":true}}},"dataAccessRequestFormId":{"description":"Request form ID. If not provided, the asset will inherit from a parent asset.","nullable":true,"oneOf":[{"type":"string","format":"cuid","pattern":"^[cC][^\\s-]{8,}$"},{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"}]},"maskingExceptionRequestFormId":{"description":"Request form ID. If not provided, the asset will inherit from a parent asset.","nullable":true,"oneOf":[{"type":"string","format":"cuid","pattern":"^[cC][^\\s-]{8,}$"},{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"}]}},"required":["type"]},"Asset":{"title":"Asset","oneOf":[{"$ref":"#/components/schemas/DataProductAsset"},{"$ref":"#/components/schemas/DataObjectAsset"}],"discriminator":{"propertyName":"type","mapping":{"DATA_PRODUCT":"#/components/schemas/DataProductAsset","DATA_OBJECT":"#/components/schemas/DataObjectAsset"}}},"DataProductAsset":{"title":"Data Product Asset","type":"object","properties":{"id":{"oneOf":[{"type":"string","format":"cuid","pattern":"^[cC][^\\s-]{8,}$"},{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"}]},"name":{"description":"Asset name","type":"string","minLength":1},"type":{"type":"string","enum":["DATA_PRODUCT"]},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"updatedBy":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$","description":"Immuta global user ID of the user who last updated the data product","nullable":true},"dagTagId":{"type":"number","nullable":true},"requestId":{"description":"If requested, the ID of the access request for the data product","type":"string","format":"cuid","pattern":"^[cC][^\\s-]{8,}$"},"status":{"type":"string","enum":["APPROVED","CANCELED","DENIED","PENDING","NONE","PUBLISHER","REVOKED","EXPIRED"]},"description":{"type":"string","description":"Data product description","nullable":true},"domains":{"description":"Array of domain IDs associated with the data product","minItems":1,"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"}},"subjectMatterExperts":{"default":[],"type":"array","items":{"type":"object","properties":{"id":{"description":"Immuta global user ID of the subject matter expert","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"},"username":{"type":"string"},"name":{"type":"string"}},"required":["id"]}},"suspended":{"description":"Whether access to the data product's data sources is suspended","default":false,"type":"boolean"},"createdBy":{"description":"Immuta global user ID of the user who created the data product","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"},"expiration":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$","nullable":true},"stats":{"$ref":"#/components/schemas/DataProductStats1"},"dataAccessPolicy":{"$ref":"#/components/schemas/DataProductDataAccessPolicy1"},"maskingExceptionPolicy":{"$ref":"#/components/schemas/DataProductMaskingExceptionPolicy1"}},"required":["id","name","type","createdAt","updatedAt","domains","createdBy"]},"DataProductStats1":{"description":"Data product statistics","title":"Data Product Stats","type":"object","properties":{"dataSourceCount":{"description":"Count of data sources in a data product","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"pendingRequestCount":{"description":"Count of pending requests for a data product","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"approvedRequestCount":{"description":"Count of approved requests for a data product","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"revokedRequestCount":{"description":"Count of revoked requests for a data product","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"canceledRequestCount":{"description":"Count of canceled requests for a data product","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"deniedRequestCount":{"description":"Count of denied requests for a data product","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"expiredRequestCount":{"description":"Count of expired requests for a data product","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"totalRequestCount":{"description":"Count of total requests for a data product","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["dataSourceCount","pendingRequestCount","approvedRequestCount","revokedRequestCount","canceledRequestCount","deniedRequestCount","expiredRequestCount","totalRequestCount"]},"DataProductDataAccessPolicy1":{"title":"Data Product Data Access Policy","type":"object","properties":{"version":{"description":"Policy schema version","type":"string"},"rules":{"type":"array","items":{"$ref":"#/components/schemas/RuleProperties"}},"defaultEvent":{"oneOf":[{"$ref":"#/components/schemas/ApproveEvent"},{"$ref":"#/components/schemas/ReviewEvent"}],"discriminator":{"propertyName":"type","mapping":{"approve":"#/components/schemas/ApproveEvent","review":"#/components/schemas/ReviewEvent"}}}},"required":["rules","defaultEvent"]},"RuleProperties":{"type":"object","properties":{"conditions":{"oneOf":[{"$ref":"#/components/schemas/AllConditions"},{"$ref":"#/components/schemas/AnyConditions"},{"$ref":"#/components/schemas/NotConditions"}]},"event":{"$ref":"#/components/schemas/ReviewPolicyEvent"}},"required":["conditions","event"]},"AllConditions":{"type":"object","properties":{"all":{"type":"array","items":{}}},"required":["all"],"additionalProperties":false},"AnyConditions":{"type":"object","properties":{"any":{"type":"array","items":{}}},"required":["any"],"additionalProperties":false},"NotConditions":{"type":"object","properties":{"not":{}},"required":["not"],"additionalProperties":false},"ReviewPolicyEvent":{"oneOf":[{"$ref":"#/components/schemas/ApproveEvent"},{"$ref":"#/components/schemas/DenyEvent"},{"$ref":"#/components/schemas/ReviewEvent"},{"$ref":"#/components/schemas/DataProductPolicyEvent"}],"discriminator":{"propertyName":"type","mapping":{"approve":"#/components/schemas/ApproveEvent","deny":"#/components/schemas/DenyEvent","review":"#/components/schemas/ReviewEvent","dataProductPolicy":"#/components/schemas/DataProductPolicyEvent"}}},"ApproveEvent":{"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"]}}}},"required":["type","params"]},"DenyEvent":{"type":"object","properties":{"type":{"type":"string","enum":["deny"]},"params":{"type":"object","properties":{"comment":{"type":"string"}}}},"required":["type","params"]},"ReviewEvent":{"type":"object","properties":{"type":{"type":"string","enum":["review"]},"params":{"type":"object","properties":{"stages":{"description":"Array of stages for manual review","type":"array","items":{"oneOf":[{"type":"object","properties":{"all":{"minItems":1,"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"description":"Entity type","type":"string","enum":["USER"]},"id":{"description":"Entity ID","type":"string"},"displayName":{"description":"Entity display name","type":"string"}},"required":["type","id"]},{"type":"object","properties":{"type":{"description":"Entity type","type":"string","enum":["GROUP"]},"id":{"description":"Entity ID","type":"number"},"iamId":{"description":"IAM ID","type":"string"},"name":{"description":"Entity display name","type":"string"}},"required":["type","name"]},{"type":"object","properties":{"type":{"type":"string","enum":["PERMISSION"]},"permission":{"description":"Global permission","type":"string","enum":["GOVERNANCE","USER_ADMIN","AUDIT"]}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["DOMAIN PERMISSION"]},"permission":{"description":"Domain permission","type":"string","enum":["Manage Policies","Audit Activity","Manage Data Products","Manage Identifiers"]},"domainId":{"description":"Domain ID","type":"string"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["ATTRIBUTE"]},"key":{"description":"Attribute key","type":"string"},"value":{"description":"Attribute value","type":"string"}},"required":["type","key","value"]},{"type":"object","properties":{"type":{"type":"string","enum":["CATALOG PERMISSION"]}},"required":["type"]}]}}},"required":["all"]},{"type":"object","properties":{"any":{"minItems":1,"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"description":"Entity type","type":"string","enum":["USER"]},"id":{"description":"Entity ID","type":"string"},"displayName":{"description":"Entity display name","type":"string"}},"required":["type","id"]},{"type":"object","properties":{"type":{"description":"Entity type","type":"string","enum":["GROUP"]},"id":{"description":"Entity ID","type":"number"},"iamId":{"description":"IAM ID","type":"string"},"name":{"description":"Entity display name","type":"string"}},"required":["type","name"]},{"type":"object","properties":{"type":{"type":"string","enum":["PERMISSION"]},"permission":{"description":"Global permission","type":"string","enum":["GOVERNANCE","USER_ADMIN","AUDIT"]}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["DOMAIN PERMISSION"]},"permission":{"description":"Domain permission","type":"string","enum":["Manage Policies","Audit Activity","Manage Data Products","Manage Identifiers"]},"domainId":{"description":"Domain ID","type":"string"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["ATTRIBUTE"]},"key":{"description":"Attribute key","type":"string"},"value":{"description":"Attribute value","type":"string"}},"required":["type","key","value"]},{"type":"object","properties":{"type":{"type":"string","enum":["CATALOG PERMISSION"]}},"required":["type"]}]}}},"required":["any"]}]}}},"required":["stages"]}},"required":["type","params"]},"DataProductPolicyEvent":{"type":"object","properties":{"type":{"type":"string","enum":["dataProductPolicy"]}},"required":["type"]},"DataProductMaskingExceptionPolicy1":{"title":"Data Product Masking Exception Policy","type":"object","properties":{"version":{"description":"Policy schema version","type":"string"},"rules":{"type":"array","items":{"$ref":"#/components/schemas/RuleProperties"}},"defaultEvent":{"oneOf":[{"$ref":"#/components/schemas/ApproveEvent"},{"$ref":"#/components/schemas/ReviewEvent"}],"discriminator":{"propertyName":"type","mapping":{"approve":"#/components/schemas/ApproveEvent","review":"#/components/schemas/ReviewEvent"}}}},"required":["rules","defaultEvent"]},"DataObjectAsset":{"title":"Data Object Asset","type":"object","properties":{"id":{"oneOf":[{"type":"string","format":"cuid","pattern":"^[cC][^\\s-]{8,}$"},{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"}]},"name":{"description":"Asset name","type":"string","minLength":1},"type":{"type":"string","enum":["DATA_OBJECT"]},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"updatedBy":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$","description":"Immuta global user ID of the user who last updated the asset","nullable":true},"dagTagId":{"type":"number","nullable":true},"requestId":{"description":"If requested, the ID of the access request for the asset","type":"string","format":"cuid","pattern":"^[cC][^\\s-]{8,}$"},"status":{"type":"string","enum":["APPROVED","CANCELED","DENIED","PENDING","NONE","PUBLISHER","REVOKED","EXPIRED"]},"metadata":{"description":"Data object asset metadata","type":"object","properties":{"subjectMatterExperts":{"default":[],"type":"array","items":{"type":"object","properties":{"id":{"description":"Immuta global user ID of the subject matter expert","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"},"username":{"type":"string"},"name":{"type":"string"}},"required":["id"]}},"objectPath":{"type":"array","items":{"type":"string"}},"technology":{"type":"string","enum":["Snowflake","PostgreSQL","Databricks","Phantom","Glue","MySQL","Teradata","MariaDB","Oracle","SQLServer","Trino","Redshift","BigQuery","Custom"]},"host":{"type":"string"},"port":{"type":"integer","minimum":1,"maximum":65535},"legacyType":{"type":"string"},"dataSourceId":{"type":"number"},"description":{"type":"string","nullable":true},"externalLink":{"type":"string","nullable":true}},"required":["objectPath"]},"registered":{"description":"Whether the asset has been registered","default":true,"type":"boolean"},"stats":{"$ref":"#/components/schemas/DataObjectAssetStats"}},"required":["id","name","type","metadata"]},"DataObjectAssetStats":{"description":"Data object asset statistics","title":"Data Object Asset Stats","type":"object","properties":{"dataSourceCount":{"description":"Count of data sources in the data object (from DAG)","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["dataSourceCount"]},"AugmentedZodDto":{"type":"object","properties":{"statusCode":{"type":"number"},"message":{"type":"string"},"error":{"type":"string"}},"required":["statusCode","message"]}}},"paths":{"/api/asset/{id}":{"patch":{"description":"Partially update an existing asset by ID. Only provided fields will be updated. Use null to clear request forms or review flows.","operationId":"patchAsset","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PatchAssetDto"}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Asset"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AugmentedZodDto"}}}}},"summary":"Partially update asset by ID","tags":["Asset"]}}}}
```

## Get request forms for an asset

> Get the request forms assigned to the asset.

```json
{"openapi":"3.0.0","info":{"title":"Immuta Data Marketplace","version":"1.0"},"tags":[{"name":"Request Form","description":"APIs for managing request forms"},{"name":"Asset","description":"APIs for managing assets"}],"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":{"AssetRequestForms":{"type":"object","properties":{"dataAccessForm":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"},"name":{"type":"string"},"fields":{"title":"RequestFormFields","type":"array","items":{"$ref":"#/components/schemas/RequestFormField"}},"policy":{"type":"object","properties":{"version":{"description":"Policy schema version","type":"string"},"rules":{"type":"array","items":{"$ref":"#/components/schemas/RuleProperties"}},"defaultEvent":{"$ref":"#/components/schemas/ReviewPolicyEvent"}},"required":["rules","defaultEvent"]},"dataUseAgreements":{"title":"Request Form Data Use Agreements","default":[],"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"},"name":{"description":"The name of data use agreement","type":"string"},"body":{"description":"The contents of data use agreement","type":"string"}},"required":["id","name","body"]}},"createdBy":{"description":"The user who originally created the request form","type":"object","properties":{"globalUserId":{"description":"Immuta global user ID","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"},"name":{"description":"Display name","type":"string"}},"required":["globalUserId","name"]},"createdAt":{"description":"The date when the request form was originally created","type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"updatedBy":{"description":"The user who last updated the request form","type":"object","properties":{"globalUserId":{"description":"Immuta global user ID","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"},"name":{"description":"Display name","type":"string"}},"required":["globalUserId","name"]},"updatedAt":{"description":"The date when the request form was last updated","type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"version":{"description":"The current version of the request form","type":"string","format":"cuid","pattern":"^[cC][^\\s-]{8,}$"},"inheritedFrom":{"$ref":"#/components/schemas/DataObjectAsset"},"requestType":{"type":"string","enum":["DATA_ACCESS","MASKING_EXCEPTION"]}},"required":["id","name","fields","policy","createdBy","createdAt","updatedBy","updatedAt","version","requestType"]},"maskingExceptionForm":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"},"name":{"type":"string"},"fields":{"title":"RequestFormFields","type":"array","items":{"$ref":"#/components/schemas/RequestFormField"}},"policy":{"type":"object","properties":{"version":{"description":"Policy schema version","type":"string"},"rules":{"type":"array","items":{"$ref":"#/components/schemas/RuleProperties"}},"defaultEvent":{"$ref":"#/components/schemas/ReviewPolicyEvent"}},"required":["rules","defaultEvent"]},"dataUseAgreements":{"title":"Request Form Data Use Agreements","default":[],"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"},"name":{"description":"The name of data use agreement","type":"string"},"body":{"description":"The contents of data use agreement","type":"string"}},"required":["id","name","body"]}},"createdBy":{"description":"The user who originally created the request form","type":"object","properties":{"globalUserId":{"description":"Immuta global user ID","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"},"name":{"description":"Display name","type":"string"}},"required":["globalUserId","name"]},"createdAt":{"description":"The date when the request form was originally created","type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"updatedBy":{"description":"The user who last updated the request form","type":"object","properties":{"globalUserId":{"description":"Immuta global user ID","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"},"name":{"description":"Display name","type":"string"}},"required":["globalUserId","name"]},"updatedAt":{"description":"The date when the request form was last updated","type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"version":{"description":"The current version of the request form","type":"string","format":"cuid","pattern":"^[cC][^\\s-]{8,}$"},"inheritedFrom":{"$ref":"#/components/schemas/DataObjectAsset"},"requestType":{"type":"string","enum":["DATA_ACCESS","MASKING_EXCEPTION"]}},"required":["id","name","fields","policy","createdBy","createdAt","updatedBy","updatedAt","version","requestType"]}}},"RequestFormField":{"oneOf":[{"$ref":"#/components/schemas/SelectionFormField"},{"$ref":"#/components/schemas/ShortAnswerFormField"},{"$ref":"#/components/schemas/AccessDurationFormField"}],"discriminator":{"propertyName":"type","mapping":{"DROPDOWN":"#/components/schemas/SelectionFormField","CHECKBOXES":"#/components/schemas/SelectionFormField","SHORT_ANSWER":"#/components/schemas/ShortAnswerFormField","ACCESS_DURATION":"#/components/schemas/AccessDurationFormField"}}},"SelectionFormField":{"title":"Selection Form Field","type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"},"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"]},"ShortAnswerFormField":{"title":"Short Answer Form Field","type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"},"type":{"type":"string","enum":["SHORT_ANSWER"]},"label":{"type":"string"},"required":{"default":true,"type":"boolean"}},"required":["id","type","label"]},"AccessDurationFormField":{"title":"Access Duration Form Field","type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"},"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"]},"RuleProperties":{"type":"object","properties":{"conditions":{"oneOf":[{"$ref":"#/components/schemas/AllConditions"},{"$ref":"#/components/schemas/AnyConditions"},{"$ref":"#/components/schemas/NotConditions"}]},"event":{"$ref":"#/components/schemas/ReviewPolicyEvent"}},"required":["conditions","event"]},"AllConditions":{"type":"object","properties":{"all":{"type":"array","items":{}}},"required":["all"],"additionalProperties":false},"AnyConditions":{"type":"object","properties":{"any":{"type":"array","items":{}}},"required":["any"],"additionalProperties":false},"NotConditions":{"type":"object","properties":{"not":{}},"required":["not"],"additionalProperties":false},"ReviewPolicyEvent":{"oneOf":[{"$ref":"#/components/schemas/ApproveEvent"},{"$ref":"#/components/schemas/DenyEvent"},{"$ref":"#/components/schemas/ReviewEvent"},{"$ref":"#/components/schemas/DataProductPolicyEvent"}],"discriminator":{"propertyName":"type","mapping":{"approve":"#/components/schemas/ApproveEvent","deny":"#/components/schemas/DenyEvent","review":"#/components/schemas/ReviewEvent","dataProductPolicy":"#/components/schemas/DataProductPolicyEvent"}}},"ApproveEvent":{"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"]}}}},"required":["type","params"]},"DenyEvent":{"type":"object","properties":{"type":{"type":"string","enum":["deny"]},"params":{"type":"object","properties":{"comment":{"type":"string"}}}},"required":["type","params"]},"ReviewEvent":{"type":"object","properties":{"type":{"type":"string","enum":["review"]},"params":{"type":"object","properties":{"stages":{"description":"Array of stages for manual review","type":"array","items":{"oneOf":[{"type":"object","properties":{"all":{"minItems":1,"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"description":"Entity type","type":"string","enum":["USER"]},"id":{"description":"Entity ID","type":"string"},"displayName":{"description":"Entity display name","type":"string"}},"required":["type","id"]},{"type":"object","properties":{"type":{"description":"Entity type","type":"string","enum":["GROUP"]},"id":{"description":"Entity ID","type":"number"},"iamId":{"description":"IAM ID","type":"string"},"name":{"description":"Entity display name","type":"string"}},"required":["type","name"]},{"type":"object","properties":{"type":{"type":"string","enum":["PERMISSION"]},"permission":{"description":"Global permission","type":"string","enum":["GOVERNANCE","USER_ADMIN","AUDIT"]}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["DOMAIN PERMISSION"]},"permission":{"description":"Domain permission","type":"string","enum":["Manage Policies","Audit Activity","Manage Data Products","Manage Identifiers"]},"domainId":{"description":"Domain ID","type":"string"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["ATTRIBUTE"]},"key":{"description":"Attribute key","type":"string"},"value":{"description":"Attribute value","type":"string"}},"required":["type","key","value"]},{"type":"object","properties":{"type":{"type":"string","enum":["CATALOG PERMISSION"]}},"required":["type"]}]}}},"required":["all"]},{"type":"object","properties":{"any":{"minItems":1,"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"description":"Entity type","type":"string","enum":["USER"]},"id":{"description":"Entity ID","type":"string"},"displayName":{"description":"Entity display name","type":"string"}},"required":["type","id"]},{"type":"object","properties":{"type":{"description":"Entity type","type":"string","enum":["GROUP"]},"id":{"description":"Entity ID","type":"number"},"iamId":{"description":"IAM ID","type":"string"},"name":{"description":"Entity display name","type":"string"}},"required":["type","name"]},{"type":"object","properties":{"type":{"type":"string","enum":["PERMISSION"]},"permission":{"description":"Global permission","type":"string","enum":["GOVERNANCE","USER_ADMIN","AUDIT"]}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["DOMAIN PERMISSION"]},"permission":{"description":"Domain permission","type":"string","enum":["Manage Policies","Audit Activity","Manage Data Products","Manage Identifiers"]},"domainId":{"description":"Domain ID","type":"string"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["ATTRIBUTE"]},"key":{"description":"Attribute key","type":"string"},"value":{"description":"Attribute value","type":"string"}},"required":["type","key","value"]},{"type":"object","properties":{"type":{"type":"string","enum":["CATALOG PERMISSION"]}},"required":["type"]}]}}},"required":["any"]}]}}},"required":["stages"]}},"required":["type","params"]},"DataProductPolicyEvent":{"type":"object","properties":{"type":{"type":"string","enum":["dataProductPolicy"]}},"required":["type"]},"DataObjectAsset":{"title":"Data Object Asset","type":"object","properties":{"id":{"oneOf":[{"type":"string","format":"cuid","pattern":"^[cC][^\\s-]{8,}$"},{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"}]},"name":{"description":"Asset name","type":"string","minLength":1},"type":{"type":"string","enum":["DATA_OBJECT"]},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"updatedBy":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$","description":"Immuta global user ID of the user who last updated the asset","nullable":true},"dagTagId":{"type":"number","nullable":true},"requestId":{"description":"If requested, the ID of the access request for the asset","type":"string","format":"cuid","pattern":"^[cC][^\\s-]{8,}$"},"status":{"type":"string","enum":["APPROVED","CANCELED","DENIED","PENDING","NONE","PUBLISHER","REVOKED","EXPIRED"]},"metadata":{"description":"Data object asset metadata","type":"object","properties":{"subjectMatterExperts":{"default":[],"type":"array","items":{"type":"object","properties":{"id":{"description":"Immuta global user ID of the subject matter expert","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"},"username":{"type":"string"},"name":{"type":"string"}},"required":["id"]}},"objectPath":{"type":"array","items":{"type":"string"}},"technology":{"type":"string","enum":["Snowflake","PostgreSQL","Databricks","Phantom","Glue","MySQL","Teradata","MariaDB","Oracle","SQLServer","Trino","Redshift","BigQuery","Custom"]},"host":{"type":"string"},"port":{"type":"integer","minimum":1,"maximum":65535},"legacyType":{"type":"string"},"dataSourceId":{"type":"number"},"description":{"type":"string","nullable":true},"externalLink":{"type":"string","nullable":true}},"required":["objectPath"]},"registered":{"description":"Whether the asset has been registered","default":true,"type":"boolean"},"stats":{"$ref":"#/components/schemas/DataObjectAssetStats"}},"required":["id","name","type","metadata"]},"DataObjectAssetStats":{"description":"Data object asset statistics","title":"Data Object Asset Stats","type":"object","properties":{"dataSourceCount":{"description":"Count of data sources in the data object (from DAG)","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["dataSourceCount"]},"AugmentedZodDto":{"type":"object","properties":{"statusCode":{"type":"number"},"message":{"type":"string"},"error":{"type":"string"}},"required":["statusCode","message"]}}},"paths":{"/api/asset/{id}/request-forms":{"get":{"description":"Get the request forms assigned to the asset.","operationId":"getAssetRequestForms","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetRequestForms"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AugmentedZodDto"}}}}},"summary":"Get request forms for an asset","tags":["Asset","Request Form"]}}}}
```

## Get review flows for an asset

> Get the review flows configured for the asset.

```json
{"openapi":"3.0.0","info":{"title":"Immuta Data Marketplace","version":"1.0"},"tags":[{"name":"Asset","description":"APIs for managing assets"}],"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":{"AssetReviewFlows":{"type":"object","properties":{"dataAccessReviewFlow":{"$ref":"#/components/schemas/AssetReviewFlowWithInheritance"},"maskingExceptionReviewFlow":{"$ref":"#/components/schemas/AssetReviewFlowWithInheritance"}},"required":["dataAccessReviewFlow"]},"AssetReviewFlowWithInheritance":{"title":"Asset Review Flow With Inheritance","type":"object","properties":{"version":{"description":"Policy schema version","type":"string"},"rules":{"type":"array","items":{"$ref":"#/components/schemas/RuleProperties"}},"defaultEvent":{"oneOf":[{"$ref":"#/components/schemas/ApproveEvent"},{"$ref":"#/components/schemas/ReviewEvent"}],"discriminator":{"propertyName":"type","mapping":{"approve":"#/components/schemas/ApproveEvent","review":"#/components/schemas/ReviewEvent"}}},"inheritedFrom":{"$ref":"#/components/schemas/Asset"}},"required":["rules","defaultEvent"]},"RuleProperties":{"type":"object","properties":{"conditions":{"oneOf":[{"$ref":"#/components/schemas/AllConditions"},{"$ref":"#/components/schemas/AnyConditions"},{"$ref":"#/components/schemas/NotConditions"}]},"event":{"$ref":"#/components/schemas/ReviewPolicyEvent"}},"required":["conditions","event"]},"AllConditions":{"type":"object","properties":{"all":{"type":"array","items":{}}},"required":["all"],"additionalProperties":false},"AnyConditions":{"type":"object","properties":{"any":{"type":"array","items":{}}},"required":["any"],"additionalProperties":false},"NotConditions":{"type":"object","properties":{"not":{}},"required":["not"],"additionalProperties":false},"ReviewPolicyEvent":{"oneOf":[{"$ref":"#/components/schemas/ApproveEvent"},{"$ref":"#/components/schemas/DenyEvent"},{"$ref":"#/components/schemas/ReviewEvent"},{"$ref":"#/components/schemas/DataProductPolicyEvent"}],"discriminator":{"propertyName":"type","mapping":{"approve":"#/components/schemas/ApproveEvent","deny":"#/components/schemas/DenyEvent","review":"#/components/schemas/ReviewEvent","dataProductPolicy":"#/components/schemas/DataProductPolicyEvent"}}},"ApproveEvent":{"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"]}}}},"required":["type","params"]},"DenyEvent":{"type":"object","properties":{"type":{"type":"string","enum":["deny"]},"params":{"type":"object","properties":{"comment":{"type":"string"}}}},"required":["type","params"]},"ReviewEvent":{"type":"object","properties":{"type":{"type":"string","enum":["review"]},"params":{"type":"object","properties":{"stages":{"description":"Array of stages for manual review","type":"array","items":{"oneOf":[{"type":"object","properties":{"all":{"minItems":1,"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"description":"Entity type","type":"string","enum":["USER"]},"id":{"description":"Entity ID","type":"string"},"displayName":{"description":"Entity display name","type":"string"}},"required":["type","id"]},{"type":"object","properties":{"type":{"description":"Entity type","type":"string","enum":["GROUP"]},"id":{"description":"Entity ID","type":"number"},"iamId":{"description":"IAM ID","type":"string"},"name":{"description":"Entity display name","type":"string"}},"required":["type","name"]},{"type":"object","properties":{"type":{"type":"string","enum":["PERMISSION"]},"permission":{"description":"Global permission","type":"string","enum":["GOVERNANCE","USER_ADMIN","AUDIT"]}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["DOMAIN PERMISSION"]},"permission":{"description":"Domain permission","type":"string","enum":["Manage Policies","Audit Activity","Manage Data Products","Manage Identifiers"]},"domainId":{"description":"Domain ID","type":"string"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["ATTRIBUTE"]},"key":{"description":"Attribute key","type":"string"},"value":{"description":"Attribute value","type":"string"}},"required":["type","key","value"]},{"type":"object","properties":{"type":{"type":"string","enum":["CATALOG PERMISSION"]}},"required":["type"]}]}}},"required":["all"]},{"type":"object","properties":{"any":{"minItems":1,"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"description":"Entity type","type":"string","enum":["USER"]},"id":{"description":"Entity ID","type":"string"},"displayName":{"description":"Entity display name","type":"string"}},"required":["type","id"]},{"type":"object","properties":{"type":{"description":"Entity type","type":"string","enum":["GROUP"]},"id":{"description":"Entity ID","type":"number"},"iamId":{"description":"IAM ID","type":"string"},"name":{"description":"Entity display name","type":"string"}},"required":["type","name"]},{"type":"object","properties":{"type":{"type":"string","enum":["PERMISSION"]},"permission":{"description":"Global permission","type":"string","enum":["GOVERNANCE","USER_ADMIN","AUDIT"]}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["DOMAIN PERMISSION"]},"permission":{"description":"Domain permission","type":"string","enum":["Manage Policies","Audit Activity","Manage Data Products","Manage Identifiers"]},"domainId":{"description":"Domain ID","type":"string"}},"required":["type","permission"]},{"type":"object","properties":{"type":{"type":"string","enum":["ATTRIBUTE"]},"key":{"description":"Attribute key","type":"string"},"value":{"description":"Attribute value","type":"string"}},"required":["type","key","value"]},{"type":"object","properties":{"type":{"type":"string","enum":["CATALOG PERMISSION"]}},"required":["type"]}]}}},"required":["any"]}]}}},"required":["stages"]}},"required":["type","params"]},"DataProductPolicyEvent":{"type":"object","properties":{"type":{"type":"string","enum":["dataProductPolicy"]}},"required":["type"]},"Asset":{"title":"Asset","oneOf":[{"$ref":"#/components/schemas/DataProductAsset"},{"$ref":"#/components/schemas/DataObjectAsset"}],"discriminator":{"propertyName":"type","mapping":{"DATA_PRODUCT":"#/components/schemas/DataProductAsset","DATA_OBJECT":"#/components/schemas/DataObjectAsset"}}},"DataProductAsset":{"title":"Data Product Asset","type":"object","properties":{"id":{"oneOf":[{"type":"string","format":"cuid","pattern":"^[cC][^\\s-]{8,}$"},{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"}]},"name":{"description":"Asset name","type":"string","minLength":1},"type":{"type":"string","enum":["DATA_PRODUCT"]},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"updatedBy":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$","description":"Immuta global user ID of the user who last updated the data product","nullable":true},"dagTagId":{"type":"number","nullable":true},"requestId":{"description":"If requested, the ID of the access request for the data product","type":"string","format":"cuid","pattern":"^[cC][^\\s-]{8,}$"},"status":{"type":"string","enum":["APPROVED","CANCELED","DENIED","PENDING","NONE","PUBLISHER","REVOKED","EXPIRED"]},"description":{"type":"string","description":"Data product description","nullable":true},"domains":{"description":"Array of domain IDs associated with the data product","minItems":1,"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"}},"subjectMatterExperts":{"default":[],"type":"array","items":{"type":"object","properties":{"id":{"description":"Immuta global user ID of the subject matter expert","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"},"username":{"type":"string"},"name":{"type":"string"}},"required":["id"]}},"suspended":{"description":"Whether access to the data product's data sources is suspended","default":false,"type":"boolean"},"createdBy":{"description":"Immuta global user ID of the user who created the data product","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"},"expiration":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$","nullable":true},"stats":{"$ref":"#/components/schemas/DataProductStats1"},"dataAccessPolicy":{"$ref":"#/components/schemas/DataProductDataAccessPolicy1"},"maskingExceptionPolicy":{"$ref":"#/components/schemas/DataProductMaskingExceptionPolicy1"}},"required":["id","name","type","createdAt","updatedAt","domains","createdBy"]},"DataProductStats1":{"description":"Data product statistics","title":"Data Product Stats","type":"object","properties":{"dataSourceCount":{"description":"Count of data sources in a data product","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"pendingRequestCount":{"description":"Count of pending requests for a data product","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"approvedRequestCount":{"description":"Count of approved requests for a data product","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"revokedRequestCount":{"description":"Count of revoked requests for a data product","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"canceledRequestCount":{"description":"Count of canceled requests for a data product","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"deniedRequestCount":{"description":"Count of denied requests for a data product","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"expiredRequestCount":{"description":"Count of expired requests for a data product","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"totalRequestCount":{"description":"Count of total requests for a data product","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["dataSourceCount","pendingRequestCount","approvedRequestCount","revokedRequestCount","canceledRequestCount","deniedRequestCount","expiredRequestCount","totalRequestCount"]},"DataProductDataAccessPolicy1":{"title":"Data Product Data Access Policy","type":"object","properties":{"version":{"description":"Policy schema version","type":"string"},"rules":{"type":"array","items":{"$ref":"#/components/schemas/RuleProperties"}},"defaultEvent":{"oneOf":[{"$ref":"#/components/schemas/ApproveEvent"},{"$ref":"#/components/schemas/ReviewEvent"}],"discriminator":{"propertyName":"type","mapping":{"approve":"#/components/schemas/ApproveEvent","review":"#/components/schemas/ReviewEvent"}}}},"required":["rules","defaultEvent"]},"DataProductMaskingExceptionPolicy1":{"title":"Data Product Masking Exception Policy","type":"object","properties":{"version":{"description":"Policy schema version","type":"string"},"rules":{"type":"array","items":{"$ref":"#/components/schemas/RuleProperties"}},"defaultEvent":{"oneOf":[{"$ref":"#/components/schemas/ApproveEvent"},{"$ref":"#/components/schemas/ReviewEvent"}],"discriminator":{"propertyName":"type","mapping":{"approve":"#/components/schemas/ApproveEvent","review":"#/components/schemas/ReviewEvent"}}}},"required":["rules","defaultEvent"]},"DataObjectAsset":{"title":"Data Object Asset","type":"object","properties":{"id":{"oneOf":[{"type":"string","format":"cuid","pattern":"^[cC][^\\s-]{8,}$"},{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"}]},"name":{"description":"Asset name","type":"string","minLength":1},"type":{"type":"string","enum":["DATA_OBJECT"]},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"updatedBy":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$","description":"Immuta global user ID of the user who last updated the asset","nullable":true},"dagTagId":{"type":"number","nullable":true},"requestId":{"description":"If requested, the ID of the access request for the asset","type":"string","format":"cuid","pattern":"^[cC][^\\s-]{8,}$"},"status":{"type":"string","enum":["APPROVED","CANCELED","DENIED","PENDING","NONE","PUBLISHER","REVOKED","EXPIRED"]},"metadata":{"description":"Data object asset metadata","type":"object","properties":{"subjectMatterExperts":{"default":[],"type":"array","items":{"type":"object","properties":{"id":{"description":"Immuta global user ID of the subject matter expert","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"},"username":{"type":"string"},"name":{"type":"string"}},"required":["id"]}},"objectPath":{"type":"array","items":{"type":"string"}},"technology":{"type":"string","enum":["Snowflake","PostgreSQL","Databricks","Phantom","Glue","MySQL","Teradata","MariaDB","Oracle","SQLServer","Trino","Redshift","BigQuery","Custom"]},"host":{"type":"string"},"port":{"type":"integer","minimum":1,"maximum":65535},"legacyType":{"type":"string"},"dataSourceId":{"type":"number"},"description":{"type":"string","nullable":true},"externalLink":{"type":"string","nullable":true}},"required":["objectPath"]},"registered":{"description":"Whether the asset has been registered","default":true,"type":"boolean"},"stats":{"$ref":"#/components/schemas/DataObjectAssetStats"}},"required":["id","name","type","metadata"]},"DataObjectAssetStats":{"description":"Data object asset statistics","title":"Data Object Asset Stats","type":"object","properties":{"dataSourceCount":{"description":"Count of data sources in the data object (from DAG)","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["dataSourceCount"]},"AugmentedZodDto":{"type":"object","properties":{"statusCode":{"type":"number"},"message":{"type":"string"},"error":{"type":"string"}},"required":["statusCode","message"]}}},"paths":{"/api/asset/{id}/review-flows":{"get":{"description":"Get the review flows configured for the asset.","operationId":"getAssetReviewFlows","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetReviewFlows"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AugmentedZodDto"}}}}},"summary":"Get review flows for an asset","tags":["Asset"]}}}}
```

## Request access or masking exception for an asset

> Create a new access or masking exception request for the specified asset.

```json
{"openapi":"3.0.0","info":{"title":"Immuta Data Marketplace","version":"1.0"},"tags":[{"name":"Asset","description":"APIs for managing assets"}],"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":{"CreateAssetRequestDto":{"description":"Payload for creating a request to an asset.","oneOf":[{"$ref":"#/components/schemas/CreateAssetDataAccessRequest"},{"$ref":"#/components/schemas/CreateAssetMaskingExceptionRequest"}],"discriminator":{"propertyName":"requestType","mapping":{"DATA_ACCESS":"#/components/schemas/CreateAssetDataAccessRequest","MASKING_EXCEPTION":"#/components/schemas/CreateAssetMaskingExceptionRequest"}}},"CreateAssetDataAccessRequest":{"title":"Create Data Access Request","type":"object","properties":{"user":{"description":"Immuta global user ID of the user for whom access is being requested","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"},"form":{"description":"The request form submission"},"requestType":{"type":"string","enum":["DATA_ACCESS"]}},"required":["user","requestType"]},"CreateAssetMaskingExceptionRequest":{"title":"Create Masking Exception Request","type":"object","properties":{"user":{"description":"Immuta global user ID of the user for whom access is being requested","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"},"form":{"description":"The request form submission"},"requestType":{"type":"string","enum":["MASKING_EXCEPTION"]},"columns":{"description":"List of columns to request masking exception for","type":"array","items":{"description":"Column in the data source to request masking exception for","type":"object","properties":{"columnName":{"description":"The name of the column to request masking exception for","type":"string"},"sourceId":{"description":"The ID of the data source this column belongs to","type":"string"}},"required":["columnName","sourceId"]}}},"required":["user","requestType","columns"]},"HydratedAccessRequest":{"title":"Hydrated Access Request","description":"Access request with user and data product metadata","type":"object","properties":{"id":{"type":"string","format":"cuid","pattern":"^[cC][^\\s-]{8,}$"},"requestingUser":{"$ref":"#/components/schemas/ImmutaUser"},"user":{"$ref":"#/components/schemas/ImmutaUser"},"formVersion":{"type":"string","nullable":true},"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":{"description":"When the temporary access will expire","type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"dataProduct":{"type":"object","properties":{"id":{"oneOf":[{"type":"string","format":"cuid","pattern":"^[cC][^\\s-]{8,}$"},{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"}]},"name":{"description":"Data product name","type":"string","minLength":1,"maxLength":255,"pattern":"^[\\p{L}\\p{M}\\p{N})(\\-_/\\\\\\s]*$"},"description":{"type":"string","description":"Data product description","nullable":true}},"required":["id","name"]},"asset":{"type":"object","properties":{"id":{"oneOf":[{"type":"string","format":"cuid","pattern":"^[cC][^\\s-]{8,}$"},{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"}]},"type":{"type":"string","enum":["DATA_OBJECT"]},"name":{"description":"Asset name","type":"string","minLength":1},"metadata":{"description":"Data object asset metadata","type":"object","properties":{"subjectMatterExperts":{"default":[],"type":"array","items":{"type":"object","properties":{"id":{"description":"Immuta global user ID of the subject matter expert","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"},"username":{"type":"string"},"name":{"type":"string"}},"required":["id"]}},"objectPath":{"type":"array","items":{"type":"string"}},"technology":{"type":"string","enum":["Snowflake","PostgreSQL","Databricks","Phantom","Glue","MySQL","Teradata","MariaDB","Oracle","SQLServer","Trino","Redshift","BigQuery","Custom"]},"host":{"type":"string"},"port":{"type":"integer","minimum":1,"maximum":65535},"legacyType":{"type":"string"},"dataSourceId":{"type":"number"},"description":{"type":"string","nullable":true},"externalLink":{"type":"string","nullable":true}},"required":["objectPath"]}},"required":["id","type","name","metadata"]},"isProcessing":{"description":"Whether the request is still processing","type":"boolean"}},"required":["id","requestingUser","user","type","status","createdAt","updatedAt","isProcessing"]},"ImmutaUser":{"title":"Immuta User","type":"object","properties":{"id":{"type":"number"},"iamId":{"description":"ID of the IAM the user is associated with","type":"string"},"globalUserId":{"description":"Immuta global user ID","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"},"trackingId":{"type":"string"},"username":{"description":"Username/login name for the user","type":"string"},"name":{"description":"Display name","type":"string"},"email":{"type":"string","description":"Email address","nullable":true},"authorizations":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}}},"required":["id","iamId","globalUserId","username","name"]},"AugmentedZodDto":{"type":"object","properties":{"statusCode":{"type":"number"},"message":{"type":"string"},"error":{"type":"string"}},"required":["statusCode","message"]}}},"paths":{"/api/asset/{id}/request":{"post":{"description":"Create a new access or masking exception request for the specified asset.","operationId":"requestAsset","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateAssetRequestDto"}}}},"responses":{"201":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HydratedAccessRequest"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AugmentedZodDto"}}}}},"summary":"Request access or masking exception for an asset","tags":["Asset"]}}}}
```

## Revoke access to an asset

> Updates the specified access request to revoked and revokes access to data source(s) associated with the asset.

```json
{"openapi":"3.0.0","info":{"title":"Immuta Data Marketplace","version":"1.0"},"tags":[{"name":"Access Request","description":"APIs for managing data access"},{"name":"Asset","description":"APIs for managing assets"}],"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":{"AugmentedZodDto":{"type":"object","properties":{"statusCode":{"type":"number"},"message":{"type":"string"},"error":{"type":"string"}},"required":["statusCode","message"]}}},"paths":{"/api/asset/{id}/request/{requestId}":{"delete":{"description":"Updates the specified access request to revoked and revokes access to data source(s) associated with the asset.","operationId":"revokeAssetRequest","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"requestId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"204":{"description":""},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AugmentedZodDto"}}}}},"summary":"Revoke access to an asset","tags":["Asset","Access Request"]}}}}
```

## 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":"Asset","description":"APIs for managing assets"}],"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","pattern":"^[cC][^\\s-]{8,}$"},"requestingUser":{"$ref":"#/components/schemas/ImmutaUser"},"user":{"$ref":"#/components/schemas/ImmutaUser"},"actionBy":{"allOf":[{"$ref":"#/components/schemas/ImmutaUser"}],"nullable":true},"reason":{"type":"string"},"status":{"type":"string","enum":["APPROVED","BLOCKED","CANCELED","DENIED","PENDING"]},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"expiration":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"}},"required":["id","requestingUser","user","actionBy","status","createdAt","updatedAt"]}}},"required":["determinations"],"title":"Recent Data Product Manual Determinations"},"ImmutaUser":{"title":"Immuta User","type":"object","properties":{"id":{"type":"number"},"iamId":{"description":"ID of the IAM the user is associated with","type":"string"},"globalUserId":{"description":"Immuta global user ID","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"},"trackingId":{"type":"string"},"username":{"description":"Username/login name for the user","type":"string"},"name":{"description":"Display name","type":"string"},"email":{"type":"string","description":"Email address","nullable":true},"authorizations":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}}},"required":["id","iamId","globalUserId","username","name"]},"AugmentedZodDto":{"type":"object","properties":{"statusCode":{"type":"number"},"message":{"type":"string"},"error":{"type":"string"}},"required":["statusCode","message"]}}},"paths":{"/api/asset/{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":"RecentAssetDeterminations","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"}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AugmentedZodDto"}}}}},"summary":"Returns 5 most recent manual access determinations","tags":["Asset"]}}}}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://documentation.immuta.com/saas/developer-guides/api-intro/marketplace-api/asset.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.