Skip to content
MoltaroMoltaroMoltaro Docs

Confirm that one persisted Reference Lookup Tree node still belongs to the direct filtered seed and may be selected.

POST
/api/workspace/entity/{entityIdOrKey}/ui/form/{formSurfaceId}/items/{formItemId}/lookup-table/tree/selection
curl --request POST \
  --url https://example.com/api/workspace/entity/example/ui/form/example/items/example/lookup-table/tree/selection \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "ExpectedTableSurfaceId": "example", "ExpectedTableSurfaceRowVersion": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "ExpectedLookupFormSurfaceRowVersion": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "SourceInstanceId": "example", "CurrentValues": { "additionalProperty": "example" }, "ParentContext": { "EntityDefinitionId": "example", "FormSurfaceId": "example", "ExpectedRevision": "example", "ItemId": "example", "ParentInstanceId": "example", "ParentFields": { "additionalProperty": "example" } }, "ArchiveMode": 0, "Filter": { "Operator": 0, "Conditions": [ { "Field": { "FieldId": "example", "FieldKey": "example", "Special": 0, "StatementId": "example", "StatementKey": "example", "ObjectContextFactId": "example", "ObjectContextFactFilterKey": "example" }, "Target": { "Path": [ { "FieldId": "example", "FieldKey": "example", "Special": 0, "StatementId": "example", "StatementKey": "example", "ObjectContextFactId": "example", "ObjectContextFactFilterKey": "example" } ] }, "Operator": 0, "Values": [ { "Kind": 0, "Value": "example", "Variable": 0 } ], "RowsFilter": {}, "Spatial": { "ShapeKind": 0, "Center": { "Latitude": 1, "Longitude": 1, "FullAddress": "example" }, "RadiusKm": 1, "BoundingBox": { "SouthWest": { "Latitude": 1, "Longitude": 1, "FullAddress": "example" }, "NorthEast": { "Latitude": 1, "Longitude": 1, "FullAddress": "example" } }, "Polygon": [ { "Latitude": 1, "Longitude": 1, "FullAddress": "example" } ] } } ], "Groups": [] }, "SelectedId": "example" }'

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
entityIdOrKey
required
string
formSurfaceId
required
string
formItemId
required
string

Query Parameters

Section titled “Query Parameters”
access_token
string

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

Request Body

Section titled “Request Body”

Authoritative confirmation request for one node returned by a persisted Reference Lookup whose resolved Table Surface uses Parent Tree View.

object
ExpectedTableSurfaceId
required

Table Surface identifier returned by lookup bootstrap.

string
>= 1 characters
ExpectedTableSurfaceRowVersion
required

Table Surface revision returned by lookup bootstrap.

string format: uuid
ExpectedLookupFormSurfaceRowVersion
required

Source Form Surface revision returned by lookup bootstrap.

string format: uuid
SourceInstanceId

Existing source identifier for edit, or null for create.

string
nullable
CurrentValues

Dynamic Form draft values keyed by the server-declared source field keys. Reference values are raw Entity Instance identifier strings, not value wrappers.

object
key
additional properties

A typed scalar or complex field value. Reference fields use the raw Entity Instance identifier string.

nullable
ParentContext

The parent draft of a child draft in a Form with a WithParent section, sent with a child-scoped request made before the Form is saved. The server builds the parent’s effective draft for the actor (defaults, effects and calculations of the parent Form evaluation) and exposes it only as the record the child’s parent Reference points to; the child’s parent Reference is set by the server. Preview only: nothing is written and nothing is granted, the Form submission decides everything again.

object
EntityDefinitionId
required

Id of the parent Entity definition.

string
FormSurfaceId
required

Id of the parent Form surface.

string
ExpectedRevision
required

The Submission.Revision of the parent Form the client renders.

string
ItemId
required

Id of a WithParent related-table item of the child’s relation (any repeated item of that relation; its own child Form is the one the request runs on).

string
ParentInstanceId

Id of the existing parent record; null while the parent is created by the same Form.

string
nullable
ParentFields

Unsaved parent draft values by field key, as the parent Form evaluation takes them.

object
key
additional properties
ArchiveMode
integer format: int32
Allowed values: 0 1 2
Filter

One nested logical filter group.

object
Operator
integer format: int32
Allowed values: 0 1
Conditions

Direct conditions inside this group.

Array<object>
nullable

One leaf condition in the runtime list query tree.

object
Field

Reference to a runtime field by identifier, normalized key, or special query field. In a typed path the segment is resolved against the entity reached by the preceding reference.

object
FieldId

Field identifier or backend-issued synthetic system-field identifier. If FieldKey is also supplied, both must resolve to the same field.

string
nullable
FieldKey

Field key resolved through the current entity’s normalized-key index. If FieldId is also supplied, both must resolve to the same field.

string
nullable
Special
integer format: int32
Allowed values: 0 1
StatementId

Statement identifier resolved through the runtime statement index.

string
nullable
StatementKey

Statement key resolved through the runtime normalized-key index.

string
nullable
ObjectContextFactId

Configured object-context fact identifier.

string
nullable
ObjectContextFactFilterKey

Provider-owned object-context fact filter facet key.

string
nullable
Target

Typed server-side condition target. The first segment belongs to the queried entity; every intermediate segment must be a readable primary-table reference, and the terminal segment determines the field type, supported operators, and operand shape.

object
Path

Ordered path of one to six segments. Each segment may contain an ID, a key, or both; when both are supplied they must resolve to the same field in the entity reached by the preceding segment.

Array<object>
nullable

Reference to a runtime field by identifier, normalized key, or special query field. In a typed path the segment is resolved against the entity reached by the preceding reference.

object
FieldId

Field identifier or backend-issued synthetic system-field identifier. If FieldKey is also supplied, both must resolve to the same field.

string
nullable
FieldKey

Field key resolved through the current entity’s normalized-key index. If FieldId is also supplied, both must resolve to the same field.

string
nullable
Special
integer format: int32
Allowed values: 0 1
StatementId

Statement identifier resolved through the runtime statement index.

string
nullable
StatementKey

Statement key resolved through the runtime normalized-key index.

string
nullable
ObjectContextFactId

Configured object-context fact identifier.

string
nullable
ObjectContextFactFilterKey

Provider-owned object-context fact filter facet key.

string
nullable
Operator
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

Operand list for the selected operator.

Array<object>
nullable

One query operand.

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

Literal JSON value used when Moltaro.Entity.Instances.Requests.EntityInstanceQueryOperandRequest.Kind is Moltaro.Enums.EntityInstanceQueryOperandKindEnum.Value. Select and enum fields accept the string option key; numeric enum ordinals and display labels are not operands.

nullable
Variable
integer format: int32
Allowed values: 0 1
RowsFilter
object recursive
Spatial

Spatial operand for address-style runtime query conditions.

object
ShapeKind
integer format: int32
Allowed values: 0 1 2
Center

Geographic point in WGS84 coordinates.

object
Latitude

Latitude in decimal degrees.

number format: double
Longitude

Longitude in decimal degrees.

number format: double
FullAddress

Optional display address selected by the user.

string
nullable
RadiusKm

Radius in kilometers for radius-based queries.

number format: double
nullable
BoundingBox

Reserved WGS84 bounding box for future spatial queries.

object
SouthWest

Geographic point in WGS84 coordinates.

object
Latitude

Latitude in decimal degrees.

number format: double
Longitude

Longitude in decimal degrees.

number format: double
FullAddress

Optional display address selected by the user.

string
nullable
NorthEast

Geographic point in WGS84 coordinates.

object
Latitude

Latitude in decimal degrees.

number format: double
Longitude

Longitude in decimal degrees.

number format: double
FullAddress

Optional display address selected by the user.

string
nullable
Polygon

Reserved polygon payload for future spatial queries.

Array<object>
nullable

Geographic point in WGS84 coordinates.

object
Latitude

Latitude in decimal degrees.

number format: double
Longitude

Longitude in decimal degrees.

number format: double
FullAddress

Optional display address selected by the user.

string
nullable
Groups
Array<object> recursive
SelectedId
required

Proposed Tree node identifier.

string
>= 1 characters

Responses

Section titled “Responses”

200

Section titled “200”

OK

Media typeapplication/json
object
Data

Safe selected-value resolution result.

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

Stable guidance code when selection cannot proceed.

string
nullable
Item

Display-safe Reference candidate.

object
Id

Candidate Entity Instance identifier.

string
nullable
DisplayName

Current candidate display name.

string
nullable
Subtitle

Optional current candidate subtitle.

string
nullable
IsArchived

Whether the candidate is archived.

boolean
Number

Current candidate number.

string
nullable
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
ProjectedValues

Access-shaped target scalar and Money values keyed by target field key. Money values contain Amount and CurrencyCode.

object
key
additional properties
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,
    "Item": {
      "SemanticPresentation": {
        "UsageType": 0
      }
    }
  },
  "Errors": [
    {
      "Type": 0,
      "Severity": 0
    }
  ],
  "Warnings": [
    {
      "Type": 0,
      "Severity": 0
    }
  ]
}

400

Section titled “400”

Bad Request

Media typeapplication/json
object
Data

Safe selected-value resolution result.

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

Stable guidance code when selection cannot proceed.

string
nullable
Item

Display-safe Reference candidate.

object
Id

Candidate Entity Instance identifier.

string
nullable
DisplayName

Current candidate display name.

string
nullable
Subtitle

Optional current candidate subtitle.

string
nullable
IsArchived

Whether the candidate is archived.

boolean
Number

Current candidate number.

string
nullable
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
ProjectedValues

Access-shaped target scalar and Money values keyed by target field key. Money values contain Amount and CurrencyCode.

object
key
additional properties
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,
    "Item": {
      "SemanticPresentation": {
        "UsageType": 0
      }
    }
  },
  "Errors": [
    {
      "Type": 0,
      "Severity": 0
    }
  ],
  "Warnings": [
    {
      "Type": 0,
      "Severity": 0
    }
  ]
}

403

Section titled “403”

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"
}

404

Section titled “404”

Not Found

Media typeapplication/json
object
Data

Safe selected-value resolution result.

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

Stable guidance code when selection cannot proceed.

string
nullable
Item

Display-safe Reference candidate.

object
Id

Candidate Entity Instance identifier.

string
nullable
DisplayName

Current candidate display name.

string
nullable
Subtitle

Optional current candidate subtitle.

string
nullable
IsArchived

Whether the candidate is archived.

boolean
Number

Current candidate number.

string
nullable
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
ProjectedValues

Access-shaped target scalar and Money values keyed by target field key. Money values contain Amount and CurrencyCode.

object
key
additional properties
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,
    "Item": {
      "SemanticPresentation": {
        "UsageType": 0
      }
    }
  },
  "Errors": [
    {
      "Type": 0,
      "Severity": 0
    }
  ],
  "Warnings": [
    {
      "Type": 0,
      "Severity": 0
    }
  ]
}

409

Section titled “409”

Conflict

Media typeapplication/json
object
Data

Safe selected-value resolution result.

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

Stable guidance code when selection cannot proceed.

string
nullable
Item

Display-safe Reference candidate.

object
Id

Candidate Entity Instance identifier.

string
nullable
DisplayName

Current candidate display name.

string
nullable
Subtitle

Optional current candidate subtitle.

string
nullable
IsArchived

Whether the candidate is archived.

boolean
Number

Current candidate number.

string
nullable
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
ProjectedValues

Access-shaped target scalar and Money values keyed by target field key. Money values contain Amount and CurrencyCode.

object
key
additional properties
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,
    "Item": {
      "SemanticPresentation": {
        "UsageType": 0
      }
    }
  },
  "Errors": [
    {
      "Type": 0,
      "Severity": 0
    }
  ],
  "Warnings": [
    {
      "Type": 0,
      "Severity": 0
    }
  ]
}

503

Section titled “503”

Service Unavailable

Media typeapplication/json
object
Data

Safe selected-value resolution result.

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

Stable guidance code when selection cannot proceed.

string
nullable
Item

Display-safe Reference candidate.

object
Id

Candidate Entity Instance identifier.

string
nullable
DisplayName

Current candidate display name.

string
nullable
Subtitle

Optional current candidate subtitle.

string
nullable
IsArchived

Whether the candidate is archived.

boolean
Number

Current candidate number.

string
nullable
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
ProjectedValues

Access-shaped target scalar and Money values keyed by target field key. Money values contain Amount and CurrencyCode.

object
key
additional properties
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,
    "Item": {
      "SemanticPresentation": {
        "UsageType": 0
      }
    }
  },
  "Errors": [
    {
      "Type": 0,
      "Severity": 0
    }
  ],
  "Warnings": [
    {
      "Type": 0,
      "Severity": 0
    }
  ]
}