Search documentation
karat

+

K

User Documentation ↗

List Ontologies

GET/api/v2/ontologies

Lists the Ontologies visible to the current user.

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

Response body

ListOntologiesV2Response
object

Success response.

Hide children

Hide children

data
list<OntologyV2>
optional

The list of Ontologies the user has access to.

Show children

Show children

OntologyV2
object

Metadata about an Ontology.

Show children

Show 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/v2/ontologies"

Response

Copied!
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 { "data": [ { "apiName": "default-ontology", "displayName": "Ontology", "description": "The default ontology", "rid": "ri.ontology.main.ontology.c61d9ab5-2919-4127-a0a1-ac64c0ce6367" }, { "apiName": "shared-ontology", "displayName": "Shared ontology", "description": "The ontology shared with our suppliers", "rid": "ri.ontology.main.ontology.c61d9ab5-2919-4127-a0a1-ac64c0ce6367" } ] }