Skip to content

Return catalog hierarchy designer metadata.

GET
/api/workspace/admin/catalogs/{catalogDefinitionId}/hierarchy-definition
curl --request GET \
--url https://example.com/api/workspace/admin/catalogs/example/hierarchy-definition \
--header 'Authorization: Bearer <token>'
catalogDefinitionId
required
string
access_token
string

Optional access token for clients that cannot set Authorization headers. Prefer Authorization: Bearer <token> when possible.

OK

Media typeapplication/json
object
Data

Catalog hierarchy designer metadata.

object
CatalogDefinitionId

Catalog definition identifier.

string
nullable
Kind
integer format: int32
Allowed values: 0 1 2
SecurityMode
integer format: int32
Allowed values: 0 1
RowVersion

Catalog definition concurrency token.

string format: uuid
NodeTypes

Configured node types.

Array<object>
nullable

One configured node type in a catalog hierarchy definition.

object
Id

Node type identifier.

string
nullable
CatalogDefinitionId

Catalog definition identifier.

string
nullable
Key

Stable node type key.

string
nullable
DisplayName

Node type display name.

string
nullable
BackingKind
integer format: int32
Allowed values: 0 1
EntityDefinitionId

Entity definition used by entity-backed node types.

string
nullable
EntityDefinitionName

Technical entity definition name.

string
nullable
EntityDefinitionDisplayNameSingular

Singular display name for the entity definition.

string
nullable
EntityDefinitionDisplayNamePlural

Plural display name for the entity definition.

string
nullable
UsageType
integer format: int32
Allowed values: 0 1 2
CanBeRoot

Whether nodes of this type can be created at catalog root.

boolean
DisplayNameFieldKey

Primary field used for node title.

string
nullable
SubtitleFieldKey

Optional field used for node subtitle.

string
nullable
IconFieldKey

Optional field used for node icon/type source.

string
nullable
TypeLabel

Optional fixed type label.

string
nullable
SortOrder

Display order in the designer.

integer format: int32
RowVersion

Concurrency token.

string format: uuid
ContainmentRules

Configured containment rules.

Array<object>
nullable

One configured parent-child node type rule in a catalog hierarchy definition.

object
Id

Containment rule identifier.

string
nullable
CatalogDefinitionId

Catalog definition identifier.

string
nullable
ParentNodeTypeId

Parent node type identifier.

string
nullable
ParentNodeTypeKey

Parent node type stable key.

string
nullable
ChildNodeTypeId

Child node type identifier.

string
nullable
ChildNodeTypeKey

Child node type stable key.

string
nullable
AllowCreate

Whether create is allowed for this containment pair.

boolean
AllowMove

Whether move is allowed for this containment pair.

boolean
SortOrder

Display order in the designer.

integer format: int32
RowVersion

Concurrency token.

string format: uuid
Errors
Array<object>
nullable
object
Code
required
string
nullable
Message
required
string
nullable
Target
string
nullable
Field
string
nullable
Metadata
object
key
additional properties
string
nullable
Type
integer format: int32
Allowed values: 0 1 2
Severity
integer format: int32
Allowed values: 0 1 2
Warnings
Array<object>
nullable
object
Code
required
string
nullable
Message
required
string
nullable
Target
string
nullable
Field
string
nullable
Metadata
object
key
additional properties
string
nullable
Type
integer format: int32
Allowed values: 0 1 2
Severity
integer format: int32
Allowed values: 0 1 2
Success
boolean
Example
{
"Data": {
"Kind": 0,
"SecurityMode": 0,
"NodeTypes": [
{
"BackingKind": 0,
"UsageType": 0
}
]
},
"Errors": [
{
"Type": 0,
"Severity": 0
}
],
"Warnings": [
{
"Type": 0,
"Severity": 0
}
]
}

Forbidden

Media typeapplication/json
object
type
string
nullable
title
string
nullable
status
integer format: int32
nullable
detail
string
nullable
instance
string
nullable
key
additional properties
Examplegenerated
{
"type": "example",
"title": "example",
"status": 1,
"detail": "example",
"instance": "example"
}

Not Found

Media typeapplication/json
object
Data

Catalog hierarchy designer metadata.

object
CatalogDefinitionId

Catalog definition identifier.

string
nullable
Kind
integer format: int32
Allowed values: 0 1 2
SecurityMode
integer format: int32
Allowed values: 0 1
RowVersion

Catalog definition concurrency token.

string format: uuid
NodeTypes

Configured node types.

Array<object>
nullable

One configured node type in a catalog hierarchy definition.

object
Id

Node type identifier.

string
nullable
CatalogDefinitionId

Catalog definition identifier.

string
nullable
Key

Stable node type key.

string
nullable
DisplayName

Node type display name.

string
nullable
BackingKind
integer format: int32
Allowed values: 0 1
EntityDefinitionId

Entity definition used by entity-backed node types.

string
nullable
EntityDefinitionName

Technical entity definition name.

string
nullable
EntityDefinitionDisplayNameSingular

Singular display name for the entity definition.

string
nullable
EntityDefinitionDisplayNamePlural

Plural display name for the entity definition.

string
nullable
UsageType
integer format: int32
Allowed values: 0 1 2
CanBeRoot

Whether nodes of this type can be created at catalog root.

boolean
DisplayNameFieldKey

Primary field used for node title.

string
nullable
SubtitleFieldKey

Optional field used for node subtitle.

string
nullable
IconFieldKey

Optional field used for node icon/type source.

string
nullable
TypeLabel

Optional fixed type label.

string
nullable
SortOrder

Display order in the designer.

integer format: int32
RowVersion

Concurrency token.

string format: uuid
ContainmentRules

Configured containment rules.

Array<object>
nullable

One configured parent-child node type rule in a catalog hierarchy definition.

object
Id

Containment rule identifier.

string
nullable
CatalogDefinitionId

Catalog definition identifier.

string
nullable
ParentNodeTypeId

Parent node type identifier.

string
nullable
ParentNodeTypeKey

Parent node type stable key.

string
nullable
ChildNodeTypeId

Child node type identifier.

string
nullable
ChildNodeTypeKey

Child node type stable key.

string
nullable
AllowCreate

Whether create is allowed for this containment pair.

boolean
AllowMove

Whether move is allowed for this containment pair.

boolean
SortOrder

Display order in the designer.

integer format: int32
RowVersion

Concurrency token.

string format: uuid
Errors
Array<object>
nullable
object
Code
required
string
nullable
Message
required
string
nullable
Target
string
nullable
Field
string
nullable
Metadata
object
key
additional properties
string
nullable
Type
integer format: int32
Allowed values: 0 1 2
Severity
integer format: int32
Allowed values: 0 1 2
Warnings
Array<object>
nullable
object
Code
required
string
nullable
Message
required
string
nullable
Target
string
nullable
Field
string
nullable
Metadata
object
key
additional properties
string
nullable
Type
integer format: int32
Allowed values: 0 1 2
Severity
integer format: int32
Allowed values: 0 1 2
Success
boolean
Example
{
"Data": {
"Kind": 0,
"SecurityMode": 0,
"NodeTypes": [
{
"BackingKind": 0,
"UsageType": 0
}
]
},
"Errors": [
{
"Type": 0,
"Severity": 0
}
],
"Warnings": [
{
"Type": 0,
"Severity": 0
}
]
}