Return the full object property details for an object with the given primary key. Full property details includes ID, in addition to value. If the object exists.
objectProperty details response
list<Property>objectRepresent a property of an object with additional detail. A property has a type, value and associated permissions.
stringThe unique identifier of the property to be updated. This is not to be confused with propertyType,
which refers to the property's semantic name (e.g. com.palantir.property.employeeid).
propertyId can be obtained by calling the get object properties for an object.
stringThe name of the property in the API - also called the Property Type URI.
anyRepresents the value of a property. The following table provides expected representations of scalar data types:
| Type | JSON encoding | Example |
|---|---|---|
| Date | ISO 8601 extended local date string | "2021-05-01" |
| Decimal | string | "2.718281828" |
| Double | number | 3.14159265 |
| Integer | number | 238940 |
| Long | string | "58319870951433" |
| String | string | "Call me Ishmael" |
| Timestamp | ISO 8601 extended offset date-time string in UTC zone | "2021-01-04T05:00:00Z" |
string (enum)A permission, one of READ, WRITE, or OWNER. Each successive permission implies the previous ones, so WRITE implies READ, and OWNER implies READ and WRITE.
Enum values: READ, WRITE, OWNER
list<SecurityKey>The ID of the security details for this property. There can be multiple associated with a single property. If a user has the security markings or groups of any of them, they will have the associated permission.
stringThe unique identifier of the object component security for an object component. This key is only meant for deduplication and lookup in the security details included in a single response. It has no guarantees or meaning outside a single response.
map<SecurityKey, ObjectComponentSecurity>stringThe unique identifier of the object component security for an object component. This key is only meant for deduplication and lookup in the security details included in a single response. It has no guarantees or meaning outside a single response.
objectSecurity mutation details for a component of an object - property, media, link. Specifying security overrides the system's default security when creating and updating data. If portion markings are specified, permissions may be specified. If portion markings are not specified, permissions must be specified.
This model may evolve over time for other security features.
list<PortionMarking>Collection of classification portion markings; markings are validated against the system's Classification Based Access Control (CBAC) rules.
If invalid, an InvalidClassificationPortionMarkings error will be thrown.
If not specified, no markings will be applied.
stringSecurity markings represent the level of access control that applies to a specific piece of information (e.g., object property, object title). Security markings are required upon creating a new object, and upon adding a new property to an existing object. To access information with one or more markings, the user must have access to the markings associated with that information as defined by your organization's defined security rules. Only users with the correct permissions can get, update, or delete a property with security markings.
In particular, if a user creates an object and adds a property of type with highly restricted markings, it is possible that subsequent calls to the get object properties endpoint may fail to display the highly restricted property.
Contact your Palantir administrator for more information on the markings that your organization uses.
list<PermissionItem>An optional mapping of groups to permissions allowed for the group. If not specified, the system's default is for the Everyone group to have WRITE permission, and the Administrators group to have OWNER permission.
A user will get the highest permission of any of the group they belong to. If portion markings are specified, the user must have access to all the markings specified before these permissions are applied.
objectA mapping of a group to a permission.
objectA qualified group name as used when defining permissions. A group contains a name, and optionally a realm. The realm is required for external groups.
stringThe base name of the group.
stringThe realm of the group. Empty for internal groups.
string (enum)A permission, one of READ, WRITE, or OWNER. Each successive permission implies the previous ones, so WRITE implies READ, and OWNER implies READ and WRITE.
Enum values: READ, WRITE, OWNER
1
2
3
curl \
-H "Authorization: Bearer $TOKEN" \
"https://$HOSTNAME/api/gotham/v1/objects/ri.gotham.111111-0.object-internal.111111/properties"1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
{
"properties": [
{
"propertyId": "abc123",
"propertyType": "com.palantir.property.name",
"value": {
"FIRST_NAME": "John",
"LAST_NAME": "Smith"
}
},
{
"propertyId": "def456",
"propertyType": "com.palantir.property.age",
"value": 37
}
]
}