---
title: "Create Data Asset"
method: POST
path: "/api/data-governance/v1/data-assets"
tags: ["Data Assets"]
---

# Create Data Asset

`POST /api/data-governance/v1/data-assets`

Use this API to create a new data asset or upsert an existing data asset. Data assets must be added using a structured top-down hierarchy to ensure consistent data organization. The request must include all required data asset details, such as the parent ID, name, type, and data source. The response will confirm successful ingestion with the assigned data asset ID.

Things to Know
- If terms, tags, additional attributes, or users are added to an existing data asset, the system will merge the new values from the request with the existing values.
- With the exception of the root (data source) node, every data asset must have its parent record already present in the system before being added.

## Request body

- DataUseGovernanceDataAssetManagementDataAssetUpsertRequest
  - `name` string, required — The name of the data asset.
  - `shortDescription` string — The description of the data asset.
  - `dataSource` DataUseGovernanceDataAssetManagementDataSource, required
    - `id` string, uuid — The unique identifier of the data source.
    - `name` string — The name of the data source.
    - `systemType` 'AWS' | 'Azure' | 'AzureCosmos' | 'AzureStorage' | 'Box' | 'Cassandra' | 'Databricks' | 'IBMDB2' | 'Exchange' | 'GCP' | 'GoogleWorkspaceGmail' | 'GoogleBigQuery' | 'GoogleBigTable' | 'MongoDB' | 'MySQL' | 'Netezza' | 'Office365' | 'OneDrive' | 'OracleRDBMS' | 'PostgreSQL' | 'AmazonS3' | 'AmazonSageMaker' | 'SalesForce' | 'SAPHana' | 'ServiceNow' | 'SharePoint' | 'SMB' | 'Snowflake' | 'MicrosoftSQL' | 'Teradata' | 'Workday' | 'Zendesk' | 'AmazonRDSforSQLServer' | 'AzureSQLServer' | 'Redshift' | 'GoogleDrive' | 'CustomConnector' | 'AmazonDynamoDB' | 'AmazonAthena' | 'Hive' | 'SharePoint2019OnPrem' | 'GenericJDBC' | 'SFTP' | 'NFS' | 'GCS' | 'Redis' | 'ElasticSearch' | 'MicrosoftTeams' | 'Slack' | 'AlibabaCloudOSS' | 'AzureFiles' | 'Iceberg' | 'NGFSFILES' | 'Github' | 'RELATIONAL_DATABASE' | 'NON_RELATIONAL_DATABASE' | 'FILE' | 'API' | 'Kafka' — The type of data source.
  - `type` 'DATASOURCE' | 'DATABASE' | 'OBJECT' | 'SCHEMA' | 'CATALOG' | 'TABLE' | 'COLUMN' | 'FIELD' | 'FOLDER' | 'FILE' | 'DRIVE' | 'FILE_SYSTEM' | 'VIEW' | 'DIRECTORY', required — The type of data asset.
  - `parentId` string, uuid, required — The unique identifier of the parent object. This parameter value is null for `type`: `DATASOURCE`.
  - `oneTrustSourceSystemId` string, uuid — The unique identifier of the data source.
  - `technicalOwners` string[] — The unique identifier(s) of the technical owner(s) responsible for managing the technical details of the data asset.
  - `businessOwners` string[] — The unique identifier(s) of the business owner(s) responsible for defining and updating the business context of the glossary.
  - `dataStewards` string[] — The unique identifier(s) of the data steward(s) responsible for utilizing data governance processes to ensure data reliability and validity within a data asset or business unit.
  - `pii` boolean — This flag indicates whether the data asset is classified as PII.
  - `additionalAttributes` DataUseGovernanceDataAssetManagementMetadataValueDto[] — The details of the associated attributes.
    - `name` string, required — The name of the attribute.
    - `displayName` string — The display name of the attribute.
    - `value` object, required — The value of the attribute.
    - `dataType` 'LONG' | 'STRING' | 'DATE' | 'TIMESTAMP' — The data type of the attribute.
    - `custom` boolean — This flag indicates whether the attribute is a custom attribute.
  - `terms` DataUseGovernanceDataAssetManagementDataAssetTermAssociationRequest[] — The list of associated terms.
    - `termId` string, uuid, required — Unique identifier of the Glossary Term
    - `termName` string, required — Name of the Glossary Term
  - `tags` DataUseGovernanceDataAssetManagementDataAssetTagAssociationRequest[] — The list of associated classification tags.
    - `tagId` string, uuid, required — Unique identifier of the Glossary Tag
    - `tagName` string, required — Name of the Glossary Tag

## Response `201`

Created

- DataUseGovernanceDataAssetManagementDataAssetBasicResponse
  - `id` string, uuid — The unique identifier of the data asset.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `429` — Too Many Requests. For more information, see [API Rate Limits](https://developer.onetrust.com/onetrust/reference/rate-limits-overview).
- `500` — Internal Server Error

---

[API](https://skmtc.net/onetrust/apis/platform-access-management.md) · [All operations](https://skmtc.net/onetrust/apis/platform-access-management/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/onetrust/platform-access-management/versions/21de3aa0b170/schema)