Search documentation
karat

+

K

User Documentation ↗
Version 2.0

Get Ontology Value Type

GET/api/v2/ontologies/{ontology}/valueTypes/{valueType}
Warning

This endpoint is in preview and may be modified or removed at any time. To use this endpoint, add preview=true to the request query parameters.

Gets a specific value type with the given API name.

Third-party applications using this endpoint via OAuth2 must request the following operation scope: api:ontologies-read.

Path parameters

ontology
string

The API name or RID of the Ontology. To find the API name or RID, use the List Ontologies endpoint or check the Ontology Manager.

valueType
string

The API name of the value type. To find the API name, use the List value types endpoint or check the Ontology Manager.

Query parameters

preview
boolean
optional

A boolean flag that, when set to true, enables the use of beta features in preview mode.

Response body

OntologyValueType
object

Success response.

Hide child attributes

Hide child attributes

apiName
string

The name of the value type in the API in camelCase format.

displayName
string

The display name of the entity.

description
string
optional
rid
string
status
string (enum)
optional

Enum values: ACTIVE, DEPRECATED

fieldType
union
Show child attributes

Show child attributes

version
string
constraints
list<ValueTypeConstraint>
optional
Show child attributes

Show child attributes

Examples

Request

Copied!
1 2 3 curl \ \t-H "Authorization: Bearer $TOKEN" \ "https://$HOSTNAME/api/v2/ontologies/palantir/valueTypes/countryCode?preview=true"

Response

Copied!
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 { "apiName": "countryInitials", "description": "A three letter code for a top-level administrative region", "displayName": "Country Initials", "status": "ACTIVE", "fieldType": "string", "rid": "ri.type-registry.main.value-type.f5ee06ef-6dfd-4d91-a01e-91bd457c719d", "constraints": [ { "type": "length", "length": { "minimumLength": 3, "maximumLength": 3 } } ] }