For the complete documentation index, see llms.txt. This page is also available as Markdown.

Data Class

Management of Data Classes.

Find Data Classes

get

Finds Data Classes based on the provided criteria.

By default, this endpoint returns a basic description of the Data Classes that does not include the details of the Classification Rules. To retrieve the extended view of the Data Classes that includes the Classification Rules, you can pass the view=extended parameter.

Authorizations
AuthorizationstringRequired

Collibra REST API authentication using Basic Authentication.

Query parameters
correlationIdstring · uuidOptional

Correlation ID used to relate logs occurring in distinct system components.

statusstring[]Optional

Applies a filter based on the status of the Data Classes.

Possible values:

  • ENABLED
  • DISABLED

If multiple status parameters are provided, the Data Classes matching any status defined as parameter are taken into account (OR logic).

Example: ["ENABLED"]
containsRulesbooleanOptional

Filters the Data Classes based on whether or not they contain rules.

If containsRules=true is defined as parameter, only the Data Classes containing rules are returned. This can be useful to retrieve only the Data Classes that can be used for automated classification.

Example: true
ruleTypestring[]Optional

Filter based on the ruleType of Classification Rules defined inside the Data Class. Multiple ruleType parameters can be provided. In this case, the API returns the DataClasses containing rules matching any of the defined types (OR logic).

The following values are currently supported:

  • REGULAR_EXPRESSION
  • REGULAR_EXPRESSION_COLUMN_NAME
  • DATA_TYPE
  • LIST_OF_VALUES
  • CODE_SET
  • LIKE
  • GREATER_THAN
  • LESS_THAN
  • EQUAL
  • BETWEEN
Example: LIST_OF_VALUES
namestringOptional

The name of a Data Class.

The matching logic is case insensitive and supports partial matches.

E.g. A search for EMAIL matches Data Class name Email Address

E.g. A search for Security matches Data Class name Social-Security-Number

descriptionstringOptional

The description of a Data Class.

The matching logic is case insensitive and supports partial matches.

dataClassGroupIdstring · uuidOptional

The ID of a Data Class Group.

offsetinteger · int32Optional

The index of the first result to retrieve.

If not set (offset = 0), results will be retrieved starting from row 0.

Default: 0
limitinteger · int32 · max: 1000Optional

The maximum number of results to retrieve.

If not set, the default limit (limit = 50) will be used. The maximum value for this parameter is 1000.

Default: 50
viewstringOptional

The view of the Data Class to return.

Possible values are basic or extended (case insensitive). The basic view does not include the rules, whereas the extended view does.

Default: basic
Responses
200

Data Classes successfully retrieved.

application/json
totalintegerOptional

The total number of results.

Example: 1
get/dataClasses

Create a Data Class

post

Creates a Data Class.

Authorizations
AuthorizationstringRequired

Collibra REST API authentication using Basic Authentication.

Query parameters
correlationIdstring · uuidOptional

Correlation ID used to relate logs occurring in distinct system components.

Body

Request to create a Data Class. Only the name property is mandatory when creating a new Data Class.

namestringRequired

Name of the Data Class.

Example: email
descriptionstringOptional

The description of the Data Class. The maximum length of this field is set to 10,000 characters.

Example: Email address
statusstringOptional

The status of a Data Class.

This attribute allows a Data Class to be ENABLED or DISABLED. An DISABLED Data Class will never be used as part of the classification process.

Possible values:

  • ENABLED
  • DISABLED
Example: ENABLED
columnNameFiltersstring[]Optional

The Data Class is considered only if the column name is a full or partial match with the value of this property.

It is not case sensitive and it is using a text match (not a regular expression).

Any match will make the Data Class considered.

Default: []Example: ["email","e-mail"]
columnTypeFiltersstring[]Optional

The Data Class can only be considered if the column technical data type is part of the values defined for this property.

Valid values are: string, double, int, boolean, date, and timestamp.

Default: []Example: ["string","double"]
allowNullValuesbooleanOptional

If the value is set to true, null values are considered when calculating the confidence level of a matching Data Class.

If the value is set to false, only the non-null values are considered by the classification process and are taken into account when calculating the confidence level of a matching Data Class.

Default: false
allowEmptyValuesbooleanOptional

If the value is set to true, empty values are considered by the classification process and are taken into account when calculating the confidence level of a matching Data Class.

If the value is set to false, only the non-empty values are considered by the classification process and are taken into account when calculating the confidence level of a matching Data Class.

Default: false
confidenceThresholdinteger · max: 100Optional

The Data Class is only considered in the result if this confidence threshold is reached.

Default: 0
examplesstring[]Optional

Examples of values that match the Data Class.

Default: []Example: ["john.doe@acme.com","marc@company.com"]
Responses
201

Data Class successfully created.

application/json
post/dataClasses

Find Data Classes

post

Finds Data Classes from a list of IDs.

Authorizations
AuthorizationstringRequired

Collibra REST API authentication using Basic Authentication.

Query parameters
correlationIdstring · uuidOptional

Correlation ID used to relate logs occurring in distinct system components.

viewstringOptional

The view of the Data Class to return.

Possible values are basic or extended (case insensitive). The basic view does not include the rules, whereas the extended view does.

Default: basic
Bodystring · uuid[]
string · uuid[]Optional

IDs of the Data Classes contained in the Data Class Group.

Responses
200

Data Classes successfully retrieved.

application/json

The list of results.

idstring · uuidRequired

The ID of the Data Class.

namestringRequired

Name of the Data Class.

Example: email
descriptionstringOptional

The description of the Data Class. The maximum length of this field is set to 10,000 characters.

Example: Email address
statusstringRequired

The status of a Data Class.

This attribute allows a Data Class to be ENABLED or DISABLED. An DISABLED Data Class will never be used as part of the classification process.

Possible values:

  • ENABLED
  • DISABLED
Example: ENABLED
columnNameFiltersstring[]Optional

The Data Class is considered only if the column name is a full or partial match with the value of this property.

It is not case sensitive and it is using a text match (not a regular expression).

Any match will make the Data Class considered.

Default: []Example: ["email","e-mail"]
columnTypeFiltersstring[]Optional

The Data Class can only be considered if the column technical data type is part of the values defined for this property.

Valid values are: string, double, int, boolean, date, and timestamp.

Default: []Example: ["string","double"]
allowNullValuesbooleanRequired

If the value is set to true, null values are considered when calculating the confidence level of a matching Data Class.

If the value is set to false, only the non-null values are considered by the classification process and are taken into account when calculating the confidence level of a matching Data Class.

Default: false
allowEmptyValuesbooleanRequired

If the value is set to true, empty values are considered by the classification process and are taken into account when calculating the confidence level of a matching Data Class.

If the value is set to false, only the non-empty values are considered by the classification process and are taken into account when calculating the confidence level of a matching Data Class.

Default: false
confidenceThresholdinteger · max: 100Required

The Data Class is only considered in the result if this confidence threshold is reached.

Default: 0
examplesstring[]Optional

Examples of values that match the Data Class.

Default: []Example: ["john.doe@acme.com","marc@company.com"]
createdBystring · uuidRequired

The id of the user that created this resource.

Example: 4d250cc5-e583-4640-9874-b93d82c7a6cb
createdOninteger · int64Required

The timestamp (in UTC time standard) of the creation of this resource.

Example: 1475503010320
lastModifiedBystring · uuidRequired

The id of the user who modified this resource the last time.

Example: a073ff90-e7bc-4b35-ba90-c4d475f642fe
lastModifiedOninteger · int64Required

The timestamp (in UTC time standard) of the last modification of this resource.

Example: 1476703764163
post/dataClasses/find

Get a Data Class

get

Get a single Data Class by its identifier.

By default, this endpoint returns a basic description of the Data Classes that does not include the details of the Classification Rules. To retrieve the extended view of the Data Classes that includes the Classification Rules, you can pass the view=extended parameter.

Authorizations
AuthorizationstringRequired

Collibra REST API authentication using Basic Authentication.

Path parameters
dataClassIdstring · uuidRequired

The ID of a Data Class.

Query parameters
correlationIdstring · uuidOptional

Correlation ID used to relate logs occurring in distinct system components.

viewstringOptional

The view of the Data Class to return.

Possible values are basic or extended (case insensitive). The basic view does not include the rules, whereas the extended view does.

Default: basic
Responses
200

Data Class successfully retrieved.

application/json
idstring · uuidRequired

The ID of the Data Class.

namestringRequired

Name of the Data Class.

Example: email
descriptionstringOptional

The description of the Data Class. The maximum length of this field is set to 10,000 characters.

Example: Email address
statusstringRequired

The status of a Data Class.

This attribute allows a Data Class to be ENABLED or DISABLED. An DISABLED Data Class will never be used as part of the classification process.

Possible values:

  • ENABLED
  • DISABLED
Example: ENABLED
columnNameFiltersstring[]Optional

The Data Class is considered only if the column name is a full or partial match with the value of this property.

It is not case sensitive and it is using a text match (not a regular expression).

Any match will make the Data Class considered.

Default: []Example: ["email","e-mail"]
columnTypeFiltersstring[]Optional

The Data Class can only be considered if the column technical data type is part of the values defined for this property.

Valid values are: string, double, int, boolean, date, and timestamp.

Default: []Example: ["string","double"]
allowNullValuesbooleanRequired

If the value is set to true, null values are considered when calculating the confidence level of a matching Data Class.

If the value is set to false, only the non-null values are considered by the classification process and are taken into account when calculating the confidence level of a matching Data Class.

Default: false
allowEmptyValuesbooleanRequired

If the value is set to true, empty values are considered by the classification process and are taken into account when calculating the confidence level of a matching Data Class.

If the value is set to false, only the non-empty values are considered by the classification process and are taken into account when calculating the confidence level of a matching Data Class.

Default: false
confidenceThresholdinteger · max: 100Required

The Data Class is only considered in the result if this confidence threshold is reached.

Default: 0
examplesstring[]Optional

Examples of values that match the Data Class.

Default: []Example: ["john.doe@acme.com","marc@company.com"]
createdBystring · uuidRequired

The id of the user that created this resource.

Example: 4d250cc5-e583-4640-9874-b93d82c7a6cb
createdOninteger · int64Required

The timestamp (in UTC time standard) of the creation of this resource.

Example: 1475503010320
lastModifiedBystring · uuidRequired

The id of the user who modified this resource the last time.

Example: a073ff90-e7bc-4b35-ba90-c4d475f642fe
lastModifiedOninteger · int64Required

The timestamp (in UTC time standard) of the last modification of this resource.

Example: 1476703764163
get/dataClasses/{dataClassId}

Delete a Data Class

delete

Delete a Data Class by its identifier. The Classification Rules defined for the Data Class and any Data Class related List Of Values will be deleted, and the Data Class will be removed from all Data Class Groups referencing it.

Authorizations
AuthorizationstringRequired

Collibra REST API authentication using Basic Authentication.

Path parameters
dataClassIdstring · uuidRequired

The ID of a Data Class.

Query parameters
correlationIdstring · uuidOptional

Correlation ID used to relate logs occurring in distinct system components.

Responses
204

Data Class successfully deleted.

No content

delete/dataClasses/{dataClassId}

No content

Update a Data Class

patch

Updates attributes of a Data Class.

Authorizations
AuthorizationstringRequired

Collibra REST API authentication using Basic Authentication.

Path parameters
dataClassIdstring · uuidRequired

The ID of a Data Class.

Query parameters
correlationIdstring · uuidOptional

Correlation ID used to relate logs occurring in distinct system components.

Body

Request to change a Data Class.

All the attributes are optional.

namestringOptional

Name of the Data Class.

Example: email
descriptionstringOptional

The description of the Data Class. The maximum length of this field is set to 10,000 characters.

Example: Email address
statusstringOptional

The status of a Data Class.

This attribute allows a Data Class to be ENABLED or DISABLED. An DISABLED Data Class will never be used as part of the classification process.

Possible values:

  • ENABLED
  • DISABLED
Example: ENABLED
columnNameFiltersstring[]Optional

The Data Class is considered only if the column name is a full or partial match with the value of this property.

It is not case sensitive and it is using a text match (not a regular expression).

Any match will make the Data Class considered.

Default: []Example: ["email","e-mail"]
columnTypeFiltersstring[]Optional

The Data Class can only be considered if the column technical data type is part of the values defined for this property.

Valid values are: string, double, int, boolean, date, and timestamp.

Default: []Example: ["string","double"]
allowNullValuesbooleanOptional

If the value is set to true, null values are considered when calculating the confidence level of a matching Data Class.

If the value is set to false, only the non-null values are considered by the classification process and are taken into account when calculating the confidence level of a matching Data Class.

Default: false
allowEmptyValuesbooleanOptional

If the value is set to true, empty values are considered by the classification process and are taken into account when calculating the confidence level of a matching Data Class.

If the value is set to false, only the non-empty values are considered by the classification process and are taken into account when calculating the confidence level of a matching Data Class.

Default: false
confidenceThresholdinteger · max: 100Optional

The Data Class is only considered in the result if this confidence threshold is reached.

Default: 0
examplesstring[]Optional

Examples of values that match the Data Class.

Default: []Example: ["john.doe@acme.com","marc@company.com"]
Responses
200

Data Class successfully changed.

application/json
idstring · uuidRequired

The ID of the Data Class.

namestringRequired

Name of the Data Class.

Example: email
descriptionstringOptional

The description of the Data Class. The maximum length of this field is set to 10,000 characters.

Example: Email address
statusstringRequired

The status of a Data Class.

This attribute allows a Data Class to be ENABLED or DISABLED. An DISABLED Data Class will never be used as part of the classification process.

Possible values:

  • ENABLED
  • DISABLED
Example: ENABLED
columnNameFiltersstring[]Optional

The Data Class is considered only if the column name is a full or partial match with the value of this property.

It is not case sensitive and it is using a text match (not a regular expression).

Any match will make the Data Class considered.

Default: []Example: ["email","e-mail"]
columnTypeFiltersstring[]Optional

The Data Class can only be considered if the column technical data type is part of the values defined for this property.

Valid values are: string, double, int, boolean, date, and timestamp.

Default: []Example: ["string","double"]
allowNullValuesbooleanRequired

If the value is set to true, null values are considered when calculating the confidence level of a matching Data Class.

If the value is set to false, only the non-null values are considered by the classification process and are taken into account when calculating the confidence level of a matching Data Class.

Default: false
allowEmptyValuesbooleanRequired

If the value is set to true, empty values are considered by the classification process and are taken into account when calculating the confidence level of a matching Data Class.

If the value is set to false, only the non-empty values are considered by the classification process and are taken into account when calculating the confidence level of a matching Data Class.

Default: false
confidenceThresholdinteger · max: 100Required

The Data Class is only considered in the result if this confidence threshold is reached.

Default: 0
examplesstring[]Optional

Examples of values that match the Data Class.

Default: []Example: ["john.doe@acme.com","marc@company.com"]
createdBystring · uuidRequired

The id of the user that created this resource.

Example: 4d250cc5-e583-4640-9874-b93d82c7a6cb
createdOninteger · int64Required

The timestamp (in UTC time standard) of the creation of this resource.

Example: 1475503010320
lastModifiedBystring · uuidRequired

The id of the user who modified this resource the last time.

Example: a073ff90-e7bc-4b35-ba90-c4d475f642fe
lastModifiedOninteger · int64Required

The timestamp (in UTC time standard) of the last modification of this resource.

Example: 1476703764163
patch/dataClasses/{dataClassId}

Merge Data Classes

post

Merge one or multiple Data Classes into a target Data Class.

Possible error codes that can be returned include:

  • 400: When dataClassesToBeMerged includes the Data Class defined via targetDataClass.

  • 404: When at least one of the Data Classes defined by dataClassesToBeMerged does not exist.

Authorizations
AuthorizationstringRequired

Collibra REST API authentication using Basic Authentication.

Body

Request to merge Data Classes with a specific Data Class.

targetDataClassstringRequired

The name of a Data Class. Following the merge operation, only this specific Data Class will remain. If it doesn't exist, a new data class will be created.

dataClassesToBeMergedstring · uuid[] · min: 1Required

The IDs of the Data Classes to be merged. At the end of the merge operation, those Data Classes will be deleted.

Responses
200

Data Classes have been merged successfully. The resulting Data Class is included in the response.

application/json
idstring · uuidRequired

The ID of the Data Class.

namestringRequired

Name of the Data Class.

Example: email
descriptionstringOptional

The description of the Data Class. The maximum length of this field is set to 10,000 characters.

Example: Email address
statusstringRequired

The status of a Data Class.

This attribute allows a Data Class to be ENABLED or DISABLED. An DISABLED Data Class will never be used as part of the classification process.

Possible values:

  • ENABLED
  • DISABLED
Example: ENABLED
columnNameFiltersstring[]Optional

The Data Class is considered only if the column name is a full or partial match with the value of this property.

It is not case sensitive and it is using a text match (not a regular expression).

Any match will make the Data Class considered.

Default: []Example: ["email","e-mail"]
columnTypeFiltersstring[]Optional

The Data Class can only be considered if the column technical data type is part of the values defined for this property.

Valid values are: string, double, int, boolean, date, and timestamp.

Default: []Example: ["string","double"]
allowNullValuesbooleanRequired

If the value is set to true, null values are considered when calculating the confidence level of a matching Data Class.

If the value is set to false, only the non-null values are considered by the classification process and are taken into account when calculating the confidence level of a matching Data Class.

Default: false
allowEmptyValuesbooleanRequired

If the value is set to true, empty values are considered by the classification process and are taken into account when calculating the confidence level of a matching Data Class.

If the value is set to false, only the non-empty values are considered by the classification process and are taken into account when calculating the confidence level of a matching Data Class.

Default: false
confidenceThresholdinteger · max: 100Required

The Data Class is only considered in the result if this confidence threshold is reached.

Default: 0
examplesstring[]Optional

Examples of values that match the Data Class.

Default: []Example: ["john.doe@acme.com","marc@company.com"]
createdBystring · uuidRequired

The id of the user that created this resource.

Example: 4d250cc5-e583-4640-9874-b93d82c7a6cb
createdOninteger · int64Required

The timestamp (in UTC time standard) of the creation of this resource.

Example: 1475503010320
lastModifiedBystring · uuidRequired

The id of the user who modified this resource the last time.

Example: a073ff90-e7bc-4b35-ba90-c4d475f642fe
lastModifiedOninteger · int64Required

The timestamp (in UTC time standard) of the last modification of this resource.

Example: 1476703764163
post/dataClasses/merge

Last updated

Was this helpful?