The Data Mapping Automation APIs are used to manage structured records (assets, vendors, processing activities, and legal entities), define schema attributes, traverse parent–child hierarchies, and cr eate cross-record relationships—including links to personal data. (58 operations.)
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/privacy-automation-data-mapping-automation"curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
{"openapi":"3.1.0","info":{"title":"Privacy Automation - Data Mapping Automation","version":"1.0","contact":{"name":"OneTrust Support","url":"https://my.onetrust.com/s/contactsupport"},"license":{"name":"Apache 2.0","url":"https://www.apache.org/licenses/LICENSE-2.0"},"description":"The Data Mapping Automation APIs are used to manage structured records (assets, vendors, processing activities, and legal entities), define schema attributes, traverse parent–child hierarchies, and create cross-record relationships—including links to personal data."},"servers":[{"url":"https://{hostname}","variables":{"hostname":{"default":"hostname","description":"The OneTrust hostname such as app.onetrust.com, app-eu.onetrust.com, app-de.onetrust.com, app-uk.onetrust.com, app-apac.onetrust.com, trial.onetrust.com, or uat.onetrust.com."}}}],"tags":[{"name":"Inventory","description":"APIs used to create and manage inventory records for supported schema types (processing-activities, vendors, assets, entities).","externalDocs":{"description":"OpenAPI 3.1.0 - Download Definition","url":"https://developer.onetrust.com/onetrust/openapi/privacy-automation-data-mapping-automation.json"}},{"name":"Inventory Hierarchies","description":"APIs used to list, link, and unlink child inventories under a root inventory to model organizational or data-flow trees.","externalDocs":{"description":"OpenAPI 3.1.0 - Download Definition","url":"https://developer.onetrust.com/onetrust/openapi/privacy-automation-data-mapping-automation.json"}},{"name":"Inventory Relationships V1","description":"APIs used to create, update, and delete bidirectional links between inventories and to manage associations to related items (including personal data).","externalDocs":{"description":"OpenAPI 3.1.0 - Download Definition","url":"https://developer.onetrust.com/onetrust/openapi/privacy-automation-data-mapping-automation.json"}},{"name":"Inventory Schema","description":"APIs used to define and maintain schema attributes that shape inventory data collection and validation.","externalDocs":{"description":"OpenAPI 3.1.0 - Download Definition","url":"https://developer.onetrust.com/onetrust/openapi/privacy-automation-data-mapping-automation.json"}},{"name":"Personal Data","description":"APIs used to list links to personal-data items for an inventory and update advanced attributes on those associations.","externalDocs":{"description":"OpenAPI 3.1.0 - Download Definition","url":"https://developer.onetrust.com/onetrust/openapi/privacy-automation-data-mapping-automation.json"}}],"x-onetrust":{"spec-label":"OpenAPI 3.1.0","links":["{'Data Mapping Automation Knowledge Base': 'https://my.onetrust.com/s/topic/0TO1Q000000ItRxWAK/data-mapping-automation'}"]},"x-readme":{"explorer-enabled":false,"proxy-enabled":false,"metrics-enabled":false},"paths":{"/api/inventory/v2/data-categories":{"get":{"operationId":"getDataCategoriesByPartialNameUsingGET","summary":"Get List of Data Categories","description":"Use this API to retrieve a list of all existing Data Categories.","tags":["Personal Data"],"x-onetrust":{"spec-label":"https://developer.onetrust.com/onetrust/openapi/privacy-automation-data-mapping-automation.json"},"parameters":[{"name":"filter","in":"query","description":"Optional filter string to search data categories by name","required":false,"schema":{"type":"string"},"example":"Financial"},{"name":"page","in":"query","description":"Results page to be retrieved (0..N)","schema":{"type":"integer","format":"int32","default":0,"minimum":0},"example":0},{"name":"size","in":"query","description":"Number of records per page (1..50)","schema":{"type":"integer","format":"int32","default":20,"maximum":50,"minimum":1},"example":20},{"name":"sort","in":"query","description":"Sorting criteria in the format: property(,asc|desc). Default sort order is ascending","schema":{"type":"string","enum":["name,asc","name,desc","createdDate,asc","createdDate,desc"]},"example":"name,asc"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/OneTrustResponseListDataCategoryResponse"},{"$ref":"#/components/schemas/DataCategoryResponse"}]}}}},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"},"429":{"description":"Too Many Requests. \nFor more information, see [API Rate Limits](https://developer.onetrust.com/onetrust/reference/rate-limits-overview).","headers":{"Retry-After":{"schema":{"description":"The number of seconds after which requests will be allowed again.","format":"int32"}},"ot-period":{"schema":{"description":"The unit of time for which the rate limit applies","enum":["HOUR","MINUTE"]}},"ot-ratelimit-event-id":{"schema":{"description":"The unique identifier for the rate-limiting event.","format":"uuid"}},"ot-request-made":{"schema":{"description":"The number of requests made within the specified period.","format":"int32"}},"ot-requests-allowed":{"schema":{"description":"The number of requests allowed within the specified period.","format":"int32"}}}},"500":{"description":"Internal Server Error"}},"security":[{"OAUTH2":["INTEGRATION"]},{"OAUTH2":["INVENTORY","INVENTORY_READ","INVENTORY_WRITE"]}]},"post":{"operationId":"createDataCategoryUsingPOST","summary":"Create Data Category","description":"Use this API to to create new Data Categories in Data Mapping Automation module.","tags":["Personal Data"],"x-onetrust":{"spec-label":"https://developer.onetrust.com/onetrust/openapi/privacy-automation-data-mapping-automation.json"},"parameters":[{"name":"generator","in":"query","description":"Optional generator parameter","required":false,"schema":{"type":"string"},"example":"system"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataCategoryCreateUpdateRequest"}}}},"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataCategoryResponse"}}}},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"},"429":{"description":"Too Many Requests. \nFor more information, see [API Rate Limits](https://developer.onetrust.com/onetrust/reference/rate-limits-overview).","headers":{"Retry-After":{"schema":{"description":"The number of seconds after which requests will be allowed again.","format":"int32"}},"ot-period":{"schema":{"description":"The unit of time for which the rate limit applies","enum":["HOUR","MINUTE"]}},"ot-ratelimit-event-id":{"schema":{"description":"The unique identifier for the rate-limiting event.","format":"uuid"}},"ot-request-made":{"schema":{"description":"The number of requests made within the specified period.","format":"int32"}},"ot-requests-allowed":{"schema":{"description":"The number of requests allowed within the specified period.","format":"int32"}}}},"500":{"description":"Internal Server Error"}},"security":[{"OAUTH2":["INVENTORY","INVENTORY_WRITE"]}]}},"/api/inventory/v2/data-categories/{id}":{"get":{"operationId":"getDataCategoryUsingGET","summary":"Get Data Category","description":"Use this API to provide the details of a single Data Category by ID.","tags":["Personal Data"],"x-onetrust":{"spec-label":"https://developer.onetrust.com/onetrust/openapi/privacy-automation-data-mapping-automation.json"},"parameters":[{"name":"id","in":"path","description":"The ID of the data category to retrieve","required":true,"schema":{"type":"string","format":"uuid"},"example":"43fd3a8d-3f6b-464e-bf43-3f0c6c592442"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataCategoryResponse"}}}},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"},"429":{"description":"Too Many Requests. \nFor more information, see [API Rate Limits](https://developer.onetrust.com/onetrust/reference/rate-limits-overview).","headers":{"Retry-After":{"schema":{"description":"The number of seconds after which requests will be allowed again.","format":"int32"}},"ot-period":{"schema":{"description":"The unit of time for which the rate limit applies","enum":["HOUR","MINUTE"]}},"ot-ratelimit-event-id":{"schema":{"description":"The unique identifier for the rate-limiting event.","format":"uuid"}},"ot-request-made":{"schema":{"description":"The number of requests made within the specified period.","format":"int32"}},"ot-requests-allowed":{"schema":{"description":"The number of requests allowed within the specified period.","format":"int32"}}}},"500":{"description":"Internal Server Error"}},"security":[{"OAUTH2":["INVENTORY","INVENTORY_READ","INVENTORY_WRITE"]}]},"delete":{"operationId":"deleteDataCategoryUsingDELETE","summary":"Delete Data Category","description":"Use this API to delete Data Categories within the Data Mapping Automation Module of OneTrust. To successfully delete a data category, there must be no data-elements assigned to the data category.","tags":["Personal Data"],"x-onetrust":{"spec-label":"https://developer.onetrust.com/onetrust/openapi/privacy-automation-data-mapping-automation.json"},"parameters":[{"name":"id","in":"path","description":"The ID of the data category to delete","required":true,"schema":{"type":"string","format":"uuid"},"example":"43fd3a8d-3f6b-464e-bf43-3f0c6c592442"}],"responses":{"204":{"description":"No Content"},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"},"429":{"description":"Too Many Requests. \nFor more information, see [API Rate Limits](https://developer.onetrust.com/onetrust/reference/rate-limits-overview).","headers":{"Retry-After":{"schema":{"description":"The number of seconds after which requests will be allowed again.","format":"int32"}},"ot-period":{"schema":{"description":"The unit of time for which the rate limit applies","enum":["HOUR","MINUTE"]}},"ot-ratelimit-event-id":{"schema":{"description":"The unique identifier for the rate-limiting event.","format":"uuid"}},"ot-request-made":{"schema":{"description":"The number of requests made within the specified period.","format":"int32"}},"ot-requests-allowed":{"schema":{"description":"The number of requests allowed within the specified period.","format":"int32"}}}},"500":{"description":"Internal Server Error"}},"security":[{"OAUTH2":["INVENTORY"]}]}},"/api/inventory/v2/data-classifications":{"get":{"operationId":"listAllDataClassificationsUsingGET","summary":"Get List of Data Classifications","description":"Use this API to retrieve a list of all existing Data Classifications.\n\n### Example Request\n\n`GET https://{hostname}/api/inventory/v2/data-classifications`\n\n`GET https://trial.onetrust.com/api/inventory/v2/data-classifications`","tags":["Personal Data"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataClassificationResponse"}}}},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"},"429":{"description":"Too Many Requests. \nFor more information, see [API Rate Limits](https://developer.onetrust.com/onetrust/reference/rate-limits-overview).","headers":{"Retry-After":{"schema":{"description":"The number of seconds after which requests will be allowed again.","format":"int32"}},"ot-period":{"schema":{"description":"The unit of time for which the rate limit applies","enum":["HOUR","MINUTE"]}},"ot-ratelimit-event-id":{"schema":{"description":"The unique identifier for the rate-limiting event.","format":"uuid"}},"ot-request-made":{"schema":{"description":"The number of requests made within the specified period.","format":"int32"}},"ot-requests-allowed":{"schema":{"description":"The number of requests allowed within the specified period.","format":"int32"}}}},"500":{"description":"Internal Server Error"}},"security":[{"OAUTH2":["INTEGRATION"]}]},"post":{"operationId":"createDataClassificationUsingPOST","summary":"Create Data Classification","description":"Use this API to create new Data Mapping Automation-Data Classification.","tags":["Personal Data"],"x-onetrust":{"spec-label":"https://developer.onetrust.com/onetrust/openapi/privacy-automation-data-mapping-automation.json"},"parameters":[{"name":"generator","in":"query","description":"Optional generator parameter","required":false,"schema":{"type":"string"},"example":"system"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataClassificationCreateUpdateRequest"}}}},"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataClassificationResponse"}}}},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"},"429":{"description":"Too Many Requests. \nFor more information, see [API Rate Limits](https://developer.onetrust.com/onetrust/reference/rate-limits-overview).","headers":{"Retry-After":{"schema":{"description":"The number of seconds after which requests will be allowed again.","format":"int32"}},"ot-period":{"schema":{"description":"The unit of time for which the rate limit applies","enum":["HOUR","MINUTE"]}},"ot-ratelimit-event-id":{"schema":{"description":"The unique identifier for the rate-limiting event.","format":"uuid"}},"ot-request-made":{"schema":{"description":"The number of requests made within the specified period.","format":"int32"}},"ot-requests-allowed":{"schema":{"description":"The number of requests allowed within the specified period.","format":"int32"}}}},"500":{"description":"Internal Server Error"}},"security":[{"OAUTH2":["INVENTORY","INVENTORY_WRITE"]}]}},"/api/inventory/v2/data-classifications/{id}":{"get":{"operationId":"getDataClassificationUsingGET","summary":"Get Data Classification","description":"Use this API to retrieve the details of a single Data Classification by ID.","tags":["Personal Data"],"x-onetrust":{"spec-label":"https://developer.onetrust.com/onetrust/openapi/privacy-automation-data-mapping-automation.json"},"parameters":[{"name":"id","in":"path","description":"The ID of the data classification to retrieve","required":true,"schema":{"type":"string","format":"uuid"},"example":"43fd3a8d-3f6b-464e-bf43-3f0c6c592442"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataClassificationResponse"}}}},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"},"429":{"description":"Too Many Requests. \nFor more information, see [API Rate Limits](https://developer.onetrust.com/onetrust/reference/rate-limits-overview).","headers":{"Retry-After":{"schema":{"description":"The number of seconds after which requests will be allowed again.","format":"int32"}},"ot-period":{"schema":{"description":"The unit of time for which the rate limit applies","enum":["HOUR","MINUTE"]}},"ot-ratelimit-event-id":{"schema":{"description":"The unique identifier for the rate-limiting event.","format":"uuid"}},"ot-request-made":{"schema":{"description":"The number of requests made within the specified period.","format":"int32"}},"ot-requests-allowed":{"schema":{"description":"The number of requests allowed within the specified period.","format":"int32"}}}},"500":{"description":"Internal Server Error"}},"security":[{"OAUTH2":["INVENTORY","INVENTORY_READ","INVENTORY_WRITE"]}]},"delete":{"operationId":"deleteDataClassificationUsingDELETE","summary":"Delete Data Classification","description":"Use this API to delete a data category, the Data Classification ID must be provided in the URL path.","tags":["Personal Data"],"x-onetrust":{"spec-label":"https://developer.onetrust.com/onetrust/openapi/privacy-automation-data-mapping-automation.json"},"parameters":[{"name":"id","in":"path","description":"The ID of the data classification to delete","required":true,"schema":{"type":"string","format":"uuid"},"example":"43fd3a8d-3f6b-464e-bf43-3f0c6c592442"}],"responses":{"204":{"description":"No Content"},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"},"429":{"description":"Too Many Requests. \nFor more information, see [API Rate Limits](https://developer.onetrust.com/onetrust/reference/rate-limits-overview).","headers":{"Retry-After":{"schema":{"description":"The number of seconds after which requests will be allowed again.","format":"int32"}},"ot-period":{"schema":{"description":"The unit of time for which the rate limit applies","enum":["HOUR","MINUTE"]}},"ot-ratelimit-event-id":{"schema":{"description":"The unique identifier for the rate-limiting event.","format":"uuid"}},"ot-request-made":{"schema":{"description":"The number of requests made within the specified period.","format":"int32"}},"ot-requests-allowed":{"schema":{"description":"The number of requests allowed within the specified period.","format":"int32"}}}},"500":{"description":"Internal Server Error"}},"security":[{"OAUTH2":["INVENTORY"]}]}},"/api/inventory/v2/data-elements":{"get":{"operationId":"listAllDataElementsUsingGET","summary":"Get List of Data Elements","description":"Use this API to retrieve the list of all existing Data Elements. \n\n### Example Request\n\n`GET https://{hostname}/api/inventory/v2/data-elements`\n\n`GET https://trial.onetrust.com/api/inventory/v2/data-elements`","tags":["Personal Data"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataElementDetailedResponse"}}}},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"},"429":{"description":"Too Many Requests. \nFor more information, see [API Rate Limits](https://developer.onetrust.com/onetrust/reference/rate-limits-overview).","headers":{"Retry-After":{"schema":{"description":"The number of seconds after which requests will be allowed again.","format":"int32"}},"ot-period":{"schema":{"description":"The unit of time for which the rate limit applies","enum":["HOUR","MINUTE"]}},"ot-ratelimit-event-id":{"schema":{"description":"The unique identifier for the rate-limiting event.","format":"uuid"}},"ot-request-made":{"schema":{"description":"The number of requests made within the specified period.","format":"int32"}},"ot-requests-allowed":{"schema":{"description":"The number of requests allowed within the specified period.","format":"int32"}}}},"500":{"description":"Internal Server Error"}},"security":[{"OAUTH2":["INTEGRATION"]}]},"post":{"operationId":"createDataElementUsingPOST","summary":"Create Data Element","description":"Use this API to create new Data Elements in Data Mapping Automation module.","tags":["Personal Data"],"x-onetrust":{"spec-label":"https://developer.onetrust.com/onetrust/openapi/privacy-automation-data-mapping-automation.json"},"parameters":[{"name":"generator","in":"query","description":"Optional generator parameter","required":false,"schema":{"type":"string"},"example":"system"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataElementCreateRequest"}}}},"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataElementDetailedResponse"}}}},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"},"429":{"description":"Too Many Requests. \nFor more information, see [API Rate Limits](https://developer.onetrust.com/onetrust/reference/rate-limits-overview).","headers":{"Retry-After":{"schema":{"description":"The number of seconds after which requests will be allowed again.","format":"int32"}},"ot-period":{"schema":{"description":"The unit of time for which the rate limit applies","enum":["HOUR","MINUTE"]}},"ot-ratelimit-event-id":{"schema":{"description":"The unique identifier for the rate-limiting event.","format":"uuid"}},"ot-request-made":{"schema":{"description":"The number of requests made within the specified period.","format":"int32"}},"ot-requests-allowed":{"schema":{"description":"The number of requests allowed within the specified period.","format":"int32"}}}},"500":{"description":"Internal Server Error"}},"security":[{"OAUTH2":["INVENTORY","INVENTORY_WRITE"]}]}},"/api/inventory/v2/data-elements/{id}":{"get":{"operationId":"getDataElementUsingGET","summary":"Get Data Element","description":"Use this API to retrieve the details of a single Data Element by ID.","tags":["Personal Data"],"x-onetrust":{"spec-label":"https://developer.onetrust.com/onetrust/openapi/privacy-automation-data-mapping-automation.json"},"parameters":[{"name":"id","in":"path","description":"The ID of the data element to retrieve","required":true,"schema":{"type":"string","format":"uuid"},"example":"43fd3a8d-3f6b-464e-bf43-3f0c6c592442"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataElementDetailedResponse"}}}},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"},"429":{"description":"Too Many Requests. \nFor more information, see [API Rate Limits](https://developer.onetrust.com/onetrust/reference/rate-limits-overview).","headers":{"Retry-After":{"schema":{"description":"The number of seconds after which requests will be allowed again.","format":"int32"}},"ot-period":{"schema":{"description":"The unit of time for which the rate limit applies","enum":["HOUR","MINUTE"]}},"ot-ratelimit-event-id":{"schema":{"description":"The unique identifier for the rate-limiting event.","format":"uuid"}},"ot-request-made":{"schema":{"description":"The number of requests made within the specified period.","format":"int32"}},"ot-requests-allowed":{"schema":{"description":"The number of requests allowed within the specified period.","format":"int32"}}}},"500":{"description":"Internal Server Error"}},"security":[{"OAUTH2":["INVENTORY","INVENTORY_READ","INVENTORY_WRITE"]}]},"delete":{"operationId":"deleteDataElementUsingDELETE","summary":"Delete Data Element","description":"Use this API to delete a data element.","tags":["Personal Data"],"x-onetrust":{"spec-label":"https://developer.onetrust.com/onetrust/openapi/privacy-automation-data-mapping-automation.json"},"parameters":[{"name":"id","in":"path","description":"The ID of the data element to delete","required":true,"schema":{"type":"string","format":"uuid"},"example":"43fd3a8d-3f6b-464e-bf43-3f0c6c592442"}],"responses":{"204":{"description":"No Content"},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"},"429":{"description":"Too Many Requests. \nFor more information, see [API Rate Limits](https://developer.onetrust.com/onetrust/reference/rate-limits-overview).","headers":{"Retry-After":{"schema":{"description":"The number of seconds after which requests will be allowed again.","format":"int32"}},"ot-period":{"schema":{"description":"The unit of time for which the rate limit applies","enum":["HOUR","MINUTE"]}},"ot-ratelimit-event-id":{"schema":{"description":"The unique identifier for the rate-limiting event.","format":"uuid"}},"ot-request-made":{"schema":{"description":"The number of requests made within the specified period.","format":"int32"}},"ot-requests-allowed":{"schema":{"description":"The number of requests allowed within the specified period.","format":"int32"}}}},"500":{"description":"Internal Server Error"}},"security":[{"OAUTH2":["INVENTORY"]}]}},"/api/inventory/v2/data-subjects":{"get":{"operationId":"getDataSubjectsByPartialNameUsingGET","summary":"Get List of Data Subjects","description":"Use this API to retrieve the list of all existing Data Subjects.","tags":["Personal Data"],"x-onetrust":{"spec-label":"https://developer.onetrust.com/onetrust/openapi/privacy-automation-data-mapping-automation.json"},"parameters":[{"name":"objectType","in":"query","required":false,"schema":{"type":"string"}},{"name":"objectId","in":"query","required":false,"schema":{"type":"string","format":"uuid"}},{"name":"relationshipContext","in":"query","required":false,"schema":{"type":"boolean","default":false}},{"name":"filter","in":"query","description":"Optional filter string to search data subjects by name","required":false,"schema":{"type":"string"},"example":"Customer"},{"name":"page","in":"query","description":"Results page to be retrieved (0..N)","schema":{"type":"integer","format":"int32","default":0,"minimum":0},"example":0},{"name":"size","in":"query","description":"Number of records per page (1..50)","schema":{"type":"integer","format":"int32","default":20,"maximum":50,"minimum":1},"example":20},{"name":"sort","in":"query","description":"Sorting criteria in the format: property(,asc|desc). Default sort order is ascending","schema":{"type":"string","enum":["name,asc","name,desc","createdDate,asc","createdDate,desc"]},"example":"name,asc"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/OneTrustResponseListDataSubjectResponse"},{"$ref":"#/components/schemas/DataSubjectResponse"}]}}}},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"},"429":{"description":"Too Many Requests. \nFor more information, see [API Rate Limits](https://developer.onetrust.com/onetrust/reference/rate-limits-overview).","headers":{"Retry-After":{"schema":{"description":"The number of seconds after which requests will be allowed again.","format":"int32"}},"ot-period":{"schema":{"description":"The unit of time for which the rate limit applies","enum":["HOUR","MINUTE"]}},"ot-ratelimit-event-id":{"schema":{"description":"The unique identifier for the rate-limiting event.","format":"uuid"}},"ot-request-made":{"schema":{"description":"The number of requests made within the specified period.","format":"int32"}},"ot-requests-allowed":{"schema":{"description":"The number of requests allowed within the specified period.","format":"int32"}}}},"500":{"description":"Internal Server Error"}},"security":[{"OAUTH2":["INTEGRATION"]},{"OAUTH2":["INVENTORY","INVENTORY_READ","INVENTORY_WRITE"]}]},"post":{"operationId":"createDataSubjectUsingPOST","summary":"Create Data Subject","description":"Use this API to create new Data Subject in the Data Mapping Automation Module.","tags":["Personal Data"],"x-onetrust":{"spec-label":"https://developer.onetrust.com/onetrust/openapi/privacy-automation-data-mapping-automation.json"},"parameters":[{"name":"generator","in":"query","required":false,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataSubjectCreateUpdateRequest"}}}},"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataSubjectResponse"}}}},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"},"429":{"description":"Too Many Requests. \nFor more information, see [API Rate Limits](https://developer.onetrust.com/onetrust/reference/rate-limits-overview).","headers":{"Retry-After":{"schema":{"description":"The number of seconds after which requests will be allowed again.","format":"int32"}},"ot-period":{"schema":{"description":"The unit of time for which the rate limit applies","enum":["HOUR","MINUTE"]}},"ot-ratelimit-event-id":{"schema":{"description":"The unique identifier for the rate-limiting event.","format":"uuid"}},"ot-request-made":{"schema":{"description":"The number of requests made within the specified period.","format":"int32"}},"ot-requests-allowed":{"schema":{"description":"The number of requests allowed within the specified period.","format":"int32"}}}},"500":{"description":"Internal Server Error"}},"security":[{"OAUTH2":["INVENTORY","INVENTORY_WRITE"]}]}},"/api/inventory/v2/data-subjects/{id}":{"get":{"operationId":"getDataSubjectUsingGET","summary":"Get Data Subject","description":"Use this API to retrieve the details of a single Data Subject by ID.","tags":["Personal Data"],"x-onetrust":{"spec-label":"https://developer.onetrust.com/onetrust/openapi/privacy-automation-data-mapping-automation.json"},"parameters":[{"name":"id","in":"path","description":"The ID of the Data Subject","required":true,"schema":{"type":"string","format":"uuid"},"example":"43fd3a8d-3f6b-464e-bf43-3f0c6c592442"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataSubjectResponse"}}}},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"},"429":{"description":"Too Many Requests. \nFor more information, see [API Rate Limits](https://developer.onetrust.com/onetrust/reference/rate-limits-overview).","headers":{"Retry-After":{"schema":{"description":"The number of seconds after which requests will be allowed again.","format":"int32"}},"ot-period":{"schema":{"description":"The unit of time for which the rate limit applies","enum":["HOUR","MINUTE"]}},"ot-ratelimit-event-id":{"schema":{"description":"The unique identifier for the rate-limiting event.","format":"uuid"}},"ot-request-made":{"schema":{"description":"The number of requests made within the specified period.","format":"int32"}},"ot-requests-allowed":{"schema":{"description":"The number of requests allowed within the specified period.","format":"int32"}}}},"500":{"description":"Internal Server Error"}},"security":[{"OAUTH2":["INVENTORY","INVENTORY_READ","INVENTORY_WRITE"]}]},"delete":{"operationId":"deleteDataSubjectUsingDELETE","summary":"Delete Data Subject","description":"Use this API to delete a data element.","tags":["Personal Data"],"x-onetrust":{"spec-label":"https://developer.onetrust.com/onetrust/openapi/privacy-automation-data-mapping-automation.json"},"parameters":[{"name":"id","in":"path","description":"The ID of the data subject to delete","required":true,"schema":{"type":"string","format":"uuid"},"example":"43fd3a8d-3f6b-464e-bf43-3f0c6c592442"}],"responses":{"204":{"description":"No Content"},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"},"429":{"description":"Too Many Requests. \nFor more information, see [API Rate Limits](https://developer.onetrust.com/onetrust/reference/rate-limits-overview).","headers":{"Retry-After":{"schema":{"description":"The number of seconds after which requests will be allowed again.","format":"int32"}},"ot-period":{"schema":{"description":"The unit of time for which the rate limit applies","enum":["HOUR","MINUTE"]}},"ot-ratelimit-event-id":{"schema":{"description":"The unique identifier for the rate-limiting event.","format":"uuid"}},"ot-request-made":{"schema":{"description":"The number of requests made within the specified period.","format":"int32"}},"ot-requests-allowed":{"schema":{"description":"The number of requests allowed within the specified period.","format":"int32"}}}},"500":{"description":"Internal Server Error"}},"security":[{"OAUTH2":["INVENTORY"]}]}},"/api/inventory/v2/inventories/{id}/associations/{associationId}":{"put":{"operationId":"updateInventoryAssociationUsingPUT","summary":"Update Inventory Link","description":"Use this API to update a bidirectional link between two inventories.","tags":["Inventory Relationships V1"],"x-onetrust":{"spec-label":"https://developer.onetrust.com/onetrust/openapi/privacy-automation-data-mapping-automation.json"},"parameters":[{"name":"id","in":"path","description":"The unique identifier of an inventory record","required":true,"schema":{"type":"string","format":"uuid"},"example":"43fd3a8d-3f6b-464e-bf43-3f0c6c592442"},{"name":"associationId","in":"path","description":"The unique identifier of the association","required":true,"schema":{"type":"string","format":"uuid"},"example":"4374d5da-44ac-4308-a298-3efdb0f34ba4"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InventoryAssociationRequest"}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404"
# --- truncated at 32 KB (270 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/onetrust/refs/heads/main/openapi/onetrust-privacy-automation-data-mapping-automation-openapi.json