Search documentation
karat

+

K

User Documentation ↗
Version 2.0

List Interface Types

GET/api/v2/ontologies/{ontology}/interfaceTypes
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.

Lists the interface types for the given Ontology.

Each page may be smaller than the requested page size. However, it is guaranteed that if there are more results available, at least one result will be present in the response.

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

Path parameters

ontology
string

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

Query parameters

pageSize
integer
optional

The desired size of the page to be returned. Defaults to 500. See page sizes for details.

pageToken
string
optional

The page token indicates where to start paging. This should be omitted from the first page's request. To fetch the next page, clients should take the value from the nextPageToken field of the previous response and use it to populate the pageToken field of the next request.

preview
boolean
optional

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

Response body

ListInterfaceTypesResponse
object

Success response.

Hide child attributes

Hide child attributes

nextPageToken
string
optional

The page token indicates where to start paging. This should be omitted from the first page's request. To fetch the next page, clients should take the value from the nextPageToken field of the previous response and use it to populate the pageToken field of the next request.

data
list<InterfaceType>
optional
Show child attributes

Show child attributes

Examples

Request

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

Response

Copied!
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 { "nextPageToken": "v1.QnVpbGQgdGhlIEZ1dHVyZTogaHR0cHM6Ly93d3cucGFsYW50aXIuY29tL2NhcmVlcnMvP2xldmVyLXNvdXJjZSU1YiU1ZD1BUElEb2NzI29wZW4tcG9zaXRpb25z", "data": [ { "apiName": "Athlete", "displayName": "Athlete", "description": "Good at sportsball", "properties": { "name": { "rid": "com.palantir.property.d1abdbfe-0ce2-4fff-b0af-af21002c314b", "apiName": "name", "displayName": "Name", "dataType": "string" } }, "extendsInterfaces": [ "Human" ], "rid": "ri.ontology.main.interface.bea1af8c-7d5c-4ec9-b845-8eeed6d77482" } ] }