> For the complete documentation index, see [llms.txt](https://developer.collibra.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.collibra.com/api/references/catalog-classification-v2/classification-data-category.md).
# Classification Data Category
Classification category operations
## POST /dataClasses/{dataClassId}/dataCategories
> Associate data class with data category
```json
{"openapi":"3.0.3","info":{"title":"Collibra Catalog Classification API","version":"2.0.0-unstable"},"tags":[{"name":"Classification Data Category","description":"Classification category operations"}],"servers":[{"url":"/rest/catalogClassification/v2"}],"security":[{"basicAuth":[]},{"jwtAuth":[]}],"components":{"securitySchemes":{"basicAuth":{"description":"The APIs require Basic HTTP authentication.","type":"http","scheme":"basic"},"jwtAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Collibra REST API authentication using JSON Web Token."}},"schemas":{"DataClassDataCategoryConnection":{"type":"object","description":"An association between a data class and a data category.","required":["id","resourceType"],"properties":{"id":{"type":"string","format":"uuid","description":"The ID of the represented object (entity)."},"dataClass":{"$ref":"#/components/schemas/Classification"},"dataCategory":{"$ref":"#/components/schemas/NamedResourceReferenceImpl"},"createdBy":{"type":"string","format":"uuid","description":"The ID of the user who created this resource."},"createdOn":{"type":"integer","format":"int64","description":"The Unix timestamp in milliseconds (in UTC time standard) of the resource creation date."},"lastModifiedBy":{"type":"string","format":"uuid","description":"The ID of the user who last modified this resource."},"lastModifiedOn":{"type":"integer","format":"int64","description":"The Unix timestamp in milliseconds (in UTC time standard) the resource last modified date."},"system":{"type":"boolean","description":"Whether this is a system resource or not."},"resourceType":{"$ref":"#/components/schemas/ResourceType"}}},"Classification":{"description":"Represents classification of data.","type":"object","required":["id","resourceType"],"properties":{"id":{"type":"string","format":"uuid","description":"The ID of the represented object (entity)."},"name":{"type":"string","description":"The name of the resource."},"createdBy":{"type":"string","format":"uuid","description":"The ID of the user who created this resource."},"createdOn":{"type":"integer","format":"int64","description":"The Unix timestamp in milliseconds (in UTC time standard) of the resource creation date."},"lastModifiedBy":{"type":"string","format":"uuid","description":"The ID of the user who last modified this resource."},"lastModifiedOn":{"type":"integer","format":"int64","description":"The Unix timestamp in milliseconds (in UTC time standard) the resource last modified date."},"system":{"description":"Whether this is a system resource or not.","type":"boolean"},"resourceType":{"$ref":"#/components/schemas/ResourceType"}}},"ResourceType":{"type":"string","description":"The type of the resource, for example [Community, Asset, Domain, Attribute, Relation, WorkflowInstance].","enum":["View","Asset","Community","Domain","AssetType","DomainType","Status","User","ClassificationMatch","UserGroup","Attribute","StringAttribute","ScriptAttribute","BooleanAttribute","DateAttribute","NumericAttribute","SingleValueListAttribute","MultiValueListAttribute","Comment","Attachment","Responsibility","Workflow","Job","Relation","RelationType","ComplexRelation","ComplexRelationType","ArticulationRule","Assignment","Scope","RelationTrace","ValidationRule","DataQualityRule","DataQualityMetric","Address","InstantMessagingAccount","Email","PhoneNumber","Website","Activity","FormProperty","WorkflowTask","ActivityChange","WorkflowInstance","Role","AttributeType","BooleanAttributeType","DateAttributeType","DateTimeAttributeType","MultiValueListAttributeType","NumericAttributeType","ScriptAttributeType","SingleValueListAttributeType","StringAttributeType","ViewSharingRule","ViewAssignmentRule","JdbcDriverFile","JdbcDriver","JdbcIngestionProperties","CsvIngestionProperties","ExcelIngestionProperties","ConnectionStringParameter","AssignedCharacteristicType","Notification","Tag","ComplexRelationLegType","ComplexRelationAttributeType","ComplexRelationLeg","BaseDataType","AdvancedDataType","DiagramPicture","DiagramPictureSharingRule","DiagramPictureAssignmentRule","Rating","Classification","PhysicalDataConnector","Context"]},"NamedResourceReferenceImpl":{"description":"A reference to the resource, including its name.","type":"object","required":["id","resourceType"],"properties":{"id":{"type":"string","format":"uuid","description":"The ID of the referenced resource."},"name":{"type":"string","description":"The name of the referenced resource."},"resourceType":{"$ref":"#/components/schemas/ResourceType"}}},"StandardErrorResponse":{"type":"object","properties":{"statusCode":{"type":"integer","description":"The HTTP response code."},"titleMessage":{"type":"string"},"helpMessage":{"type":"string"},"userMessage":{"type":"string"},"errorCode":{"type":"string"}}}},"responses":{"InvalidRequest404":{"description":"Resource not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardErrorResponse"}}}},"InvalidRequest422":{"description":"Associations between provided Assets and Data Class already exist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardErrorResponse"}}}}}},"paths":{"/dataClasses/{dataClassId}/dataCategories":{"post":{"summary":"Associate data class with data category","operationId":"connectDataCategoryDataClass","tags":["Classification Data Category"],"parameters":[{"name":"dataClassId","in":"path","description":"The ID of the data class to which the data category will be associated.","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"description":"The ID of the data category to be associated with the data class.","content":{"application/json":{"schema":{"type":"string","format":"uuid"}}}},"responses":{"201":{"description":"The newly created classification category association.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataClassDataCategoryConnection"}}}},"404":{"$ref":"#/components/responses/InvalidRequest404"},"422":{"$ref":"#/components/responses/InvalidRequest422"}}}}}}
```
## DELETE /dataClasses/{dataClassId}/dataCategories/{dataCategoryId}
> Remove existing association between a data class and a data category
```json
{"openapi":"3.0.3","info":{"title":"Collibra Catalog Classification API","version":"2.0.0-unstable"},"tags":[{"name":"Classification Data Category","description":"Classification category operations"}],"servers":[{"url":"/rest/catalogClassification/v2"}],"security":[{"basicAuth":[]},{"jwtAuth":[]}],"components":{"securitySchemes":{"basicAuth":{"description":"The APIs require Basic HTTP authentication.","type":"http","scheme":"basic"},"jwtAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Collibra REST API authentication using JSON Web Token."}},"responses":{"InvalidRequest404":{"description":"Resource not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardErrorResponse"}}}}},"schemas":{"StandardErrorResponse":{"type":"object","properties":{"statusCode":{"type":"integer","description":"The HTTP response code."},"titleMessage":{"type":"string"},"helpMessage":{"type":"string"},"userMessage":{"type":"string"},"errorCode":{"type":"string"}}}}},"paths":{"/dataClasses/{dataClassId}/dataCategories/{dataCategoryId}":{"delete":{"summary":"Remove existing association between a data class and a data category","operationId":"disconnectDataCategoryDataClass","tags":["Classification Data Category"],"parameters":[{"name":"dataClassId","in":"path","description":"The ID of the data class from which the data category will be removed.","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"dataCategoryId","in":"path","description":"The ID of the data category to be removed.","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"204":{"description":"Removed the association between data class and data category."},"404":{"$ref":"#/components/responses/InvalidRequest404"}}}}}}
```
## GET /dataClasses/dataCategories
> Retrieve the association with a data category and a data class.
```json
{"openapi":"3.0.3","info":{"title":"Collibra Catalog Classification API","version":"2.0.0-unstable"},"tags":[{"name":"Classification Data Category","description":"Classification category operations"}],"servers":[{"url":"/rest/catalogClassification/v2"}],"security":[{"basicAuth":[]},{"jwtAuth":[]}],"components":{"securitySchemes":{"basicAuth":{"description":"The APIs require Basic HTTP authentication.","type":"http","scheme":"basic"},"jwtAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Collibra REST API authentication using JSON Web Token."}},"parameters":{"Offset":{"name":"offset","in":"query","description":"The index of the first result to retrieve.\n\nIf not set (offset = 0), results are retrieved starting from row 0.\n","schema":{"type":"integer","format":"int32","default":0}},"Limit":{"name":"limit","in":"query","description":"The maximum number of results to retrieve.\n\nIf not set, the default limit (limit = 0) is used. The maximum value for this parameter is\n1000.\n","schema":{"type":"integer","format":"int32","default":0,"maximum":1000}}},"schemas":{"DataClassDataCategoryConnectionsPagedResponse":{"type":"object","properties":{"results":{"type":"array","description":"The list of results.","items":{"$ref":"#/components/schemas/DataClassDataCategoryConnection"}}}},"DataClassDataCategoryConnection":{"type":"object","description":"An association between a data class and a data category.","required":["id","resourceType"],"properties":{"id":{"type":"string","format":"uuid","description":"The ID of the represented object (entity)."},"dataClass":{"$ref":"#/components/schemas/Classification"},"dataCategory":{"$ref":"#/components/schemas/NamedResourceReferenceImpl"},"createdBy":{"type":"string","format":"uuid","description":"The ID of the user who created this resource."},"createdOn":{"type":"integer","format":"int64","description":"The Unix timestamp in milliseconds (in UTC time standard) of the resource creation date."},"lastModifiedBy":{"type":"string","format":"uuid","description":"The ID of the user who last modified this resource."},"lastModifiedOn":{"type":"integer","format":"int64","description":"The Unix timestamp in milliseconds (in UTC time standard) the resource last modified date."},"system":{"type":"boolean","description":"Whether this is a system resource or not."},"resourceType":{"$ref":"#/components/schemas/ResourceType"}}},"Classification":{"description":"Represents classification of data.","type":"object","required":["id","resourceType"],"properties":{"id":{"type":"string","format":"uuid","description":"The ID of the represented object (entity)."},"name":{"type":"string","description":"The name of the resource."},"createdBy":{"type":"string","format":"uuid","description":"The ID of the user who created this resource."},"createdOn":{"type":"integer","format":"int64","description":"The Unix timestamp in milliseconds (in UTC time standard) of the resource creation date."},"lastModifiedBy":{"type":"string","format":"uuid","description":"The ID of the user who last modified this resource."},"lastModifiedOn":{"type":"integer","format":"int64","description":"The Unix timestamp in milliseconds (in UTC time standard) the resource last modified date."},"system":{"description":"Whether this is a system resource or not.","type":"boolean"},"resourceType":{"$ref":"#/components/schemas/ResourceType"}}},"ResourceType":{"type":"string","description":"The type of the resource, for example [Community, Asset, Domain, Attribute, Relation, WorkflowInstance].","enum":["View","Asset","Community","Domain","AssetType","DomainType","Status","User","ClassificationMatch","UserGroup","Attribute","StringAttribute","ScriptAttribute","BooleanAttribute","DateAttribute","NumericAttribute","SingleValueListAttribute","MultiValueListAttribute","Comment","Attachment","Responsibility","Workflow","Job","Relation","RelationType","ComplexRelation","ComplexRelationType","ArticulationRule","Assignment","Scope","RelationTrace","ValidationRule","DataQualityRule","DataQualityMetric","Address","InstantMessagingAccount","Email","PhoneNumber","Website","Activity","FormProperty","WorkflowTask","ActivityChange","WorkflowInstance","Role","AttributeType","BooleanAttributeType","DateAttributeType","DateTimeAttributeType","MultiValueListAttributeType","NumericAttributeType","ScriptAttributeType","SingleValueListAttributeType","StringAttributeType","ViewSharingRule","ViewAssignmentRule","JdbcDriverFile","JdbcDriver","JdbcIngestionProperties","CsvIngestionProperties","ExcelIngestionProperties","ConnectionStringParameter","AssignedCharacteristicType","Notification","Tag","ComplexRelationLegType","ComplexRelationAttributeType","ComplexRelationLeg","BaseDataType","AdvancedDataType","DiagramPicture","DiagramPictureSharingRule","DiagramPictureAssignmentRule","Rating","Classification","PhysicalDataConnector","Context"]},"NamedResourceReferenceImpl":{"description":"A reference to the resource, including its name.","type":"object","required":["id","resourceType"],"properties":{"id":{"type":"string","format":"uuid","description":"The ID of the referenced resource."},"name":{"type":"string","description":"The name of the referenced resource."},"resourceType":{"$ref":"#/components/schemas/ResourceType"}}},"StandardErrorResponse":{"type":"object","properties":{"statusCode":{"type":"integer","description":"The HTTP response code."},"titleMessage":{"type":"string"},"helpMessage":{"type":"string"},"userMessage":{"type":"string"},"errorCode":{"type":"string"}}}},"responses":{"InvalidRequest400":{"description":"The request is not valid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardErrorResponse"}}}},"InvalidRequest404":{"description":"Resource not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardErrorResponse"}}}}}},"paths":{"/dataClasses/dataCategories":{"get":{"summary":"Retrieve the association with a data category and a data class.","operationId":"getAssociationDataClassDataCategory","tags":["Classification Data Category"],"parameters":[{"name":"dataCategoryId","in":"query","description":"The ID of the data category for which you want to see the associated data classes.","schema":{"type":"string","format":"uuid"}},{"name":"dataClassId","in":"query","description":"The ID of the data class for which you want to see the associated data categories.","schema":{"type":"string","format":"uuid"}},{"$ref":"#/components/parameters/Offset"},{"$ref":"#/components/parameters/Limit"}],"responses":{"200":{"description":"The list of associations with a data category and a data classes.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataClassDataCategoryConnectionsPagedResponse"}}}},"400":{"$ref":"#/components/responses/InvalidRequest400"},"404":{"$ref":"#/components/responses/InvalidRequest404"}}}}}}
```