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.
Load the ontology objects present in the ObjectSet from the provided object set definition. The resulting
objects may be scoped to an object type, in which all the selected properties on the object type are returned, or scoped
to an interface, in which only the object type properties that implement the properties of any interfaces in its
scope are returned. For objects that are scoped to an interface in the result, a mapping from interface to
object implementation is returned in order to interpret the objects as the interfaces that they implement.
For Object Storage V1 backed objects, this endpoint returns a maximum of 10,000 objects. After 10,000 objects have been returned and if more objects
are available, attempting to load another page will result in an ObjectsExceededLimit error being returned. There is no limit on Object Storage V2 backed objects.
Note that null value properties will not be returned. In addition, property metadata (rid, apiName, and primaryKey)
will be prefixed with '$' instead of '__' as is the case in loadObjects.
Third-party applications using this endpoint via OAuth2 must request the following operation scope: api:ontologies-read.
stringThe API name of the ontology. To find the API name, use the List ontologies endpoint or check the Ontology Manager.
stringThe repository associated with a marketplace installation.
stringThe package name of the generated SDK.
booleanA boolean flag that, when set to true, enables the use of beta features in preview mode.
objectRepresents the API POST body when loading an ObjectSet. Used on the /loadObjectsMultipleObjectTypes endpoint only.
unionRepresents the definition of an ObjectSet in the Ontology.
objectSpecifies the ordering of search results by a field and an ordering direction or by relevance if scores are required in a nearestNeighbors query. By default orderType is set to fields.
list<SelectedPropertyApiName>stringThe 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.
integerThe page size to use for the endpoint.
booleanA flag to exclude the retrieval of the $rid property.
Setting this to true may improve performance of this endpoint for object types in OSV2.
objectSuccess response.
list<OntologyObjectV2>The list of objects in the current page.
stringThe 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.
stringThe total number of items across all pages.
map<InterfaceTypeApiName, InterfaceToObjectTypeMappings>1
2
3
4
5
curl -X POST \
-H "Content-type: application/json" \
-H "Authorization: Bearer $TOKEN" \
"https://$HOSTNAME/api/v2/ontologies/palantir/objectSets/loadObjectsMultipleObjectTypes?preview=true" \
-d '{"objectSet":{"type":"base","objectType":"Employee"},"pageSize":10000,"nextPageToken":"v1.QnVpbGQgdGhlIEZ1dHVyZTogaHR0cHM6Ly93d3cucGFsYW50aXIuY29tL2NhcmVlcnMvP2xldmVyLXNvdXJjZSU1YiU1ZD1BUElEb2NzI29wZW4tcG9zaXRpb25z"}'1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
{
"data": [
{
"$rid": "ri.phonograph2-objects.main.object.5b5dbc28-7f05-4e83-a33a-1e5b851",
"$primaryKey": 50030,
"$apiName": "Employee",
"employeeId": 50030,
"employeeName": "John"
},
{
"$rid": "ri.phonograph2-objects.main.object.88a6fccb-f333-46d6-a07e-7725c5f18b61",
"$primaryKey": 20090,
"$apiName": "Employee",
"employeeId": 20090,
"employeeName": "John"
},
{
"$rid": "ri.phonograph2-objects.main.object.88a6fccb-f333-46d6-a07e-7725c5f18b71",
"$primaryKey": 23,
"$apiName": "Athlete",
"jerseyNumber": 23,
"firstName": "Michael"
}
],
"totalCount": "3,",
"interfaceToObjectTypeMappings": {
"Person": {
"Employee": {
"first": "employeeName",
"identifier": "employeeId"
},
"Athlete": {
"first": "firstName",
"identifier": "jerseyNumber"
}
}
}
}