Retrieve an entity definition by ID

Request

Retrieves an entity definition by its ID, with options to include conditional members, load permissions, and exclude light entity definitions.

Security
OAuth2.0
Path
idinteger, (int64)^\d+$required

The unique identifier of the entity definition, for example, 12345.

Query
includeConditionalMembersboolean

Whether to include conditional members, for example, true or false.

Default:false
loadPermissionsboolean

Whether to load permissions, for example, true or false.

Default:false
excludeLightDefinitionsstring(ExcludeLightDefinition)

Whether to exclude light entity definitions, for example, true or false.

Enum:"True""False""UserSecurity"
Headers
If-Modified-Sincestring, (date-time)

The date and time to check for modifications since, for example, 2023-01-01T00:00:00Z.

curl -i -X GET \
  'https://your-server/api/entitydefinitions/{id}?includeConditionalMembers=false&loadPermissions=false&excludeLightDefinitions=True' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'If-Modified-Since: 2019-08-24T14:15:22Z'

Responses

Successful operation

Bodyapplication/json
idinteger, (int64)
namestring or null
modified_onstring, (date-time)
created_onstring, (date-time)
display_templatestring or null
is_taxonomy_item_definitionboolean
is_path_enabled_definitionboolean
is_manual_sorting_allowedboolean
is_system_ownedboolean
is_built_inboolean
is_lightbooleanread-only

Gets a value indicating whether the entity definition is a light definition.

labelsobject or null
member_groupsArray of objects or null(MemberGroup)
entitiesobject(Link)

Represents a link to a resource.

related_pathsobject(Link)

Represents a link to a resource.

modified_byobject(Link)

Represents a link to a resource.

created_byobject(Link)

Represents a link to a resource.

permissionsArray of strings or null

All available permissions for the entity definition

selfobject(Link)

Represents a link to a resource.

Response
{ "id": 0, "name": "string", "modified_on": "2019-08-24T14:15:22Z", "created_on": "2019-08-24T14:15:22Z", "display_template": "string", "is_taxonomy_item_definition": true, "is_path_enabled_definition": true, "is_manual_sorting_allowed": true, "is_system_owned": true, "is_built_in": true, "is_light": true, "labels": { "property1": "string", "property2": "string" }, "member_groups": [ { … } ], "entities": { "href": "string", "filename_properties": [ … ], "title": "string", "templated": false }, "related_paths": { "href": "string", "filename_properties": [ … ], "title": "string", "templated": false }, "modified_by": { "href": "string", "filename_properties": [ … ], "title": "string", "templated": false }, "created_by": { "href": "string", "filename_properties": [ … ], "title": "string", "templated": false }, "permissions": [ "string" ], "self": { "href": "string", "filename_properties": [ … ], "title": "string", "templated": false } }