--- updatedAt: 2026-05-27T12:50:37.000Z agentTools: projectIndex: https://developer.onetrust.com/onetrust/llms.txt --- # Submit Data to Classify Use this API to submit content for classification for a given custom connecter scan job. > 🗒 Things to Know > > * This API is for directly communicating with the on-premises worker node. This API does not communicate with the OneTrust application, hence your hostname will be the hostname of your worker node. For more information, see [API Access for Worker Node Management](https://my.onetrust.com/s/article/UUID-074fbd5c-206a-2efa-7444-b2698da6b4f2). > * For more information on using this API, see [Custom Scan using Worker Node APIs](/onetrust/docs/custom-scan-using-worker-node-apis). # OpenAPI definition ```json { "openapi": "3.0.1", "info": { "title": "Data Use Governance - Data Discovery Worker Node", "description": "The Data Discovery Worker Node APIs enables secure communication with an on-premises Data Discovery worker node. It provides operations to retrieve, classify, and catalog data from connected data sources, as well as manage and update custom connector scan jobs. Unlike the main OneTrust application APIs, this API communicates directly with your worker node instance, using its hostname, FQDN, or IP address.", "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" } }, "servers": [ { "url": "https://{hostname}:8080/api/data-discovery-bridge", "description": "This API is for directly communicating with the on-premises worker node. This API does not communicate with the OneTrust application, hence your hostname will be the hostname of your worker node.", "variables": { "hostname": { "default": "localhost", "description": "This API is for directly communicating with the on-premises worker node. This API does not communicate with the OneTrust application, hence your hostname will be the hostname, FQDN, or IP address of your worker node." } } } ], "tags": [ { "name": "Custom Scan", "description": "APIs to manage and execute custom data discovery scans across specified data sources.", "externalDocs": { "description": "OpenAPI 3.0.1 - Download Definition", "url": "https://developer.onetrust.com/onetrust/openapi/data-use-governance-data-discovery-worker-node.json" } } ], "x-onetrust": { "spec-label": "OpenAPI 3.0.1", "links": [ { "Data Discovery Knowledge Base": "https://my.onetrust.com/s/topic/0TO1Q000000bHtnWAE/datadiscovery" }, "{'Data Discovery Knowledge Base': 'https://my.onetrust.com/s/topic/0TO1Q000000bHtnWAE/datadiscovery'}" ] }, "x-readme": { "explorer-enabled": false, "proxy-enabled": false, "metrics-enabled": false }, "paths": { "/v1/jobs/{jobId}/classify-data": { "post": { "operationId": "classifyDataUsingPOST", "summary": "Submit Data to Classify", "description": "Use this API to submit content for classification for a given custom connecter scan job.", "tags": [ "Custom Scan" ], "x-onetrust": { "spec-label": "https://developer.onetrust.com/onetrust/openapi/data-use-governance-data-discovery-worker-node.json" }, "parameters": [ { "name": "jobId", "in": "path", "description": "The custom connector scan job's identifier. This value can be obtained using the [Get List of Scan Jobs](/onetrust/reference/geteligiblejobsusingget) API.", "required": true, "schema": { "type": "integer", "format": "int64", "minimum": 1 }, "example": 10 } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClassificationRequest" } } } }, "responses": { "200": { "description": "OK" }, "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" } } } } } } } }, "components": { "schemas": { "ClassificationRequest": { "type": "object", "properties": { "jobId": { "description": "The custom connector scan job's identifier. This value can be obtained using the [Get List of Scan Jobs](/onetrust/reference/geteligiblejobsusingget) API.", "type": "integer", "format": "int64", "example": 10, "minimum": 1 }, "datasourceId": { "description": "The data source's identifier. This value can be obtained using the [Get Data Sources](/onetrust/reference/getallusingget_1) API.", "type": "string", "example": "123e4567-e89b-12d3-a456-426655440000" }, "structured": { "description": "Flag to determine whether the data source is a structured or unstructured source.", "type": "boolean", "example": true }, "totalCount": { "description": "Total Count of rows or lines sent for a given column/file.", "type": "integer", "format": "int64", "example": 100, "minimum": 1 }, "content": { "description": "List of content details from the data source.", "items": { "$ref": "#/components/schemas/ContentDetails" }, "type": "array" } }, "required": [ "content", "datasourceId", "jobId" ] }, "ContentDetails": { "type": "object", "properties": { "entityName": { "description": "Entity Name", "type": "string", "example": "first_name" }, "entityType": { "description": "Entity Type", "type": "string", "example": "COLUMN", "enum": [ "DATABASE", "SCHEMA", "CATALOG", "TABLE", "COLUMN", "FOLDER", "FILE" ] }, "parentEntityName": { "description": "Parent Entity Name", "type": "string", "example": "Employee" }, "parentEntityType": { "description": "Parent Entity Type", "type": "string", "example": "TABLE", "enum": [ "DATASOURCE", "DATABASE", "SCHEMA", "CATALOG", "TABLE", "FOLDER" ] }, "parentXpath": { "type": "array", "items": { "type": "string" }, "example": [ "Company, Employee" ] }, "endOfContent": { "description": "Flag to determine whether this request is the final request for a given column/file.", "type": "boolean", "example": true }, "data": { "description": "List of content to classify.", "type": "array", "items": { "type": "string", "description": "List of content to classify." }, "example": [ "Donald" ] } }, "required": [ "entityName", "entityType", "parentEntityType", "parentXpath" ] } } } } ``` # Sibling pages * [Get List of Scan Jobs](https://developer.onetrust.com/onetrust/reference/geteligiblejobsusingget.md) * [Update Scan Job Status](https://developer.onetrust.com/onetrust/reference/updatejobstatususingput.md) * [Submit Data to Catalog](https://developer.onetrust.com/onetrust/reference/catalogdatausingpost.md)