Search documentation
karat

+

K

User Documentation ↗

Get Ontology

GET/api/v1/ontologies/{ontologyRid}

Gets a specific ontology with the given Ontology RID.

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

Path parameters

ontologyRid
string

The unique Resource Identifier (RID) of the Ontology. To look up your Ontology RID, please use the List ontologies endpoint or check the Ontology Manager.

Response body

Ontology
object

Success response.

Hide children

Hide children

apiName
string
displayName
string

The display name of the entity.

description
string
rid
string

The unique Resource Identifier (RID) of the Ontology. To look up your Ontology RID, please use the List ontologies endpoint or check the Ontology Manager.

Examples

Request

Copied!
1 2 3 curl \ -H "Authorization: Bearer $TOKEN" \ "https://$HOSTNAME/api/v1/ontologies/ri.ontology.main.ontology.c61d9ab5-2919-4127-a0a1-ac64c0ce6367"

Response

Copied!
1 2 3 4 5 6 { "apiName": "default-ontology", "displayName": "Ontology", "description": "The default ontology", "rid": "ri.ontology.main.ontology.c61d9ab5-2919-4127-a0a1-ac64c0ce6367" }