Skip to content

Resolve one Table-filter hierarchy selection to its safe root-to-terminal chain.

POST
/api/workspace/entity/{entityIdOrKey}/ui/table/{tableSurfaceId}/filters/{filterItemKey}/reference-hierarchy/selection
curl --request POST \
--url https://example.com/api/workspace/entity/example/ui/table/example/filters/example/reference-hierarchy/selection \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{ "Context": { "ExpectedTableSurfaceRowVersion": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "DraftFilterTree": { "Root": { "Logic": 0, "Nodes": [ { "Group": {}, "Condition": { "FilterItemKey": "example", "Operator": 0, "Values": [ { "Kind": 0, "Value": "example", "Variable": 0 } ] } } ] } } }, "Selection": { "SelectedId": "example" } }'
entityIdOrKey
required
string
tableSurfaceId
required
string
filterItemKey
required
string
access_token
string

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

Table hierarchy selected-chain request.

object
Context
required

Saved Table filter context used by hierarchy model, page, and selection routes.

object
ExpectedTableSurfaceRowVersion
required

Exact owning Table Surface revision.

string format: uuid
DraftFilterTree
required

Non-executable draft filter tree used only to derive Reference Eligibility context for a persisted Table Surface filter item.

object
Root
required

One group in a non-executable Table filter draft.

object
Logic
required
integer format: int32
Allowed values: 0 1
Nodes
required

Nested groups and conditions.

Array<object>

One node in a non-executable Table filter draft. Exactly one of Moltaro.Entity.ReferenceEligibility.Requests.EntityTableReferenceDraftFilterNodeRequest.Group and Moltaro.Entity.ReferenceEligibility.Requests.EntityTableReferenceDraftFilterNodeRequest.Condition must be supplied.

object
Group
object recursive
Condition

One condition in a non-executable Table filter draft.

object
FilterItemKey
required

Canonical key of the persisted Table Surface filter item.

string
Operator
required
integer format: int32
Allowed values: 0 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
Values

Typed draft operands. The routed dependent may have no value while its picker is open.

Array<object>
nullable

One typed operand in a non-executable Table filter draft. Its JSON shape mirrors the ordinary query operand while retaining an independent strict unknown-property boundary.

object
Kind
required
integer format: int32
Allowed values: 0 1
Value

Literal JSON value for Moltaro.Enums.EntityInstanceQueryOperandKindEnum.Value.

nullable
Variable
integer format: int32
Allowed values: 0 1
Selection
required

One proposed terminal hierarchy selection.

object
SelectedId
required

Proposed terminal Entity Instance identifier.

string

OK

Media typeapplication/json
object
Data

Safe selected hierarchy chain resolution.

object
State
integer format: int32
Allowed values: 0 1 2 3 4 5 6 7 8 9 10
ErrorCode

Stable guidance code for a closed or ineligible state.

string
nullable
Chain

Readable root-to-terminal chain for eligible or observable ineligible selections only.

Array<object>
nullable

One display-safe hierarchy option.

object
Id

Entity Instance identifier.

string
nullable
DisplayName

Current display name.

string
nullable
Subtitle

Optional current subtitle.

string
nullable
HasChildren

Whether at least one readable structural child exists.

boolean
CanConfirm

Whether the option may be returned as the terminal Reference value.

boolean
ConfirmationState
integer format: int32
Allowed values: 0 1 2
ConfirmationMessage

Optional safe localized explanation for a non-confirmable state.

string
nullable
SelectedValue

Compact runtime payload for one resolved or unresolved entity reference.

object
State
integer format: int32
Allowed values: 0 1 2
Id

Linked entity identifier when resolved.

string
nullable
Number

Linked entity number when resolved.

string
nullable
DisplayName

Linked entity display name from the presentation cache when resolved.

string
nullable
Subtitle

Linked entity subtitle from the presentation cache when resolved.

string
nullable
ProjectedValues

Projected primary-field scalar values and requested nested reference values keyed by target field key when resolved.

object
key
additional properties
nullable
EntityDefinitionId

Linked entity definition identifier when resolved.

string
nullable
ProjectedPlainTextPreviews

Compact server-created previews for projected Markdown fields, keyed by target field key.

object
key
additional properties

Safe compact visible-text representation of a Markdown value.

object
Text

Visible text when available.

string
nullable
IsTruncated

Whether the visible text was shortened for compact presentation.

boolean
State
integer format: int32
Allowed values: 0 1 2 3
SemanticPresentation

Safe compact reference metadata, projected only for a resolved visible Entity reference.

object
UsageType
integer format: int32
Allowed values: 0 1 2
SemanticType
string
nullable
LinkRegistrationKey
string
nullable
CellRegistrationKey
string
nullable
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": {
"State": 0,
"Chain": [
{
"ConfirmationState": 0
}
],
"SelectedValue": {
"State": 0,
"ProjectedPlainTextPreviews": {
"additionalProperty": {
"State": 0
}
},
"SemanticPresentation": {
"UsageType": 0
}
}
},
"Errors": [
{
"Type": 0,
"Severity": 0
}
],
"Warnings": [
{
"Type": 0,
"Severity": 0
}
]
}

Bad Request

Media typeapplication/json
object
Data

Safe selected hierarchy chain resolution.

object
State
integer format: int32
Allowed values: 0 1 2 3 4 5 6 7 8 9 10
ErrorCode

Stable guidance code for a closed or ineligible state.

string
nullable
Chain

Readable root-to-terminal chain for eligible or observable ineligible selections only.

Array<object>
nullable

One display-safe hierarchy option.

object
Id

Entity Instance identifier.

string
nullable
DisplayName

Current display name.

string
nullable
Subtitle

Optional current subtitle.

string
nullable
HasChildren

Whether at least one readable structural child exists.

boolean
CanConfirm

Whether the option may be returned as the terminal Reference value.

boolean
ConfirmationState
integer format: int32
Allowed values: 0 1 2
ConfirmationMessage

Optional safe localized explanation for a non-confirmable state.

string
nullable
SelectedValue

Compact runtime payload for one resolved or unresolved entity reference.

object
State
integer format: int32
Allowed values: 0 1 2
Id

Linked entity identifier when resolved.

string
nullable
Number

Linked entity number when resolved.

string
nullable
DisplayName

Linked entity display name from the presentation cache when resolved.

string
nullable
Subtitle

Linked entity subtitle from the presentation cache when resolved.

string
nullable
ProjectedValues

Projected primary-field scalar values and requested nested reference values keyed by target field key when resolved.

object
key
additional properties
nullable
EntityDefinitionId

Linked entity definition identifier when resolved.

string
nullable
ProjectedPlainTextPreviews

Compact server-created previews for projected Markdown fields, keyed by target field key.

object
key
additional properties

Safe compact visible-text representation of a Markdown value.

object
Text

Visible text when available.

string
nullable
IsTruncated

Whether the visible text was shortened for compact presentation.

boolean
State
integer format: int32
Allowed values: 0 1 2 3
SemanticPresentation

Safe compact reference metadata, projected only for a resolved visible Entity reference.

object
UsageType
integer format: int32
Allowed values: 0 1 2
SemanticType
string
nullable
LinkRegistrationKey
string
nullable
CellRegistrationKey
string
nullable
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": {
"State": 0,
"Chain": [
{
"ConfirmationState": 0
}
],
"SelectedValue": {
"State": 0,
"ProjectedPlainTextPreviews": {
"additionalProperty": {
"State": 0
}
},
"SemanticPresentation": {
"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

Safe selected hierarchy chain resolution.

object
State
integer format: int32
Allowed values: 0 1 2 3 4 5 6 7 8 9 10
ErrorCode

Stable guidance code for a closed or ineligible state.

string
nullable
Chain

Readable root-to-terminal chain for eligible or observable ineligible selections only.

Array<object>
nullable

One display-safe hierarchy option.

object
Id

Entity Instance identifier.

string
nullable
DisplayName

Current display name.

string
nullable
Subtitle

Optional current subtitle.

string
nullable
HasChildren

Whether at least one readable structural child exists.

boolean
CanConfirm

Whether the option may be returned as the terminal Reference value.

boolean
ConfirmationState
integer format: int32
Allowed values: 0 1 2
ConfirmationMessage

Optional safe localized explanation for a non-confirmable state.

string
nullable
SelectedValue

Compact runtime payload for one resolved or unresolved entity reference.

object
State
integer format: int32
Allowed values: 0 1 2
Id

Linked entity identifier when resolved.

string
nullable
Number

Linked entity number when resolved.

string
nullable
DisplayName

Linked entity display name from the presentation cache when resolved.

string
nullable
Subtitle

Linked entity subtitle from the presentation cache when resolved.

string
nullable
ProjectedValues

Projected primary-field scalar values and requested nested reference values keyed by target field key when resolved.

object
key
additional properties
nullable
EntityDefinitionId

Linked entity definition identifier when resolved.

string
nullable
ProjectedPlainTextPreviews

Compact server-created previews for projected Markdown fields, keyed by target field key.

object
key
additional properties

Safe compact visible-text representation of a Markdown value.

object
Text

Visible text when available.

string
nullable
IsTruncated

Whether the visible text was shortened for compact presentation.

boolean
State
integer format: int32
Allowed values: 0 1 2 3
SemanticPresentation

Safe compact reference metadata, projected only for a resolved visible Entity reference.

object
UsageType
integer format: int32
Allowed values: 0 1 2
SemanticType
string
nullable
LinkRegistrationKey
string
nullable
CellRegistrationKey
string
nullable
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": {
"State": 0,
"Chain": [
{
"ConfirmationState": 0
}
],
"SelectedValue": {
"State": 0,
"ProjectedPlainTextPreviews": {
"additionalProperty": {
"State": 0
}
},
"SemanticPresentation": {
"UsageType": 0
}
}
},
"Errors": [
{
"Type": 0,
"Severity": 0
}
],
"Warnings": [
{
"Type": 0,
"Severity": 0
}
]
}

Conflict

Media typeapplication/json
object
Data

Safe selected hierarchy chain resolution.

object
State
integer format: int32
Allowed values: 0 1 2 3 4 5 6 7 8 9 10
ErrorCode

Stable guidance code for a closed or ineligible state.

string
nullable
Chain

Readable root-to-terminal chain for eligible or observable ineligible selections only.

Array<object>
nullable

One display-safe hierarchy option.

object
Id

Entity Instance identifier.

string
nullable
DisplayName

Current display name.

string
nullable
Subtitle

Optional current subtitle.

string
nullable
HasChildren

Whether at least one readable structural child exists.

boolean
CanConfirm

Whether the option may be returned as the terminal Reference value.

boolean
ConfirmationState
integer format: int32
Allowed values: 0 1 2
ConfirmationMessage

Optional safe localized explanation for a non-confirmable state.

string
nullable
SelectedValue

Compact runtime payload for one resolved or unresolved entity reference.

object
State
integer format: int32
Allowed values: 0 1 2
Id

Linked entity identifier when resolved.

string
nullable
Number

Linked entity number when resolved.

string
nullable
DisplayName

Linked entity display name from the presentation cache when resolved.

string
nullable
Subtitle

Linked entity subtitle from the presentation cache when resolved.

string
nullable
ProjectedValues

Projected primary-field scalar values and requested nested reference values keyed by target field key when resolved.

object
key
additional properties
nullable
EntityDefinitionId

Linked entity definition identifier when resolved.

string
nullable
ProjectedPlainTextPreviews

Compact server-created previews for projected Markdown fields, keyed by target field key.

object
key
additional properties

Safe compact visible-text representation of a Markdown value.

object
Text

Visible text when available.

string
nullable
IsTruncated

Whether the visible text was shortened for compact presentation.

boolean
State
integer format: int32
Allowed values: 0 1 2 3
SemanticPresentation

Safe compact reference metadata, projected only for a resolved visible Entity reference.

object
UsageType
integer format: int32
Allowed values: 0 1 2
SemanticType
string
nullable
LinkRegistrationKey
string
nullable
CellRegistrationKey
string
nullable
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": {
"State": 0,
"Chain": [
{
"ConfirmationState": 0
}
],
"SelectedValue": {
"State": 0,
"ProjectedPlainTextPreviews": {
"additionalProperty": {
"State": 0
}
},
"SemanticPresentation": {
"UsageType": 0
}
}
},
"Errors": [
{
"Type": 0,
"Severity": 0
}
],
"Warnings": [
{
"Type": 0,
"Severity": 0
}
]
}

Service Unavailable

Media typeapplication/json
object
Data

Safe selected hierarchy chain resolution.

object
State
integer format: int32
Allowed values: 0 1 2 3 4 5 6 7 8 9 10
ErrorCode

Stable guidance code for a closed or ineligible state.

string
nullable
Chain

Readable root-to-terminal chain for eligible or observable ineligible selections only.

Array<object>
nullable

One display-safe hierarchy option.

object
Id

Entity Instance identifier.

string
nullable
DisplayName

Current display name.

string
nullable
Subtitle

Optional current subtitle.

string
nullable
HasChildren

Whether at least one readable structural child exists.

boolean
CanConfirm

Whether the option may be returned as the terminal Reference value.

boolean
ConfirmationState
integer format: int32
Allowed values: 0 1 2
ConfirmationMessage

Optional safe localized explanation for a non-confirmable state.

string
nullable
SelectedValue

Compact runtime payload for one resolved or unresolved entity reference.

object
State
integer format: int32
Allowed values: 0 1 2
Id

Linked entity identifier when resolved.

string
nullable
Number

Linked entity number when resolved.

string
nullable
DisplayName

Linked entity display name from the presentation cache when resolved.

string
nullable
Subtitle

Linked entity subtitle from the presentation cache when resolved.

string
nullable
ProjectedValues

Projected primary-field scalar values and requested nested reference values keyed by target field key when resolved.

object
key
additional properties
nullable
EntityDefinitionId

Linked entity definition identifier when resolved.

string
nullable
ProjectedPlainTextPreviews

Compact server-created previews for projected Markdown fields, keyed by target field key.

object
key
additional properties

Safe compact visible-text representation of a Markdown value.

object
Text

Visible text when available.

string
nullable
IsTruncated

Whether the visible text was shortened for compact presentation.

boolean
State
integer format: int32
Allowed values: 0 1 2 3
SemanticPresentation

Safe compact reference metadata, projected only for a resolved visible Entity reference.

object
UsageType
integer format: int32
Allowed values: 0 1 2
SemanticType
string
nullable
LinkRegistrationKey
string
nullable
CellRegistrationKey
string
nullable
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": {
"State": 0,
"Chain": [
{
"ConfirmationState": 0
}
],
"SelectedValue": {
"State": 0,
"ProjectedPlainTextPreviews": {
"additionalProperty": {
"State": 0
}
},
"SemanticPresentation": {
"UsageType": 0
}
}
},
"Errors": [
{
"Type": 0,
"Severity": 0
}
],
"Warnings": [
{
"Type": 0,
"Severity": 0
}
]
}