# Assets

The Assets API allows you to search, retrieve, and update data assets within your Decube organization. Use these endpoints to automate asset discovery, manage metadata, and integrate asset information into your data workflows and applications.

## Search Assets

> Search assets with optional filters for type, parent, tags, classifications, and owners. Returns paginated results matching the specified criteria.

```json
{"openapi":"3.1.0","info":{"title":"Decube Public API (BETA)","version":"1.0.0"},"servers":[{"url":"https://connect.<REGION>.decube.io/api/v1/data"}],"paths":{"/assets/search":{"post":{"tags":["Assets"],"summary":"Search Assets","description":"Search assets with optional filters for type, parent, tags, classifications, and owners. Returns paginated results matching the specified criteria.","operationId":"search_assets_assets_search_post","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchAssetsBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetList"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"SearchAssetsBody":{"properties":{"query":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Query","description":"Search term to match against"},"search_type":{"type":"string","enum":["exact","fuzzy"],"title":"Search Type","description":"Type of search to perform. For exact searches, this is matched approximately against the name field. For fuzzy searches, this is matched exactly against relevant fields.","default":"exact"},"asset_type":{"anyOf":[{"type":"string","enum":["source","collection","dataset","property","dashboard","chart","data_job","data_task","policy","glossary","category","term"]},{"type":"null"}],"title":"Asset Type","description":"Filter results to specific asset types only"},"parent":{"anyOf":[{"$ref":"#/components/schemas/ParentAssetIdentifier"},{"type":"null"}],"description":"Filter assets that belong to a specific parent asset"},"tags":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Tags","description":"Filter assets with any of the specified tag names"},"classifications":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Classifications","description":"Filter assets with any of the specified policy tags"},"data_owners":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Data Owners","description":"Filter assets owned by any of the specified data owners by email"},"business_owners":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Business Owners","description":"Filter assets owned by any of the specified business owners by email"},"custom_attributes":{"anyOf":[{"items":{"anyOf":[{"$ref":"#/components/schemas/BooleanAttributeFilter"},{"$ref":"#/components/schemas/TextAttributeFilter"},{"$ref":"#/components/schemas/IntegerAttributeFilter"},{"$ref":"#/components/schemas/EnumAttributeFilter"},{"$ref":"#/components/schemas/UserAttributeFilter"}]},"type":"array"},{"type":"null"}],"title":"Custom Attributes","description":"Filter assets with any of the specified custom attributes"},"show_deleted":{"type":"boolean","title":"Show Deleted","description":"Include deleted assets in the results","default":false},"page":{"type":"integer","minimum":1,"title":"Page","default":1},"page_size":{"type":"integer","maximum":1000,"minimum":1,"title":"Page Size","default":10}},"type":"object","title":"SearchAssetsBody"},"ParentAssetIdentifier":{"properties":{"id":{"type":"integer","minimum":0,"title":"Id","description":"Unique identifier of the specific parent asset"},"type":{"type":"string","enum":["source","collection","dataset","property","dashboard","chart","data_job","data_task","policy","glossary","category","term"],"title":"Type","description":"Type of the specific parent asset"}},"type":"object","required":["id","type"],"title":"ParentAssetIdentifier"},"BooleanAttributeFilter":{"properties":{"config_id":{"type":"integer","title":"Config Id"},"operator":{"$ref":"#/components/schemas/FilterOperator"},"type":{"type":"string","const":"boolean","title":"Type"},"condition":{"type":"string","const":"IS","title":"Condition"},"value":{"type":"boolean","title":"Value"}},"type":"object","required":["config_id","operator","type","condition","value"],"title":"BooleanAttributeFilter"},"FilterOperator":{"type":"string","enum":["AND","OR"],"title":"FilterOperator"},"TextAttributeFilter":{"properties":{"config_id":{"type":"integer","title":"Config Id"},"operator":{"$ref":"#/components/schemas/FilterOperator"},"type":{"type":"string","const":"text","title":"Type"},"condition":{"type":"string","enum":["CONTAINS","DOES_NOT_CONTAIN","STARTS_WITH","ENDS_WITH"],"title":"Condition"},"value":{"type":"string","maxLength":8000,"title":"Value"}},"type":"object","required":["config_id","operator","type","condition","value"],"title":"TextAttributeFilter"},"IntegerAttributeFilter":{"properties":{"config_id":{"type":"integer","title":"Config Id"},"operator":{"$ref":"#/components/schemas/FilterOperator"},"type":{"type":"string","const":"integer","title":"Type"},"condition":{"type":"string","enum":["IS","IS_NOT","GREATER_THAN","GREATER_THAN_OR_EQUAL_TO","LESS_THAN","LESS_THAN_OR_EQUAL_TO"],"title":"Condition"},"value":{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991,"title":"Value"}},"type":"object","required":["config_id","operator","type","condition","value"],"title":"IntegerAttributeFilter"},"EnumAttributeFilter":{"properties":{"config_id":{"type":"integer","title":"Config Id"},"operator":{"$ref":"#/components/schemas/FilterOperator"},"type":{"type":"string","const":"enum","title":"Type"},"condition":{"type":"string","enum":["IS","IS_NOT"],"title":"Condition"},"value":{"items":{"type":"integer"},"type":"array","title":"Value"}},"type":"object","required":["config_id","operator","type","condition","value"],"title":"EnumAttributeFilter"},"UserAttributeFilter":{"properties":{"config_id":{"type":"integer","title":"Config Id"},"operator":{"$ref":"#/components/schemas/FilterOperator"},"type":{"type":"string","const":"user","title":"Type"},"condition":{"type":"string","enum":["IS","IS_NOT"],"title":"Condition"},"value":{"items":{"type":"string"},"type":"array","maxItems":20,"minItems":1,"title":"Value"}},"type":"object","required":["config_id","operator","type","condition","value"],"title":"UserAttributeFilter"},"AssetList":{"properties":{"data":{"items":{"$ref":"#/components/schemas/app__models__public__asset__AssetData"},"type":"array","title":"Data"}},"type":"object","required":["data"],"title":"AssetList"},"app__models__public__asset__AssetData":{"properties":{"asset":{"$ref":"#/components/schemas/AssetObject"},"parents":{"items":{"$ref":"#/components/schemas/AssetObject"},"type":"array","title":"Parents"},"attrs":{"anyOf":[{"$ref":"#/components/schemas/SourceAttributes"},{"$ref":"#/components/schemas/CollectionAttributes"},{"$ref":"#/components/schemas/DatasetAttributes"},{"$ref":"#/components/schemas/PropertyAttributes"},{"$ref":"#/components/schemas/DashboardAttributes"},{"$ref":"#/components/schemas/ChartAttributes"},{"$ref":"#/components/schemas/DataJobAttributes"},{"$ref":"#/components/schemas/DataTaskAttributes"},{"$ref":"#/components/schemas/PolicyAttributes"},{"$ref":"#/components/schemas/GlossaryAttributes"},{"$ref":"#/components/schemas/CategoryAttributes"},{"$ref":"#/components/schemas/TermAttributes"}],"title":"Attrs"}},"type":"object","required":["asset","parents","attrs"],"title":"AssetData"},"AssetObject":{"properties":{"id":{"type":"integer","title":"Id"},"name":{"type":"string","title":"Name"},"type":{"$ref":"#/components/schemas/AssetMetadataTypes"}},"type":"object","required":["id","name","type"],"title":"AssetObject"},"AssetMetadataTypes":{"type":"string","enum":["source","collection","dataset","property","data_job","data_task","data_run","file","glossary","category","term","monitor","dashboard","report","chart","policy","policy_rule","data_domain","data_subdomain","data_product","data_asset","data_asset_property","data_contract"],"title":"AssetMetadataTypes"},"SourceAttributes":{"properties":{"source_type":{"$ref":"#/components/schemas/DbType"},"data_owners":{"items":{"$ref":"#/components/schemas/Users"},"type":"array","title":"Data Owners"},"business_owners":{"items":{"$ref":"#/components/schemas/Users"},"type":"array","title":"Business Owners"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"linked_terms":{"items":{"$ref":"#/components/schemas/app__models__public__asset__AssetIdentifier"},"type":"array","title":"Linked Terms"},"custom_attributes":{"items":{"anyOf":[{"$ref":"#/components/schemas/app__models__public__custom_attributes__IntegerAttribute"},{"$ref":"#/components/schemas/app__models__public__custom_attributes__TextAttribute"},{"$ref":"#/components/schemas/app__models__public__custom_attributes__BooleanAttribute"},{"$ref":"#/components/schemas/app__models__public__custom_attributes__EnumAttribute"},{"$ref":"#/components/schemas/app__models__public__custom_attributes__UserAttribute"}]},"type":"array","title":"Custom Attributes"}},"type":"object","required":["source_type","data_owners","business_owners","description","linked_terms","custom_attributes"],"title":"SourceAttributes"},"DbType":{"type":"string","enum":["bigquery","redshift","postgresql","mysql","snowflake","databricks","sql_server","azure_server","singlestore","synapse","oracle","cloudera_hive","hive","power_bi","tableau","looker","dbt_cloud","dbt_core","fivetran","airflow","adf","glue","s3dl","adls","gcsdl","open_lineage","spark","iceberg","cloudera_atlas","atlas","unknown"],"title":"DbType"},"Users":{"properties":{"email":{"type":"string","title":"Email"},"id":{"type":"string","title":"Id"}},"type":"object","required":["email","id"],"title":"Users"},"app__models__public__asset__AssetIdentifier":{"properties":{"id":{"type":"integer","minimum":0,"title":"Id","description":"Unique identifier of the specific asset"},"type":{"$ref":"#/components/schemas/AssetMetadataTypes","description":"Type of the specific asset"}},"type":"object","required":["id","type"],"title":"AssetIdentifier"},"app__models__public__custom_attributes__IntegerAttribute":{"properties":{"type":{"type":"string","const":"integer","title":"Type"},"value":{"type":"integer","title":"Value","description":"Integer value of the custom attribute"}},"type":"object","required":["type","value"],"title":"IntegerAttribute"},"app__models__public__custom_attributes__TextAttribute":{"properties":{"type":{"type":"string","const":"text","title":"Type"},"value":{"type":"string","title":"Value","description":"Text value of the custom attribute"}},"type":"object","required":["type","value"],"title":"TextAttribute"},"app__models__public__custom_attributes__BooleanAttribute":{"properties":{"type":{"type":"string","const":"boolean","title":"Type"},"value":{"type":"boolean","title":"Value","description":"Boolean value of the custom attribute"}},"type":"object","required":["type","value"],"title":"BooleanAttribute"},"app__models__public__custom_attributes__EnumAttribute":{"properties":{"type":{"type":"string","const":"enum","title":"Type"},"value":{"items":{"$ref":"#/components/schemas/app__models__public__custom_attributes__EnumValue"},"type":"array","title":"Value","description":"List of enum values"}},"type":"object","required":["type","value"],"title":"EnumAttribute"},"app__models__public__custom_attributes__EnumValue":{"properties":{"id":{"type":"integer","title":"Id","description":"ID of the enum option"},"label":{"type":"string","title":"Label","description":"Label of the enum option"},"color":{"type":"string","title":"Color","description":"Color associated with the enum option"}},"type":"object","required":["id","label","color"],"title":"EnumValue"},"app__models__public__custom_attributes__UserAttribute":{"properties":{"type":{"type":"string","const":"user","title":"Type"},"value":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}],"title":"Value","description":"User or list of users associated with the custom attribute. If the attribute is multi-select, this will be a list."}},"type":"object","required":["type","value"],"title":"UserAttribute"},"CollectionAttributes":{"properties":{"data_owners":{"items":{"$ref":"#/components/schemas/Users"},"type":"array","title":"Data Owners"},"business_owners":{"items":{"$ref":"#/components/schemas/Users"},"type":"array","title":"Business Owners"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"source_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Description"},"linked_terms":{"items":{"$ref":"#/components/schemas/app__models__public__asset__AssetIdentifier"},"type":"array","title":"Linked Terms"},"custom_attributes":{"items":{"anyOf":[{"$ref":"#/components/schemas/app__models__public__custom_attributes__IntegerAttribute"},{"$ref":"#/components/schemas/app__models__public__custom_attributes__TextAttribute"},{"$ref":"#/components/schemas/app__models__public__custom_attributes__BooleanAttribute"},{"$ref":"#/components/schemas/app__models__public__custom_attributes__EnumAttribute"},{"$ref":"#/components/schemas/app__models__public__custom_attributes__UserAttribute"}]},"type":"array","title":"Custom Attributes"}},"type":"object","required":["data_owners","business_owners","description","source_description","linked_terms","custom_attributes"],"title":"CollectionAttributes"},"DatasetAttributes":{"properties":{"data_owners":{"items":{"$ref":"#/components/schemas/Users"},"type":"array","title":"Data Owners"},"business_owners":{"items":{"$ref":"#/components/schemas/Users"},"type":"array","title":"Business Owners"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"source_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Description"},"property_count":{"type":"integer","title":"Property Count"},"is_view":{"type":"boolean","title":"Is View"},"is_virtual":{"type":"boolean","title":"Is Virtual"},"linked_terms":{"items":{"$ref":"#/components/schemas/app__models__public__asset__AssetIdentifier"},"type":"array","title":"Linked Terms"},"custom_attributes":{"items":{"anyOf":[{"$ref":"#/components/schemas/app__models__public__custom_attributes__IntegerAttribute"},{"$ref":"#/components/schemas/app__models__public__custom_attributes__TextAttribute"},{"$ref":"#/components/schemas/app__models__public__custom_attributes__BooleanAttribute"},{"$ref":"#/components/schemas/app__models__public__custom_attributes__EnumAttribute"},{"$ref":"#/components/schemas/app__models__public__custom_attributes__UserAttribute"}]},"type":"array","title":"Custom Attributes"}},"type":"object","required":["data_owners","business_owners","description","source_description","property_count","is_view","is_virtual","linked_terms","custom_attributes"],"title":"DatasetAttributes"},"PropertyAttributes":{"properties":{"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"source_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Description"},"tags":{"items":{"type":"string"},"type":"array","title":"Tags"},"unified_type":{"$ref":"#/components/schemas/DataType"},"raw_type":{"type":"string","title":"Raw Type"},"is_virtual":{"type":"boolean","title":"Is Virtual"},"classifications":{"items":{"$ref":"#/components/schemas/app__models__public__asset__AssetIdentifier"},"type":"array","title":"Classifications"},"linked_terms":{"items":{"$ref":"#/components/schemas/app__models__public__asset__AssetIdentifier"},"type":"array","title":"Linked Terms"},"custom_attributes":{"items":{"anyOf":[{"$ref":"#/components/schemas/app__models__public__custom_attributes__IntegerAttribute"},{"$ref":"#/components/schemas/app__models__public__custom_attributes__TextAttribute"},{"$ref":"#/components/schemas/app__models__public__custom_attributes__BooleanAttribute"},{"$ref":"#/components/schemas/app__models__public__custom_attributes__EnumAttribute"},{"$ref":"#/components/schemas/app__models__public__custom_attributes__UserAttribute"}]},"type":"array","title":"Custom Attributes"}},"type":"object","required":["description","source_description","tags","unified_type","raw_type","is_virtual","classifications","linked_terms","custom_attributes"],"title":"PropertyAttributes"},"DataType":{"type":"string","enum":["INTEGER","STRING","NUMERIC","BOOLEAN","DATETIME","INTERVAL","DATE","ARRAY","JSON","OTHER","ENUM","TIME"],"title":"DataType"},"DashboardAttributes":{"properties":{"data_owners":{"items":{"$ref":"#/components/schemas/Users"},"type":"array","title":"Data Owners"},"business_owners":{"items":{"$ref":"#/components/schemas/Users"},"type":"array","title":"Business Owners"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"linked_terms":{"items":{"$ref":"#/components/schemas/app__models__public__asset__AssetIdentifier"},"type":"array","title":"Linked Terms"},"custom_attributes":{"items":{"anyOf":[{"$ref":"#/components/schemas/app__models__public__custom_attributes__IntegerAttribute"},{"$ref":"#/components/schemas/app__models__public__custom_attributes__TextAttribute"},{"$ref":"#/components/schemas/app__models__public__custom_attributes__BooleanAttribute"},{"$ref":"#/components/schemas/app__models__public__custom_attributes__EnumAttribute"},{"$ref":"#/components/schemas/app__models__public__custom_attributes__UserAttribute"}]},"type":"array","title":"Custom Attributes"}},"type":"object","required":["data_owners","business_owners","description","linked_terms","custom_attributes"],"title":"DashboardAttributes"},"ChartAttributes":{"properties":{"data_owners":{"items":{"$ref":"#/components/schemas/Users"},"type":"array","title":"Data Owners"},"business_owners":{"items":{"$ref":"#/components/schemas/Users"},"type":"array","title":"Business Owners"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"linked_terms":{"items":{"$ref":"#/components/schemas/app__models__public__asset__AssetIdentifier"},"type":"array","title":"Linked Terms"},"custom_attributes":{"items":{"anyOf":[{"$ref":"#/components/schemas/app__models__public__custom_attributes__IntegerAttribute"},{"$ref":"#/components/schemas/app__models__public__custom_attributes__TextAttribute"},{"$ref":"#/components/schemas/app__models__public__custom_attributes__BooleanAttribute"},{"$ref":"#/components/schemas/app__models__public__custom_attributes__EnumAttribute"},{"$ref":"#/components/schemas/app__models__public__custom_attributes__UserAttribute"}]},"type":"array","title":"Custom Attributes"}},"type":"object","required":["data_owners","business_owners","description","linked_terms","custom_attributes"],"title":"ChartAttributes"},"DataJobAttributes":{"properties":{"data_owners":{"items":{"$ref":"#/components/schemas/Users"},"type":"array","title":"Data Owners"},"business_owners":{"items":{"$ref":"#/components/schemas/Users"},"type":"array","title":"Business Owners"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"linked_terms":{"items":{"$ref":"#/components/schemas/app__models__public__asset__AssetIdentifier"},"type":"array","title":"Linked Terms"},"custom_attributes":{"items":{"anyOf":[{"$ref":"#/components/schemas/app__models__public__custom_attributes__IntegerAttribute"},{"$ref":"#/components/schemas/app__models__public__custom_attributes__TextAttribute"},{"$ref":"#/components/schemas/app__models__public__custom_attributes__BooleanAttribute"},{"$ref":"#/components/schemas/app__models__public__custom_attributes__EnumAttribute"},{"$ref":"#/components/schemas/app__models__public__custom_attributes__UserAttribute"}]},"type":"array","title":"Custom Attributes"}},"type":"object","required":["data_owners","business_owners","description","linked_terms","custom_attributes"],"title":"DataJobAttributes"},"DataTaskAttributes":{"properties":{},"type":"object","title":"DataTaskAttributes"},"PolicyAttributes":{"properties":{"policy_tag":{"type":"string","title":"Policy Tag"},"stewards":{"items":{"$ref":"#/components/schemas/Users"},"type":"array","title":"Stewards"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"purpose":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Purpose"},"color":{"type":"string","title":"Color"},"masking_type":{"$ref":"#/components/schemas/RuleMasking"}},"type":"object","required":["policy_tag","stewards","description","purpose","color","masking_type"],"title":"PolicyAttributes"},"RuleMasking":{"type":"string","enum":["none","hash","email","last_four","first_four","nullify","sha256"],"title":"RuleMasking"},"GlossaryAttributes":{"properties":{"data_owners":{"items":{"$ref":"#/components/schemas/Users"},"type":"array","title":"Data Owners"},"business_owners":{"items":{"$ref":"#/components/schemas/Users"},"type":"array","title":"Business Owners"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"created_by":{"$ref":"#/components/schemas/Users"},"reviewed_by":{"anyOf":[{"$ref":"#/components/schemas/Users"},{"type":"null"}]},"children_count":{"type":"integer","title":"Children Count"},"custom_attributes":{"items":{"anyOf":[{"$ref":"#/components/schemas/app__models__public__custom_attributes__IntegerAttribute"},{"$ref":"#/components/schemas/app__models__public__custom_attributes__TextAttribute"},{"$ref":"#/components/schemas/app__models__public__custom_attributes__BooleanAttribute"},{"$ref":"#/components/schemas/app__models__public__custom_attributes__EnumAttribute"},{"$ref":"#/components/schemas/app__models__public__custom_attributes__UserAttribute"}]},"type":"array","title":"Custom Attributes"}},"type":"object","required":["data_owners","business_owners","description","created_by","reviewed_by","children_count","custom_attributes"],"title":"GlossaryAttributes"},"CategoryAttributes":{"properties":{"data_owners":{"items":{"$ref":"#/components/schemas/Users"},"type":"array","title":"Data Owners"},"business_owners":{"items":{"$ref":"#/components/schemas/Users"},"type":"array","title":"Business Owners"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"created_by":{"$ref":"#/components/schemas/Users"},"reviewed_by":{"anyOf":[{"$ref":"#/components/schemas/Users"},{"type":"null"}]},"children_count":{"type":"integer","title":"Children Count"},"custom_attributes":{"items":{"anyOf":[{"$ref":"#/components/schemas/app__models__public__custom_attributes__IntegerAttribute"},{"$ref":"#/components/schemas/app__models__public__custom_attributes__TextAttribute"},{"$ref":"#/components/schemas/app__models__public__custom_attributes__BooleanAttribute"},{"$ref":"#/components/schemas/app__models__public__custom_attributes__EnumAttribute"},{"$ref":"#/components/schemas/app__models__public__custom_attributes__UserAttribute"}]},"type":"array","title":"Custom Attributes"}},"type":"object","required":["data_owners","business_owners","description","created_by","reviewed_by","children_count","custom_attributes"],"title":"CategoryAttributes"},"TermAttributes":{"properties":{"data_owners":{"items":{"$ref":"#/components/schemas/Users"},"type":"array","title":"Data Owners"},"business_owners":{"items":{"$ref":"#/components/schemas/Users"},"type":"array","title":"Business Owners"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"created_by":{"$ref":"#/components/schemas/Users"},"reviewed_by":{"anyOf":[{"$ref":"#/components/schemas/Users"},{"type":"null"}]},"classifications":{"items":{"$ref":"#/components/schemas/app__models__public__asset__AssetIdentifier"},"type":"array","title":"Classifications"},"related_terms":{"items":{"$ref":"#/components/schemas/app__models__public__asset__AssetIdentifier"},"type":"array","title":"Related Terms"},"linked_assets":{"items":{"$ref":"#/components/schemas/app__models__public__asset__AssetIdentifier"},"type":"array","title":"Linked Assets"},"custom_attributes":{"items":{"anyOf":[{"$ref":"#/components/schemas/app__models__public__custom_attributes__IntegerAttribute"},{"$ref":"#/components/schemas/app__models__public__custom_attributes__TextAttribute"},{"$ref":"#/components/schemas/app__models__public__custom_attributes__BooleanAttribute"},{"$ref":"#/components/schemas/app__models__public__custom_attributes__EnumAttribute"},{"$ref":"#/components/schemas/app__models__public__custom_attributes__UserAttribute"}]},"type":"array","title":"Custom Attributes"}},"type":"object","required":["data_owners","business_owners","description","created_by","reviewed_by","classifications","related_terms","linked_assets","custom_attributes"],"title":"TermAttributes"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}
```

## Get Asset

> Get a specific asset by ID and type. Returns the asset details along with its parent hierarchy and attributes.

```json
{"openapi":"3.1.0","info":{"title":"Decube Public API (BETA)","version":"1.0.0"},"servers":[{"url":"https://connect.<REGION>.decube.io/api/v1/data"}],"paths":{"/assets":{"get":{"tags":["Assets"],"summary":"Get Asset","description":"Get a specific asset by ID and type. Returns the asset details along with its parent hierarchy and attributes.","operationId":"get_asset_assets_get","parameters":[{"name":"asset_id","in":"query","required":true,"schema":{"type":"integer","minimum":1,"description":"Unique identifier of the specific asset","title":"Asset Id"},"description":"Unique identifier of the specific asset"},{"name":"asset_type","in":"query","required":true,"schema":{"enum":["source","collection","dataset","property","dashboard","chart","data_job","data_task","policy","glossary","category","term"],"type":"string","description":"Type of the specific asset","title":"Asset Type"},"description":"Type of the specific asset"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__models__public__asset__AssetData"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"app__models__public__asset__AssetData":{"properties":{"asset":{"$ref":"#/components/schemas/AssetObject"},"parents":{"items":{"$ref":"#/components/schemas/AssetObject"},"type":"array","title":"Parents"},"attrs":{"anyOf":[{"$ref":"#/components/schemas/SourceAttributes"},{"$ref":"#/components/schemas/CollectionAttributes"},{"$ref":"#/components/schemas/DatasetAttributes"},{"$ref":"#/components/schemas/PropertyAttributes"},{"$ref":"#/components/schemas/DashboardAttributes"},{"$ref":"#/components/schemas/ChartAttributes"},{"$ref":"#/components/schemas/DataJobAttributes"},{"$ref":"#/components/schemas/DataTaskAttributes"},{"$ref":"#/components/schemas/PolicyAttributes"},{"$ref":"#/components/schemas/GlossaryAttributes"},{"$ref":"#/components/schemas/CategoryAttributes"},{"$ref":"#/components/schemas/TermAttributes"}],"title":"Attrs"}},"type":"object","required":["asset","parents","attrs"],"title":"AssetData"},"AssetObject":{"properties":{"id":{"type":"integer","title":"Id"},"name":{"type":"string","title":"Name"},"type":{"$ref":"#/components/schemas/AssetMetadataTypes"}},"type":"object","required":["id","name","type"],"title":"AssetObject"},"AssetMetadataTypes":{"type":"string","enum":["source","collection","dataset","property","data_job","data_task","data_run","file","glossary","category","term","monitor","dashboard","report","chart","policy","policy_rule","data_domain","data_subdomain","data_product","data_asset","data_asset_property","data_contract"],"title":"AssetMetadataTypes"},"SourceAttributes":{"properties":{"source_type":{"$ref":"#/components/schemas/DbType"},"data_owners":{"items":{"$ref":"#/components/schemas/Users"},"type":"array","title":"Data Owners"},"business_owners":{"items":{"$ref":"#/components/schemas/Users"},"type":"array","title":"Business Owners"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"linked_terms":{"items":{"$ref":"#/components/schemas/app__models__public__asset__AssetIdentifier"},"type":"array","title":"Linked Terms"},"custom_attributes":{"items":{"anyOf":[{"$ref":"#/components/schemas/app__models__public__custom_attributes__IntegerAttribute"},{"$ref":"#/components/schemas/app__models__public__custom_attributes__TextAttribute"},{"$ref":"#/components/schemas/app__models__public__custom_attributes__BooleanAttribute"},{"$ref":"#/components/schemas/app__models__public__custom_attributes__EnumAttribute"},{"$ref":"#/components/schemas/app__models__public__custom_attributes__UserAttribute"}]},"type":"array","title":"Custom Attributes"}},"type":"object","required":["source_type","data_owners","business_owners","description","linked_terms","custom_attributes"],"title":"SourceAttributes"},"DbType":{"type":"string","enum":["bigquery","redshift","postgresql","mysql","snowflake","databricks","sql_server","azure_server","singlestore","synapse","oracle","cloudera_hive","hive","power_bi","tableau","looker","dbt_cloud","dbt_core","fivetran","airflow","adf","glue","s3dl","adls","gcsdl","open_lineage","spark","iceberg","cloudera_atlas","atlas","unknown"],"title":"DbType"},"Users":{"properties":{"email":{"type":"string","title":"Email"},"id":{"type":"string","title":"Id"}},"type":"object","required":["email","id"],"title":"Users"},"app__models__public__asset__AssetIdentifier":{"properties":{"id":{"type":"integer","minimum":0,"title":"Id","description":"Unique identifier of the specific asset"},"type":{"$ref":"#/components/schemas/AssetMetadataTypes","description":"Type of the specific asset"}},"type":"object","required":["id","type"],"title":"AssetIdentifier"},"app__models__public__custom_attributes__IntegerAttribute":{"properties":{"type":{"type":"string","const":"integer","title":"Type"},"value":{"type":"integer","title":"Value","description":"Integer value of the custom attribute"}},"type":"object","required":["type","value"],"title":"IntegerAttribute"},"app__models__public__custom_attributes__TextAttribute":{"properties":{"type":{"type":"string","const":"text","title":"Type"},"value":{"type":"string","title":"Value","description":"Text value of the custom attribute"}},"type":"object","required":["type","value"],"title":"TextAttribute"},"app__models__public__custom_attributes__BooleanAttribute":{"properties":{"type":{"type":"string","const":"boolean","title":"Type"},"value":{"type":"boolean","title":"Value","description":"Boolean value of the custom attribute"}},"type":"object","required":["type","value"],"title":"BooleanAttribute"},"app__models__public__custom_attributes__EnumAttribute":{"properties":{"type":{"type":"string","const":"enum","title":"Type"},"value":{"items":{"$ref":"#/components/schemas/app__models__public__custom_attributes__EnumValue"},"type":"array","title":"Value","description":"List of enum values"}},"type":"object","required":["type","value"],"title":"EnumAttribute"},"app__models__public__custom_attributes__EnumValue":{"properties":{"id":{"type":"integer","title":"Id","description":"ID of the enum option"},"label":{"type":"string","title":"Label","description":"Label of the enum option"},"color":{"type":"string","title":"Color","description":"Color associated with the enum option"}},"type":"object","required":["id","label","color"],"title":"EnumValue"},"app__models__public__custom_attributes__UserAttribute":{"properties":{"type":{"type":"string","const":"user","title":"Type"},"value":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}],"title":"Value","description":"User or list of users associated with the custom attribute. If the attribute is multi-select, this will be a list."}},"type":"object","required":["type","value"],"title":"UserAttribute"},"CollectionAttributes":{"properties":{"data_owners":{"items":{"$ref":"#/components/schemas/Users"},"type":"array","title":"Data Owners"},"business_owners":{"items":{"$ref":"#/components/schemas/Users"},"type":"array","title":"Business Owners"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"source_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Description"},"linked_terms":{"items":{"$ref":"#/components/schemas/app__models__public__asset__AssetIdentifier"},"type":"array","title":"Linked Terms"},"custom_attributes":{"items":{"anyOf":[{"$ref":"#/components/schemas/app__models__public__custom_attributes__IntegerAttribute"},{"$ref":"#/components/schemas/app__models__public__custom_attributes__TextAttribute"},{"$ref":"#/components/schemas/app__models__public__custom_attributes__BooleanAttribute"},{"$ref":"#/components/schemas/app__models__public__custom_attributes__EnumAttribute"},{"$ref":"#/components/schemas/app__models__public__custom_attributes__UserAttribute"}]},"type":"array","title":"Custom Attributes"}},"type":"object","required":["data_owners","business_owners","description","source_description","linked_terms","custom_attributes"],"title":"CollectionAttributes"},"DatasetAttributes":{"properties":{"data_owners":{"items":{"$ref":"#/components/schemas/Users"},"type":"array","title":"Data Owners"},"business_owners":{"items":{"$ref":"#/components/schemas/Users"},"type":"array","title":"Business Owners"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"source_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Description"},"property_count":{"type":"integer","title":"Property Count"},"is_view":{"type":"boolean","title":"Is View"},"is_virtual":{"type":"boolean","title":"Is Virtual"},"linked_terms":{"items":{"$ref":"#/components/schemas/app__models__public__asset__AssetIdentifier"},"type":"array","title":"Linked Terms"},"custom_attributes":{"items":{"anyOf":[{"$ref":"#/components/schemas/app__models__public__custom_attributes__IntegerAttribute"},{"$ref":"#/components/schemas/app__models__public__custom_attributes__TextAttribute"},{"$ref":"#/components/schemas/app__models__public__custom_attributes__BooleanAttribute"},{"$ref":"#/components/schemas/app__models__public__custom_attributes__EnumAttribute"},{"$ref":"#/components/schemas/app__models__public__custom_attributes__UserAttribute"}]},"type":"array","title":"Custom Attributes"}},"type":"object","required":["data_owners","business_owners","description","source_description","property_count","is_view","is_virtual","linked_terms","custom_attributes"],"title":"DatasetAttributes"},"PropertyAttributes":{"properties":{"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"source_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Description"},"tags":{"items":{"type":"string"},"type":"array","title":"Tags"},"unified_type":{"$ref":"#/components/schemas/DataType"},"raw_type":{"type":"string","title":"Raw Type"},"is_virtual":{"type":"boolean","title":"Is Virtual"},"classifications":{"items":{"$ref":"#/components/schemas/app__models__public__asset__AssetIdentifier"},"type":"array","title":"Classifications"},"linked_terms":{"items":{"$ref":"#/components/schemas/app__models__public__asset__AssetIdentifier"},"type":"array","title":"Linked Terms"},"custom_attributes":{"items":{"anyOf":[{"$ref":"#/components/schemas/app__models__public__custom_attributes__IntegerAttribute"},{"$ref":"#/components/schemas/app__models__public__custom_attributes__TextAttribute"},{"$ref":"#/components/schemas/app__models__public__custom_attributes__BooleanAttribute"},{"$ref":"#/components/schemas/app__models__public__custom_attributes__EnumAttribute"},{"$ref":"#/components/schemas/app__models__public__custom_attributes__UserAttribute"}]},"type":"array","title":"Custom Attributes"}},"type":"object","required":["description","source_description","tags","unified_type","raw_type","is_virtual","classifications","linked_terms","custom_attributes"],"title":"PropertyAttributes"},"DataType":{"type":"string","enum":["INTEGER","STRING","NUMERIC","BOOLEAN","DATETIME","INTERVAL","DATE","ARRAY","JSON","OTHER","ENUM","TIME"],"title":"DataType"},"DashboardAttributes":{"properties":{"data_owners":{"items":{"$ref":"#/components/schemas/Users"},"type":"array","title":"Data Owners"},"business_owners":{"items":{"$ref":"#/components/schemas/Users"},"type":"array","title":"Business Owners"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"linked_terms":{"items":{"$ref":"#/components/schemas/app__models__public__asset__AssetIdentifier"},"type":"array","title":"Linked Terms"},"custom_attributes":{"items":{"anyOf":[{"$ref":"#/components/schemas/app__models__public__custom_attributes__IntegerAttribute"},{"$ref":"#/components/schemas/app__models__public__custom_attributes__TextAttribute"},{"$ref":"#/components/schemas/app__models__public__custom_attributes__BooleanAttribute"},{"$ref":"#/components/schemas/app__models__public__custom_attributes__EnumAttribute"},{"$ref":"#/components/schemas/app__models__public__custom_attributes__UserAttribute"}]},"type":"array","title":"Custom Attributes"}},"type":"object","required":["data_owners","business_owners","description","linked_terms","custom_attributes"],"title":"DashboardAttributes"},"ChartAttributes":{"properties":{"data_owners":{"items":{"$ref":"#/components/schemas/Users"},"type":"array","title":"Data Owners"},"business_owners":{"items":{"$ref":"#/components/schemas/Users"},"type":"array","title":"Business Owners"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"linked_terms":{"items":{"$ref":"#/components/schemas/app__models__public__asset__AssetIdentifier"},"type":"array","title":"Linked Terms"},"custom_attributes":{"items":{"anyOf":[{"$ref":"#/components/schemas/app__models__public__custom_attributes__IntegerAttribute"},{"$ref":"#/components/schemas/app__models__public__custom_attributes__TextAttribute"},{"$ref":"#/components/schemas/app__models__public__custom_attributes__BooleanAttribute"},{"$ref":"#/components/schemas/app__models__public__custom_attributes__EnumAttribute"},{"$ref":"#/components/schemas/app__models__public__custom_attributes__UserAttribute"}]},"type":"array","title":"Custom Attributes"}},"type":"object","required":["data_owners","business_owners","description","linked_terms","custom_attributes"],"title":"ChartAttributes"},"DataJobAttributes":{"properties":{"data_owners":{"items":{"$ref":"#/components/schemas/Users"},"type":"array","title":"Data Owners"},"business_owners":{"items":{"$ref":"#/components/schemas/Users"},"type":"array","title":"Business Owners"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"linked_terms":{"items":{"$ref":"#/components/schemas/app__models__public__asset__AssetIdentifier"},"type":"array","title":"Linked Terms"},"custom_attributes":{"items":{"anyOf":[{"$ref":"#/components/schemas/app__models__public__custom_attributes__IntegerAttribute"},{"$ref":"#/components/schemas/app__models__public__custom_attributes__TextAttribute"},{"$ref":"#/components/schemas/app__models__public__custom_attributes__BooleanAttribute"},{"$ref":"#/components/schemas/app__models__public__custom_attributes__EnumAttribute"},{"$ref":"#/components/schemas/app__models__public__custom_attributes__UserAttribute"}]},"type":"array","title":"Custom Attributes"}},"type":"object","required":["data_owners","business_owners","description","linked_terms","custom_attributes"],"title":"DataJobAttributes"},"DataTaskAttributes":{"properties":{},"type":"object","title":"DataTaskAttributes"},"PolicyAttributes":{"properties":{"policy_tag":{"type":"string","title":"Policy Tag"},"stewards":{"items":{"$ref":"#/components/schemas/Users"},"type":"array","title":"Stewards"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"purpose":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Purpose"},"color":{"type":"string","title":"Color"},"masking_type":{"$ref":"#/components/schemas/RuleMasking"}},"type":"object","required":["policy_tag","stewards","description","purpose","color","masking_type"],"title":"PolicyAttributes"},"RuleMasking":{"type":"string","enum":["none","hash","email","last_four","first_four","nullify","sha256"],"title":"RuleMasking"},"GlossaryAttributes":{"properties":{"data_owners":{"items":{"$ref":"#/components/schemas/Users"},"type":"array","title":"Data Owners"},"business_owners":{"items":{"$ref":"#/components/schemas/Users"},"type":"array","title":"Business Owners"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"created_by":{"$ref":"#/components/schemas/Users"},"reviewed_by":{"anyOf":[{"$ref":"#/components/schemas/Users"},{"type":"null"}]},"children_count":{"type":"integer","title":"Children Count"},"custom_attributes":{"items":{"anyOf":[{"$ref":"#/components/schemas/app__models__public__custom_attributes__IntegerAttribute"},{"$ref":"#/components/schemas/app__models__public__custom_attributes__TextAttribute"},{"$ref":"#/components/schemas/app__models__public__custom_attributes__BooleanAttribute"},{"$ref":"#/components/schemas/app__models__public__custom_attributes__EnumAttribute"},{"$ref":"#/components/schemas/app__models__public__custom_attributes__UserAttribute"}]},"type":"array","title":"Custom Attributes"}},"type":"object","required":["data_owners","business_owners","description","created_by","reviewed_by","children_count","custom_attributes"],"title":"GlossaryAttributes"},"CategoryAttributes":{"properties":{"data_owners":{"items":{"$ref":"#/components/schemas/Users"},"type":"array","title":"Data Owners"},"business_owners":{"items":{"$ref":"#/components/schemas/Users"},"type":"array","title":"Business Owners"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"created_by":{"$ref":"#/components/schemas/Users"},"reviewed_by":{"anyOf":[{"$ref":"#/components/schemas/Users"},{"type":"null"}]},"children_count":{"type":"integer","title":"Children Count"},"custom_attributes":{"items":{"anyOf":[{"$ref":"#/components/schemas/app__models__public__custom_attributes__IntegerAttribute"},{"$ref":"#/components/schemas/app__models__public__custom_attributes__TextAttribute"},{"$ref":"#/components/schemas/app__models__public__custom_attributes__BooleanAttribute"},{"$ref":"#/components/schemas/app__models__public__custom_attributes__EnumAttribute"},{"$ref":"#/components/schemas/app__models__public__custom_attributes__UserAttribute"}]},"type":"array","title":"Custom Attributes"}},"type":"object","required":["data_owners","business_owners","description","created_by","reviewed_by","children_count","custom_attributes"],"title":"CategoryAttributes"},"TermAttributes":{"properties":{"data_owners":{"items":{"$ref":"#/components/schemas/Users"},"type":"array","title":"Data Owners"},"business_owners":{"items":{"$ref":"#/components/schemas/Users"},"type":"array","title":"Business Owners"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"created_by":{"$ref":"#/components/schemas/Users"},"reviewed_by":{"anyOf":[{"$ref":"#/components/schemas/Users"},{"type":"null"}]},"classifications":{"items":{"$ref":"#/components/schemas/app__models__public__asset__AssetIdentifier"},"type":"array","title":"Classifications"},"related_terms":{"items":{"$ref":"#/components/schemas/app__models__public__asset__AssetIdentifier"},"type":"array","title":"Related Terms"},"linked_assets":{"items":{"$ref":"#/components/schemas/app__models__public__asset__AssetIdentifier"},"type":"array","title":"Linked Assets"},"custom_attributes":{"items":{"anyOf":[{"$ref":"#/components/schemas/app__models__public__custom_attributes__IntegerAttribute"},{"$ref":"#/components/schemas/app__models__public__custom_attributes__TextAttribute"},{"$ref":"#/components/schemas/app__models__public__custom_attributes__BooleanAttribute"},{"$ref":"#/components/schemas/app__models__public__custom_attributes__EnumAttribute"},{"$ref":"#/components/schemas/app__models__public__custom_attributes__UserAttribute"}]},"type":"array","title":"Custom Attributes"}},"type":"object","required":["data_owners","business_owners","description","created_by","reviewed_by","classifications","related_terms","linked_assets","custom_attributes"],"title":"TermAttributes"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}
```

## Update Asset

> Update modifiable attributes for various asset types.

```json
{"openapi":"3.1.0","info":{"title":"Decube Public API (BETA)","version":"1.0.0"},"servers":[{"url":"https://connect.<REGION>.decube.io/api/v1/data"}],"paths":{"/assets":{"patch":{"tags":["Assets"],"summary":"Update Asset","description":"Update modifiable attributes for various asset types.","operationId":"update_asset_assets_patch","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/ModifiableSourceAttributes"},{"$ref":"#/components/schemas/ModifiableCollectionAttributes"},{"$ref":"#/components/schemas/ModifiableDatasetAttributes"},{"$ref":"#/components/schemas/ModifiablePropertyAttributes"},{"$ref":"#/components/schemas/ModifiableDashboardAttributes"},{"$ref":"#/components/schemas/ModifiableChartAttributes"},{"$ref":"#/components/schemas/ModifiableDataJobAttributes"},{"$ref":"#/components/schemas/ModifiablePolicyAttributes"},{"$ref":"#/components/schemas/ModifiableGlossaryAttributes"},{"$ref":"#/components/schemas/ModifiableCategoryAttributes"},{"$ref":"#/components/schemas/ModifiableTermAttributes"}],"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"ModifiableSourceAttributes":{"properties":{"asset_id":{"type":"integer","minimum":1,"title":"Asset Id"},"asset_type":{"type":"string","const":"source","title":"Asset Type"},"data_owners":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Data Owners"},"business_owners":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Business Owners"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"linked_terms":{"anyOf":[{"items":{"$ref":"#/components/schemas/app__models__public__asset__TermIdentifier"},"type":"array"},{"type":"null"}],"title":"Linked Terms"},"custom_attributes":{"anyOf":[{"items":{"anyOf":[{"$ref":"#/components/schemas/IntegerAttributeWrite"},{"$ref":"#/components/schemas/TextAttributeWrite"},{"$ref":"#/components/schemas/BooleanAttributeWrite"},{"$ref":"#/components/schemas/EnumAttributeWrite"},{"$ref":"#/components/schemas/UserAttributeWrite"}]},"type":"array"},{"type":"null"}],"title":"Custom Attributes","description":"List of custom attributes to set on the asset. This will overwrite existing custom attributes. If an empty list is provided, all custom attributes will be cleared."}},"type":"object","required":["asset_id","asset_type"],"title":"ModifiableSourceAttributes"},"app__models__public__asset__TermIdentifier":{"properties":{"type":{"type":"string","const":"term","title":"Type"},"id":{"type":"integer","minimum":0,"title":"Id","description":"Unique identifier of the term asset"}},"type":"object","required":["type","id"],"title":"TermIdentifier"},"IntegerAttributeWrite":{"properties":{"type":{"type":"string","const":"integer","title":"Type"},"id":{"type":"integer","title":"Id","description":"Unique identifier for the custom attribute"},"value":{"type":"integer","title":"Value","description":"Integer value of the custom attribute"}},"type":"object","required":["type","id","value"],"title":"IntegerAttributeWrite"},"TextAttributeWrite":{"properties":{"type":{"type":"string","const":"text","title":"Type"},"id":{"type":"integer","title":"Id","description":"Unique identifier for the custom attribute"},"value":{"type":"string","title":"Value","description":"Text value of the custom attribute"}},"type":"object","required":["type","id","value"],"title":"TextAttributeWrite"},"BooleanAttributeWrite":{"properties":{"type":{"type":"string","const":"boolean","title":"Type"},"id":{"type":"integer","title":"Id","description":"Unique identifier for the custom attribute"},"value":{"type":"boolean","title":"Value","description":"Boolean value of the custom attribute"}},"type":"object","required":["type","id","value"],"title":"BooleanAttributeWrite"},"EnumAttributeWrite":{"properties":{"type":{"type":"string","const":"enum","title":"Type"},"id":{"type":"integer","title":"Id","description":"Unique identifier for the custom attribute"},"value":{"items":{"type":"integer"},"type":"array","title":"Value","description":"List of enum option IDs associated with the custom attribute"}},"type":"object","required":["type","id","value"],"title":"EnumAttributeWrite"},"UserAttributeWrite":{"properties":{"type":{"type":"string","const":"user","title":"Type"},"id":{"type":"integer","title":"Id","description":"Unique identifier for the custom attribute"},"value":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"string"}],"title":"Value","description":"List of user emails associated with the custom attribute. If the attribute is multi-select, this must be a list, otherwise it must be a single UserByEmail."}},"type":"object","required":["type","id","value"],"title":"UserAttributeWrite"},"ModifiableCollectionAttributes":{"properties":{"asset_id":{"type":"integer","minimum":1,"title":"Asset Id"},"asset_type":{"type":"string","const":"collection","title":"Asset Type"},"data_owners":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Data Owners"},"business_owners":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Business Owners"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"linked_terms":{"anyOf":[{"items":{"$ref":"#/components/schemas/app__models__public__asset__TermIdentifier"},"type":"array"},{"type":"null"}],"title":"Linked Terms"},"custom_attributes":{"anyOf":[{"items":{"anyOf":[{"$ref":"#/components/schemas/IntegerAttributeWrite"},{"$ref":"#/components/schemas/TextAttributeWrite"},{"$ref":"#/components/schemas/BooleanAttributeWrite"},{"$ref":"#/components/schemas/EnumAttributeWrite"},{"$ref":"#/components/schemas/UserAttributeWrite"}]},"type":"array"},{"type":"null"}],"title":"Custom Attributes","description":"List of custom attributes to set on the asset. This will overwrite existing custom attributes. If an empty list is provided, all custom attributes will be cleared."}},"type":"object","required":["asset_id","asset_type"],"title":"ModifiableCollectionAttributes"},"ModifiableDatasetAttributes":{"properties":{"asset_id":{"type":"integer","minimum":1,"title":"Asset Id"},"asset_type":{"type":"string","const":"dataset","title":"Asset Type"},"data_owners":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Data Owners"},"business_owners":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Business Owners"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"linked_terms":{"anyOf":[{"items":{"$ref":"#/components/schemas/app__models__public__asset__TermIdentifier"},"type":"array"},{"type":"null"}],"title":"Linked Terms"},"custom_attributes":{"anyOf":[{"items":{"anyOf":[{"$ref":"#/components/schemas/IntegerAttributeWrite"},{"$ref":"#/components/schemas/TextAttributeWrite"},{"$ref":"#/components/schemas/BooleanAttributeWrite"},{"$ref":"#/components/schemas/EnumAttributeWrite"},{"$ref":"#/components/schemas/UserAttributeWrite"}]},"type":"array"},{"type":"null"}],"title":"Custom Attributes","description":"List of custom attributes to set on the asset. This will overwrite existing custom attributes. If an empty list is provided, all custom attributes will be cleared."}},"type":"object","required":["asset_id","asset_type"],"title":"ModifiableDatasetAttributes"},"ModifiablePropertyAttributes":{"properties":{"asset_id":{"type":"integer","minimum":1,"title":"Asset Id"},"asset_type":{"type":"string","const":"property","title":"Asset Type"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"tags":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Tags"},"classifications":{"anyOf":[{"items":{"$ref":"#/components/schemas/PolicyIdentifier"},"type":"array"},{"type":"null"}],"title":"Classifications"},"linked_terms":{"anyOf":[{"items":{"$ref":"#/components/schemas/app__models__public__asset__TermIdentifier"},"type":"array"},{"type":"null"}],"title":"Linked Terms"},"custom_attributes":{"anyOf":[{"items":{"anyOf":[{"$ref":"#/components/schemas/IntegerAttributeWrite"},{"$ref":"#/components/schemas/TextAttributeWrite"},{"$ref":"#/components/schemas/BooleanAttributeWrite"},{"$ref":"#/components/schemas/EnumAttributeWrite"},{"$ref":"#/components/schemas/UserAttributeWrite"}]},"type":"array"},{"type":"null"}],"title":"Custom Attributes","description":"List of custom attributes to set on the asset. This will overwrite existing custom attributes. If an empty list is provided, all custom attributes will be cleared."}},"type":"object","required":["asset_id","asset_type"],"title":"ModifiablePropertyAttributes"},"PolicyIdentifier":{"properties":{"type":{"type":"string","const":"policy","title":"Type"},"id":{"type":"integer","minimum":0,"title":"Id","description":"Unique identifier of the policy asset"}},"type":"object","required":["type","id"],"title":"PolicyIdentifier"},"ModifiableDashboardAttributes":{"properties":{"asset_id":{"type":"integer","minimum":1,"title":"Asset Id"},"asset_type":{"type":"string","const":"dashboard","title":"Asset Type"},"data_owners":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Data Owners"},"business_owners":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Business Owners"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"linked_terms":{"anyOf":[{"items":{"$ref":"#/components/schemas/app__models__public__asset__TermIdentifier"},"type":"array"},{"type":"null"}],"title":"Linked Terms"},"custom_attributes":{"anyOf":[{"items":{"anyOf":[{"$ref":"#/components/schemas/IntegerAttributeWrite"},{"$ref":"#/components/schemas/TextAttributeWrite"},{"$ref":"#/components/schemas/BooleanAttributeWrite"},{"$ref":"#/components/schemas/EnumAttributeWrite"},{"$ref":"#/components/schemas/UserAttributeWrite"}]},"type":"array"},{"type":"null"}],"title":"Custom Attributes","description":"List of custom attributes to set on the asset. This will overwrite existing custom attributes. If an empty list is provided, all custom attributes will be cleared."}},"type":"object","required":["asset_id","asset_type"],"title":"ModifiableDashboardAttributes"},"ModifiableChartAttributes":{"properties":{"asset_id":{"type":"integer","minimum":1,"title":"Asset Id"},"asset_type":{"type":"string","const":"chart","title":"Asset Type"},"data_owners":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Data Owners"},"business_owners":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Business Owners"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"linked_terms":{"anyOf":[{"items":{"$ref":"#/components/schemas/app__models__public__asset__TermIdentifier"},"type":"array"},{"type":"null"}],"title":"Linked Terms"},"custom_attributes":{"anyOf":[{"items":{"anyOf":[{"$ref":"#/components/schemas/IntegerAttributeWrite"},{"$ref":"#/components/schemas/TextAttributeWrite"},{"$ref":"#/components/schemas/BooleanAttributeWrite"},{"$ref":"#/components/schemas/EnumAttributeWrite"},{"$ref":"#/components/schemas/UserAttributeWrite"}]},"type":"array"},{"type":"null"}],"title":"Custom Attributes","description":"List of custom attributes to set on the asset. This will overwrite existing custom attributes. If an empty list is provided, all custom attributes will be cleared."}},"type":"object","required":["asset_id","asset_type"],"title":"ModifiableChartAttributes"},"ModifiableDataJobAttributes":{"properties":{"asset_id":{"type":"integer","minimum":1,"title":"Asset Id"},"asset_type":{"type":"string","const":"data_job","title":"Asset Type"},"data_owners":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Data Owners"},"business_owners":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Business Owners"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"linked_terms":{"anyOf":[{"items":{"$ref":"#/components/schemas/app__models__public__asset__TermIdentifier"},"type":"array"},{"type":"null"}],"title":"Linked Terms"},"custom_attributes":{"anyOf":[{"items":{"anyOf":[{"$ref":"#/components/schemas/IntegerAttributeWrite"},{"$ref":"#/components/schemas/TextAttributeWrite"},{"$ref":"#/components/schemas/BooleanAttributeWrite"},{"$ref":"#/components/schemas/EnumAttributeWrite"},{"$ref":"#/components/schemas/UserAttributeWrite"}]},"type":"array"},{"type":"null"}],"title":"Custom Attributes","description":"List of custom attributes to set on the asset. This will overwrite existing custom attributes. If an empty list is provided, all custom attributes will be cleared."}},"type":"object","required":["asset_id","asset_type"],"title":"ModifiableDataJobAttributes"},"ModifiablePolicyAttributes":{"properties":{"asset_id":{"type":"integer","minimum":1,"title":"Asset Id"},"asset_type":{"type":"string","const":"policy","title":"Asset Type"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"policy_tag":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Policy Tag"},"stewards":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Stewards"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"purpose":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Purpose"}},"type":"object","required":["asset_id","asset_type"],"title":"ModifiablePolicyAttributes"},"ModifiableGlossaryAttributes":{"properties":{"asset_id":{"type":"integer","minimum":1,"title":"Asset Id"},"asset_type":{"type":"string","const":"glossary","title":"Asset Type"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"data_owners":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Data Owners"},"business_owners":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Business Owners"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"custom_attributes":{"anyOf":[{"items":{"anyOf":[{"$ref":"#/components/schemas/IntegerAttributeWrite"},{"$ref":"#/components/schemas/TextAttributeWrite"},{"$ref":"#/components/schemas/BooleanAttributeWrite"},{"$ref":"#/components/schemas/EnumAttributeWrite"},{"$ref":"#/components/schemas/UserAttributeWrite"}]},"type":"array"},{"type":"null"}],"title":"Custom Attributes","description":"List of custom attributes to set on the asset. This will overwrite existing custom attributes. If an empty list is provided, all custom attributes will be cleared."}},"type":"object","required":["asset_id","asset_type"],"title":"ModifiableGlossaryAttributes"},"ModifiableCategoryAttributes":{"properties":{"asset_id":{"type":"integer","minimum":1,"title":"Asset Id"},"asset_type":{"type":"string","const":"category","title":"Asset Type"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"data_owners":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Data Owners"},"business_owners":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Business Owners"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"custom_attributes":{"anyOf":[{"items":{"anyOf":[{"$ref":"#/components/schemas/IntegerAttributeWrite"},{"$ref":"#/components/schemas/TextAttributeWrite"},{"$ref":"#/components/schemas/BooleanAttributeWrite"},{"$ref":"#/components/schemas/EnumAttributeWrite"},{"$ref":"#/components/schemas/UserAttributeWrite"}]},"type":"array"},{"type":"null"}],"title":"Custom Attributes","description":"List of custom attributes to set on the asset. This will overwrite existing custom attributes. If an empty list is provided, all custom attributes will be cleared."}},"type":"object","required":["asset_id","asset_type"],"title":"ModifiableCategoryAttributes"},"ModifiableTermAttributes":{"properties":{"asset_id":{"type":"integer","minimum":1,"title":"Asset Id"},"asset_type":{"type":"string","const":"term","title":"Asset Type"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"data_owners":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Data Owners"},"business_owners":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Business Owners"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"classifications":{"anyOf":[{"items":{"$ref":"#/components/schemas/PolicyIdentifier"},"type":"array"},{"type":"null"}],"title":"Classifications"},"related_terms":{"anyOf":[{"items":{"$ref":"#/components/schemas/app__models__public__asset__TermIdentifier"},"type":"array"},{"type":"null"}],"title":"Related Terms"},"linked_assets":{"anyOf":[{"items":{"$ref":"#/components/schemas/LinkableAssetIdentifier"},"type":"array"},{"type":"null"}],"title":"Linked Assets"},"custom_attributes":{"anyOf":[{"items":{"anyOf":[{"$ref":"#/components/schemas/IntegerAttributeWrite"},{"$ref":"#/components/schemas/TextAttributeWrite"},{"$ref":"#/components/schemas/BooleanAttributeWrite"},{"$ref":"#/components/schemas/EnumAttributeWrite"},{"$ref":"#/components/schemas/UserAttributeWrite"}]},"type":"array"},{"type":"null"}],"title":"Custom Attributes","description":"List of custom attributes to set on the asset. This will overwrite existing custom attributes. If an empty list is provided, all custom attributes will be cleared."}},"type":"object","required":["asset_id","asset_type"],"title":"ModifiableTermAttributes"},"LinkableAssetIdentifier":{"properties":{"type":{"type":"string","enum":["dataset","property","dashboard","chart","data_job","collection","source"],"title":"Type"},"id":{"type":"integer","minimum":0,"title":"Id","description":"Unique identifier of the linkable asset"}},"type":"object","required":["type","id"],"title":"LinkableAssetIdentifier"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}
```


---

# Agent Instructions: Querying This Documentation

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

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

```
GET https://docs.decube.io/public-api/overview/index/assets.md?ask=<question>
```

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

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