Skip to content

Return the effective runtime form model for the active caller.

GET
/api/workspace/entity/{entityIdOrKey}/ui/form
curl --request GET \
--url https://example.com/api/workspace/entity/example/ui/form
  • None
entityIdOrKey
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

Runtime form surface payload resolved for the active caller.

object
Meta

Minimal runtime entity metadata used by explicit UI surfaces.

object
EntityDefinitionId

Entity definition identifier.

string
nullable
Name

Internal entity key used by runtime routes.

string
nullable
DisplayNameSingular

User-facing singular name.

string
nullable
DisplayNamePlural

User-facing plural name.

string
nullable
AccessModel
integer format: int32
Allowed values: 0 1 2 3
CommentsEnabled

Whether entity comments are enabled.

boolean
AttachmentsEnabled

Whether entity attachments are enabled.

boolean
TagsEnabled

Whether entity tags are enabled.

boolean
FullTextSearchAvailable

Whether runtime full-text search is available for the definition.

boolean
Statements

Runtime-exposed statements for this entity.

Array<object>
nullable

Runtime statement descriptor exposed to clients together with predicate payloads.

object
Id

Statement identifier.

string
nullable
Name

Stable technical statement key.

string
nullable
DisplayName

User-facing statement label.

string
nullable
RuleEvaluationContext

Rule evaluation context shared with fast UI runtime evaluation.

object
CurrentUserId

Current workspace user identifier.

string
nullable
CurrentLocalDate

Workspace-local current date in ISO format.

string
nullable
TimeZone

Workspace time zone identifier.

string
nullable
GeneratedAtUtc

UTC instant when the context was generated.

string format: date-time
nullable
NextLocalMidnightUtc

UTC instant for the next midnight in the workspace time zone.

string format: date-time
nullable
ContextValues

Owner-scoped runtime values available to rule plans.

object
key
additional properties
object
IsProjection

Whether the entity is an enabled Projection Entity.

boolean
Selector

Selector for resolving an entity UI surface by default pointer or custom key.

object
Mode
integer format: int32
Allowed values: 0 1
SurfaceKey
string
nullable
Model

Persisted form surface.

object
Id

Surface identifier. This is empty when the model is not resolved.

string
nullable
Surface
integer format: int32
Allowed values: 0 1 2 3 4 5
MaxWidth

Maximum layout width in pixels.

integer format: int32
ColumnCount

Desktop column count.

integer format: int32
RowVersion

Concurrency token for persisted overrides.

string format: uuid
Items

Effective form items.

Array<object>
nullable

One form item.

object
Id

Stable item identifier.

string
nullable
ItemType
integer format: int32
Allowed values: 0 1 2
SortOrder

Display order.

integer format: int32
Column

Preferred desktop column.

integer format: int32
Label

Optional overridden label.

string
nullable
Hint

Optional hint text.

string
nullable
Binding

Resolved binding metadata for one UI field reference.

object
RefKind
integer format: int32
Allowed values: 0 1 2 3 4
FieldId

Field identifier when the binding points to an entity field.

string
nullable
FieldKey

Runtime field key when the binding points to an entity field.

string
nullable
SystemField
integer format: int32
Allowed values: 0 1 2 3 4 5 6 7 8 9 10 11 12 13
FieldType
integer format: int32
Allowed values: 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15
IsRequired

Whether the bound field is always required.

boolean
VisibleWhen

Visibility condition expression for draft-aware UI evaluation.

string
nullable
RequiredWhen

Requiredness condition expression for draft-aware UI evaluation.

string
nullable
EditableWhen

Editability condition expression for draft-aware UI evaluation.

string
nullable
VisibleWhenPlan

Compiled rule expression plan used by Moltaro runtime surfaces.

object
RuleEngineVersion

Stable rule engine version used to compile this plan.

string
nullable
Root

Compiled rule expression node.

object
Kind

Node kind, for example literal, path, eq, and, or.

string
nullable
Operator

Optional operator metadata.

string
nullable
Path

Field path for path nodes.

string
nullable
LiteralKind

Literal family for literal nodes.

string
nullable
Text

Text value or variable name.

string
nullable
Number

Numeric literal value.

number format: double
nullable
Bool

Boolean literal value.

boolean
nullable
OffsetDays

Date variable day offset.

integer format: int32
nullable
Left
object recursive
Right
object recursive
Items
Array<object> recursive
ResultFamily

Typed result family resolved by the backend binder.

string
nullable
SourceFamily

Backend source family for lookup-like or complex fields.

string
nullable
ResolvedPath

Canonical field path resolved by the backend binder.

string
nullable
RequiredWhenPlan

Compiled rule expression plan used by Moltaro runtime surfaces.

object
RuleEngineVersion

Stable rule engine version used to compile this plan.

string
nullable
Root

Compiled rule expression node.

object
Kind

Node kind, for example literal, path, eq, and, or.

string
nullable
Operator

Optional operator metadata.

string
nullable
Path

Field path for path nodes.

string
nullable
LiteralKind

Literal family for literal nodes.

string
nullable
Text

Text value or variable name.

string
nullable
Number

Numeric literal value.

number format: double
nullable
Bool

Boolean literal value.

boolean
nullable
OffsetDays

Date variable day offset.

integer format: int32
nullable
Left
object recursive
Right
object recursive
Items
Array<object> recursive
ResultFamily

Typed result family resolved by the backend binder.

string
nullable
SourceFamily

Backend source family for lookup-like or complex fields.

string
nullable
ResolvedPath

Canonical field path resolved by the backend binder.

string
nullable
EditableWhenPlan

Compiled rule expression plan used by Moltaro runtime surfaces.

object
RuleEngineVersion

Stable rule engine version used to compile this plan.

string
nullable
Root

Compiled rule expression node.

object
Kind

Node kind, for example literal, path, eq, and, or.

string
nullable
Operator

Optional operator metadata.

string
nullable
Path

Field path for path nodes.

string
nullable
LiteralKind

Literal family for literal nodes.

string
nullable
Text

Text value or variable name.

string
nullable
Number

Numeric literal value.

number format: double
nullable
Bool

Boolean literal value.

boolean
nullable
OffsetDays

Date variable day offset.

integer format: int32
nullable
Left
object recursive
Right
object recursive
Items
Array<object> recursive
ResultFamily

Typed result family resolved by the backend binder.

string
nullable
SourceFamily

Backend source family for lookup-like or complex fields.

string
nullable
ResolvedPath

Canonical field path resolved by the backend binder.

string
nullable
AllowMultiple

Whether the bound field allows multiple values.

boolean
DecimalPrecision

Decimal precision when applicable.

integer format: int32
nullable
DecimalScale

Decimal scale when applicable.

integer format: int32
nullable
StringMaxLength

String max length when applicable.

integer format: int32
nullable
ReferenceToEntityDefinitionId

Target entity definition identifier for reference-style fields.

string
nullable
PairedReferenceFieldId

Paired reference field identifier for inverse reference fields.

string
nullable
AllowSort

Whether root-list sorting by linked display value is allowed.

boolean
ReferenceDeleteBehavior
integer format: int32
Allowed values: 0 1
Options

Select options when applicable.

Array<object>
nullable

Option metadata for select fields.

object
Id

Option identifier.

string
nullable
EntityFieldDefinitionId

Owning field identifier.

string
nullable
Key

Option key.

string
nullable
Value

Option display value.

string
nullable
SortOrder

Sort order.

integer format: int32
TableFields

Access-shaped child-table fields when the binding targets a table field.

Array<object>
nullable

One access-shaped child-table field for runtime UI rendering.

object
Id

Child field identifier.

string
nullable
Label

Display label for the child field.

string
nullable
Binding
object recursive
Editor
integer format: int32
Allowed values: 0 1 2 3 4 5 6 7 8 9
Editable

Whether the caller may edit this child field.

boolean
ReferenceInputType
integer format: int32
Allowed values: 0 1 2
ReferenceRendererType
integer format: int32
Allowed values: 0 1
ReferenceLookupRenderType
integer format: int32
Allowed values: 0 1
ReferencePath

Reference path configured for breadcrumb rendering.

Array<string>
nullable
HasAccessibleChildFields

Whether the caller can access at least one child-table field.

boolean
HasNestedAccessibleTableFields

Whether the caller can access nested table child fields.

boolean
VisibleWhenOperationMode
integer format: int32
Allowed values: 0 1 2
RequiredWhenOperationMode
integer format: int32
Allowed values: 0 1 2
EditableWhenOperationMode
integer format: int32
Allowed values: 0 1 2
BaseCurrencyCode

Base currency code for Money fields.

string
nullable
RelationDefinitionId

Relation definition id when the binding targets a record-assignment relation slot.

string
nullable
RelationDefinitionKey

Relation definition key when the binding targets a record-assignment relation slot.

string
nullable
RelationDefinitionDisplayName

Relation display name when the binding targets a record-assignment relation slot.

string
nullable
RelationCardinality
integer format: int32
Allowed values: 0 1
RelationSubjectMode
integer format: int32
Allowed values: 0 1 2
DisplayFieldId

Display field identifier when the binding targets a display-only computed field.

string
nullable
DisplayFieldKey

Display field key when the binding targets a display-only computed field.

string
nullable
DisplayFieldDisplayName

Display field display name when the binding targets a display-only computed field.

string
nullable
ObjectContextFactId

Object-context fact configuration id when the binding targets a contextual fact.

string
nullable
ObjectContextFactProviderKey

Provider key that owns the object-context fact payload.

string
nullable
ObjectContextFactTarget
object
ModuleKey
string
nullable
ResourceKind
string
nullable
ContextResourceId
string
nullable
ResourceObjectId
string
nullable
AddressCoordinatesRequired

Whether an address field must be captured through a coordinate-aware editor.

boolean
Editor
integer format: int32
Allowed values: 0 1 2 3 4 5 6 7 8 9
Editable

Whether field editing is enabled.

boolean
EditorRows

Configured row count for textarea-style editors.

integer format: int32
nullable
TextBlockStyle
integer format: int32
Allowed values: 0 1 2 3 4 5 6 7 8
TextBlockText

Text-block content when the item is a text block.

string
nullable
AlertTone
integer format: int32
Allowed values: 0 1 2 3
AlertTitle

Optional alert title.

string
nullable
AlertText

Alert body.

string
nullable
MarginTop

Optional top margin in pixels.

integer format: int32
nullable
MarginBottom

Optional bottom margin in pixels.

integer format: int32
nullable
PaddingTop

Optional top padding in pixels.

integer format: int32
nullable
PaddingBottom

Optional bottom padding in pixels.

integer format: int32
nullable
PaddingLeft

Optional left padding in pixels.

integer format: int32
nullable
PaddingRight

Optional right padding in pixels.

integer format: int32
nullable
Visible

Whether the item remains visible in the effective runtime model.

boolean
ColumnSpan

Desktop column span.

integer format: int32
ReferenceInputType
integer format: int32
Allowed values: 0 1 2
ReferenceRendererType
integer format: int32
Allowed values: 0 1
ReferenceLookupRenderType
integer format: int32
Allowed values: 0 1
ReferencePath

Reference path configured for breadcrumb rendering.

Array<string>
nullable
LookupTableSelectors

Role-aware table selectors for lookup dialogs.

Array<object>
nullable

Role-aware selector row used by hosted surfaces and lookup inputs.

object
Id

Persisted selector row id. New client rows may send null.

string
nullable
Priority

Higher values are evaluated first.

integer format: int32
Mode
integer format: int32
Allowed values: 0 1
SurfaceKey

Custom surface key when Moltaro.Entity.Ui.Models.EntityUiSurfaceSelectorAdminModel.Mode is custom key.

string
nullable
RoleIds

Workspace role ids that may use the selector; empty means all roles.

Array<string>
nullable
RuleEvaluationContext

Rule evaluation context shared with fast UI runtime evaluation.

object
CurrentUserId

Current workspace user identifier.

string
nullable
CurrentLocalDate

Workspace-local current date in ISO format.

string
nullable
TimeZone

Workspace time zone identifier.

string
nullable
GeneratedAtUtc

UTC instant when the context was generated.

string format: date-time
nullable
NextLocalMidnightUtc

UTC instant for the next midnight in the workspace time zone.

string format: date-time
nullable
ContextValues

Owner-scoped runtime values available to rule plans.

object
key
additional properties
object
MissingSurface

Machine-readable state for a reusable UI surface that is intentionally missing.

object
SurfaceType
integer format: int32
Allowed values: 0 1 2 3 4 5
Reason
integer format: int32
Allowed values: 0 1
Selector

Selector for resolving an entity UI surface by default pointer or custom key.

object
Mode
integer format: int32
Allowed values: 0 1
SurfaceKey
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": {
"Meta": {
"AccessModel": 0
},
"Selector": {
"Mode": 0
},
"Model": {
"Surface": 0,
"Items": [
{
"ItemType": 0,
"Binding": {
"RefKind": 0,
"SystemField": 0,
"FieldType": 0,
"ReferenceDeleteBehavior": 0,
"TableFields": [
{
"Editor": 0,
"ReferenceInputType": 0,
"ReferenceRendererType": 0,
"ReferenceLookupRenderType": 0
}
],
"VisibleWhenOperationMode": 0,
"RequiredWhenOperationMode": 0,
"EditableWhenOperationMode": 0,
"RelationCardinality": 0,
"RelationSubjectMode": 0
},
"Editor": 0,
"TextBlockStyle": 0,
"AlertTone": 0,
"ReferenceInputType": 0,
"ReferenceRendererType": 0,
"ReferenceLookupRenderType": 0,
"LookupTableSelectors": [
{
"Mode": 0
}
]
}
]
},
"MissingSurface": {
"SurfaceType": 0,
"Reason": 0,
"Selector": {
"Mode": 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

Runtime form surface payload resolved for the active caller.

object
Meta

Minimal runtime entity metadata used by explicit UI surfaces.

object
EntityDefinitionId

Entity definition identifier.

string
nullable
Name

Internal entity key used by runtime routes.

string
nullable
DisplayNameSingular

User-facing singular name.

string
nullable
DisplayNamePlural

User-facing plural name.

string
nullable
AccessModel
integer format: int32
Allowed values: 0 1 2 3
CommentsEnabled

Whether entity comments are enabled.

boolean
AttachmentsEnabled

Whether entity attachments are enabled.

boolean
TagsEnabled

Whether entity tags are enabled.

boolean
FullTextSearchAvailable

Whether runtime full-text search is available for the definition.

boolean
Statements

Runtime-exposed statements for this entity.

Array<object>
nullable

Runtime statement descriptor exposed to clients together with predicate payloads.

object
Id

Statement identifier.

string
nullable
Name

Stable technical statement key.

string
nullable
DisplayName

User-facing statement label.

string
nullable
RuleEvaluationContext

Rule evaluation context shared with fast UI runtime evaluation.

object
CurrentUserId

Current workspace user identifier.

string
nullable
CurrentLocalDate

Workspace-local current date in ISO format.

string
nullable
TimeZone

Workspace time zone identifier.

string
nullable
GeneratedAtUtc

UTC instant when the context was generated.

string format: date-time
nullable
NextLocalMidnightUtc

UTC instant for the next midnight in the workspace time zone.

string format: date-time
nullable
ContextValues

Owner-scoped runtime values available to rule plans.

object
key
additional properties
object
IsProjection

Whether the entity is an enabled Projection Entity.

boolean
Selector

Selector for resolving an entity UI surface by default pointer or custom key.

object
Mode
integer format: int32
Allowed values: 0 1
SurfaceKey
string
nullable
Model

Persisted form surface.

object
Id

Surface identifier. This is empty when the model is not resolved.

string
nullable
Surface
integer format: int32
Allowed values: 0 1 2 3 4 5
MaxWidth

Maximum layout width in pixels.

integer format: int32
ColumnCount

Desktop column count.

integer format: int32
RowVersion

Concurrency token for persisted overrides.

string format: uuid
Items

Effective form items.

Array<object>
nullable

One form item.

object
Id

Stable item identifier.

string
nullable
ItemType
integer format: int32
Allowed values: 0 1 2
SortOrder

Display order.

integer format: int32
Column

Preferred desktop column.

integer format: int32
Label

Optional overridden label.

string
nullable
Hint

Optional hint text.

string
nullable
Binding

Resolved binding metadata for one UI field reference.

object
RefKind
integer format: int32
Allowed values: 0 1 2 3 4
FieldId

Field identifier when the binding points to an entity field.

string
nullable
FieldKey

Runtime field key when the binding points to an entity field.

string
nullable
SystemField
integer format: int32
Allowed values: 0 1 2 3 4 5 6 7 8 9 10 11 12 13
FieldType
integer format: int32
Allowed values: 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15
IsRequired

Whether the bound field is always required.

boolean
VisibleWhen

Visibility condition expression for draft-aware UI evaluation.

string
nullable
RequiredWhen

Requiredness condition expression for draft-aware UI evaluation.

string
nullable
EditableWhen

Editability condition expression for draft-aware UI evaluation.

string
nullable
VisibleWhenPlan

Compiled rule expression plan used by Moltaro runtime surfaces.

object
RuleEngineVersion

Stable rule engine version used to compile this plan.

string
nullable
Root

Compiled rule expression node.

object
Kind

Node kind, for example literal, path, eq, and, or.

string
nullable
Operator

Optional operator metadata.

string
nullable
Path

Field path for path nodes.

string
nullable
LiteralKind

Literal family for literal nodes.

string
nullable
Text

Text value or variable name.

string
nullable
Number

Numeric literal value.

number format: double
nullable
Bool

Boolean literal value.

boolean
nullable
OffsetDays

Date variable day offset.

integer format: int32
nullable
Left
object recursive
Right
object recursive
Items
Array<object> recursive
ResultFamily

Typed result family resolved by the backend binder.

string
nullable
SourceFamily

Backend source family for lookup-like or complex fields.

string
nullable
ResolvedPath

Canonical field path resolved by the backend binder.

string
nullable
RequiredWhenPlan

Compiled rule expression plan used by Moltaro runtime surfaces.

object
RuleEngineVersion

Stable rule engine version used to compile this plan.

string
nullable
Root

Compiled rule expression node.

object
Kind

Node kind, for example literal, path, eq, and, or.

string
nullable
Operator

Optional operator metadata.

string
nullable
Path

Field path for path nodes.

string
nullable
LiteralKind

Literal family for literal nodes.

string
nullable
Text

Text value or variable name.

string
nullable
Number

Numeric literal value.

number format: double
nullable
Bool

Boolean literal value.

boolean
nullable
OffsetDays

Date variable day offset.

integer format: int32
nullable
Left
object recursive
Right
object recursive
Items
Array<object> recursive
ResultFamily

Typed result family resolved by the backend binder.

string
nullable
SourceFamily

Backend source family for lookup-like or complex fields.

string
nullable
ResolvedPath

Canonical field path resolved by the backend binder.

string
nullable
EditableWhenPlan

Compiled rule expression plan used by Moltaro runtime surfaces.

object
RuleEngineVersion

Stable rule engine version used to compile this plan.

string
nullable
Root

Compiled rule expression node.

object
Kind

Node kind, for example literal, path, eq, and, or.

string
nullable
Operator

Optional operator metadata.

string
nullable
Path

Field path for path nodes.

string
nullable
LiteralKind

Literal family for literal nodes.

string
nullable
Text

Text value or variable name.

string
nullable
Number

Numeric literal value.

number format: double
nullable
Bool

Boolean literal value.

boolean
nullable
OffsetDays

Date variable day offset.

integer format: int32
nullable
Left
object recursive
Right
object recursive
Items
Array<object> recursive
ResultFamily

Typed result family resolved by the backend binder.

string
nullable
SourceFamily

Backend source family for lookup-like or complex fields.

string
nullable
ResolvedPath

Canonical field path resolved by the backend binder.

string
nullable
AllowMultiple

Whether the bound field allows multiple values.

boolean
DecimalPrecision

Decimal precision when applicable.

integer format: int32
nullable
DecimalScale

Decimal scale when applicable.

integer format: int32
nullable
StringMaxLength

String max length when applicable.

integer format: int32
nullable
ReferenceToEntityDefinitionId

Target entity definition identifier for reference-style fields.

string
nullable
PairedReferenceFieldId

Paired reference field identifier for inverse reference fields.

string
nullable
AllowSort

Whether root-list sorting by linked display value is allowed.

boolean
ReferenceDeleteBehavior
integer format: int32
Allowed values: 0 1
Options

Select options when applicable.

Array<object>
nullable

Option metadata for select fields.

object
Id

Option identifier.

string
nullable
EntityFieldDefinitionId

Owning field identifier.

string
nullable
Key

Option key.

string
nullable
Value

Option display value.

string
nullable
SortOrder

Sort order.

integer format: int32
TableFields

Access-shaped child-table fields when the binding targets a table field.

Array<object>
nullable

One access-shaped child-table field for runtime UI rendering.

object
Id

Child field identifier.

string
nullable
Label

Display label for the child field.

string
nullable
Binding
object recursive
Editor
integer format: int32
Allowed values: 0 1 2 3 4 5 6 7 8 9
Editable

Whether the caller may edit this child field.

boolean
ReferenceInputType
integer format: int32
Allowed values: 0 1 2
ReferenceRendererType
integer format: int32
Allowed values: 0 1
ReferenceLookupRenderType
integer format: int32
Allowed values: 0 1
ReferencePath

Reference path configured for breadcrumb rendering.

Array<string>
nullable
HasAccessibleChildFields

Whether the caller can access at least one child-table field.

boolean
HasNestedAccessibleTableFields

Whether the caller can access nested table child fields.

boolean
VisibleWhenOperationMode
integer format: int32
Allowed values: 0 1 2
RequiredWhenOperationMode
integer format: int32
Allowed values: 0 1 2
EditableWhenOperationMode
integer format: int32
Allowed values: 0 1 2
BaseCurrencyCode

Base currency code for Money fields.

string
nullable
RelationDefinitionId

Relation definition id when the binding targets a record-assignment relation slot.

string
nullable
RelationDefinitionKey

Relation definition key when the binding targets a record-assignment relation slot.

string
nullable
RelationDefinitionDisplayName

Relation display name when the binding targets a record-assignment relation slot.

string
nullable
RelationCardinality
integer format: int32
Allowed values: 0 1
RelationSubjectMode
integer format: int32
Allowed values: 0 1 2
DisplayFieldId

Display field identifier when the binding targets a display-only computed field.

string
nullable
DisplayFieldKey

Display field key when the binding targets a display-only computed field.

string
nullable
DisplayFieldDisplayName

Display field display name when the binding targets a display-only computed field.

string
nullable
ObjectContextFactId

Object-context fact configuration id when the binding targets a contextual fact.

string
nullable
ObjectContextFactProviderKey

Provider key that owns the object-context fact payload.

string
nullable
ObjectContextFactTarget
object
ModuleKey
string
nullable
ResourceKind
string
nullable
ContextResourceId
string
nullable
ResourceObjectId
string
nullable
AddressCoordinatesRequired

Whether an address field must be captured through a coordinate-aware editor.

boolean
Editor
integer format: int32
Allowed values: 0 1 2 3 4 5 6 7 8 9
Editable

Whether field editing is enabled.

boolean
EditorRows

Configured row count for textarea-style editors.

integer format: int32
nullable
TextBlockStyle
integer format: int32
Allowed values: 0 1 2 3 4 5 6 7 8
TextBlockText

Text-block content when the item is a text block.

string
nullable
AlertTone
integer format: int32
Allowed values: 0 1 2 3
AlertTitle

Optional alert title.

string
nullable
AlertText

Alert body.

string
nullable
MarginTop

Optional top margin in pixels.

integer format: int32
nullable
MarginBottom

Optional bottom margin in pixels.

integer format: int32
nullable
PaddingTop

Optional top padding in pixels.

integer format: int32
nullable
PaddingBottom

Optional bottom padding in pixels.

integer format: int32
nullable
PaddingLeft

Optional left padding in pixels.

integer format: int32
nullable
PaddingRight

Optional right padding in pixels.

integer format: int32
nullable
Visible

Whether the item remains visible in the effective runtime model.

boolean
ColumnSpan

Desktop column span.

integer format: int32
ReferenceInputType
integer format: int32
Allowed values: 0 1 2
ReferenceRendererType
integer format: int32
Allowed values: 0 1
ReferenceLookupRenderType
integer format: int32
Allowed values: 0 1
ReferencePath

Reference path configured for breadcrumb rendering.

Array<string>
nullable
LookupTableSelectors

Role-aware table selectors for lookup dialogs.

Array<object>
nullable

Role-aware selector row used by hosted surfaces and lookup inputs.

object
Id

Persisted selector row id. New client rows may send null.

string
nullable
Priority

Higher values are evaluated first.

integer format: int32
Mode
integer format: int32
Allowed values: 0 1
SurfaceKey

Custom surface key when Moltaro.Entity.Ui.Models.EntityUiSurfaceSelectorAdminModel.Mode is custom key.

string
nullable
RoleIds

Workspace role ids that may use the selector; empty means all roles.

Array<string>
nullable
RuleEvaluationContext

Rule evaluation context shared with fast UI runtime evaluation.

object
CurrentUserId

Current workspace user identifier.

string
nullable
CurrentLocalDate

Workspace-local current date in ISO format.

string
nullable
TimeZone

Workspace time zone identifier.

string
nullable
GeneratedAtUtc

UTC instant when the context was generated.

string format: date-time
nullable
NextLocalMidnightUtc

UTC instant for the next midnight in the workspace time zone.

string format: date-time
nullable
ContextValues

Owner-scoped runtime values available to rule plans.

object
key
additional properties
object
MissingSurface

Machine-readable state for a reusable UI surface that is intentionally missing.

object
SurfaceType
integer format: int32
Allowed values: 0 1 2 3 4 5
Reason
integer format: int32
Allowed values: 0 1
Selector

Selector for resolving an entity UI surface by default pointer or custom key.

object
Mode
integer format: int32
Allowed values: 0 1
SurfaceKey
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": {
"Meta": {
"AccessModel": 0
},
"Selector": {
"Mode": 0
},
"Model": {
"Surface": 0,
"Items": [
{
"ItemType": 0,
"Binding": {
"RefKind": 0,
"SystemField": 0,
"FieldType": 0,
"ReferenceDeleteBehavior": 0,
"TableFields": [
{
"Editor": 0,
"ReferenceInputType": 0,
"ReferenceRendererType": 0,
"ReferenceLookupRenderType": 0
}
],
"VisibleWhenOperationMode": 0,
"RequiredWhenOperationMode": 0,
"EditableWhenOperationMode": 0,
"RelationCardinality": 0,
"RelationSubjectMode": 0
},
"Editor": 0,
"TextBlockStyle": 0,
"AlertTone": 0,
"ReferenceInputType": 0,
"ReferenceRendererType": 0,
"ReferenceLookupRenderType": 0,
"LookupTableSelectors": [
{
"Mode": 0
}
]
}
]
},
"MissingSurface": {
"SurfaceType": 0,
"Reason": 0,
"Selector": {
"Mode": 0
}
}
},
"Errors": [
{
"Type": 0,
"Severity": 0
}
],
"Warnings": [
{
"Type": 0,
"Severity": 0
}
]
}

Conflict

Media typeapplication/json
object
Data

Runtime form surface payload resolved for the active caller.

object
Meta

Minimal runtime entity metadata used by explicit UI surfaces.

object
EntityDefinitionId

Entity definition identifier.

string
nullable
Name

Internal entity key used by runtime routes.

string
nullable
DisplayNameSingular

User-facing singular name.

string
nullable
DisplayNamePlural

User-facing plural name.

string
nullable
AccessModel
integer format: int32
Allowed values: 0 1 2 3
CommentsEnabled

Whether entity comments are enabled.

boolean
AttachmentsEnabled

Whether entity attachments are enabled.

boolean
TagsEnabled

Whether entity tags are enabled.

boolean
FullTextSearchAvailable

Whether runtime full-text search is available for the definition.

boolean
Statements

Runtime-exposed statements for this entity.

Array<object>
nullable

Runtime statement descriptor exposed to clients together with predicate payloads.

object
Id

Statement identifier.

string
nullable
Name

Stable technical statement key.

string
nullable
DisplayName

User-facing statement label.

string
nullable
RuleEvaluationContext

Rule evaluation context shared with fast UI runtime evaluation.

object
CurrentUserId

Current workspace user identifier.

string
nullable
CurrentLocalDate

Workspace-local current date in ISO format.

string
nullable
TimeZone

Workspace time zone identifier.

string
nullable
GeneratedAtUtc

UTC instant when the context was generated.

string format: date-time
nullable
NextLocalMidnightUtc

UTC instant for the next midnight in the workspace time zone.

string format: date-time
nullable
ContextValues

Owner-scoped runtime values available to rule plans.

object
key
additional properties
object
IsProjection

Whether the entity is an enabled Projection Entity.

boolean
Selector

Selector for resolving an entity UI surface by default pointer or custom key.

object
Mode
integer format: int32
Allowed values: 0 1
SurfaceKey
string
nullable
Model

Persisted form surface.

object
Id

Surface identifier. This is empty when the model is not resolved.

string
nullable
Surface
integer format: int32
Allowed values: 0 1 2 3 4 5
MaxWidth

Maximum layout width in pixels.

integer format: int32
ColumnCount

Desktop column count.

integer format: int32
RowVersion

Concurrency token for persisted overrides.

string format: uuid
Items

Effective form items.

Array<object>
nullable

One form item.

object
Id

Stable item identifier.

string
nullable
ItemType
integer format: int32
Allowed values: 0 1 2
SortOrder

Display order.

integer format: int32
Column

Preferred desktop column.

integer format: int32
Label

Optional overridden label.

string
nullable
Hint

Optional hint text.

string
nullable
Binding

Resolved binding metadata for one UI field reference.

object
RefKind
integer format: int32
Allowed values: 0 1 2 3 4
FieldId

Field identifier when the binding points to an entity field.

string
nullable
FieldKey

Runtime field key when the binding points to an entity field.

string
nullable
SystemField
integer format: int32
Allowed values: 0 1 2 3 4 5 6 7 8 9 10 11 12 13
FieldType
integer format: int32
Allowed values: 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15
IsRequired

Whether the bound field is always required.

boolean
VisibleWhen

Visibility condition expression for draft-aware UI evaluation.

string
nullable
RequiredWhen

Requiredness condition expression for draft-aware UI evaluation.

string
nullable
EditableWhen

Editability condition expression for draft-aware UI evaluation.

string
nullable
VisibleWhenPlan

Compiled rule expression plan used by Moltaro runtime surfaces.

object
RuleEngineVersion

Stable rule engine version used to compile this plan.

string
nullable
Root

Compiled rule expression node.

object
Kind

Node kind, for example literal, path, eq, and, or.

string
nullable
Operator

Optional operator metadata.

string
nullable
Path

Field path for path nodes.

string
nullable
LiteralKind

Literal family for literal nodes.

string
nullable
Text

Text value or variable name.

string
nullable
Number

Numeric literal value.

number format: double
nullable
Bool

Boolean literal value.

boolean
nullable
OffsetDays

Date variable day offset.

integer format: int32
nullable
Left
object recursive
Right
object recursive
Items
Array<object> recursive
ResultFamily

Typed result family resolved by the backend binder.

string
nullable
SourceFamily

Backend source family for lookup-like or complex fields.

string
nullable
ResolvedPath

Canonical field path resolved by the backend binder.

string
nullable
RequiredWhenPlan

Compiled rule expression plan used by Moltaro runtime surfaces.

object
RuleEngineVersion

Stable rule engine version used to compile this plan.

string
nullable
Root

Compiled rule expression node.

object
Kind

Node kind, for example literal, path, eq, and, or.

string
nullable
Operator

Optional operator metadata.

string
nullable
Path

Field path for path nodes.

string
nullable
LiteralKind

Literal family for literal nodes.

string
nullable
Text

Text value or variable name.

string
nullable
Number

Numeric literal value.

number format: double
nullable
Bool

Boolean literal value.

boolean
nullable
OffsetDays

Date variable day offset.

integer format: int32
nullable
Left
object recursive
Right
object recursive
Items
Array<object> recursive
ResultFamily

Typed result family resolved by the backend binder.

string
nullable
SourceFamily

Backend source family for lookup-like or complex fields.

string
nullable
ResolvedPath

Canonical field path resolved by the backend binder.

string
nullable
EditableWhenPlan

Compiled rule expression plan used by Moltaro runtime surfaces.

object
RuleEngineVersion

Stable rule engine version used to compile this plan.

string
nullable
Root

Compiled rule expression node.

object
Kind

Node kind, for example literal, path, eq, and, or.

string
nullable
Operator

Optional operator metadata.

string
nullable
Path

Field path for path nodes.

string
nullable
LiteralKind

Literal family for literal nodes.

string
nullable
Text

Text value or variable name.

string
nullable
Number

Numeric literal value.

number format: double
nullable
Bool

Boolean literal value.

boolean
nullable
OffsetDays

Date variable day offset.

integer format: int32
nullable
Left
object recursive
Right
object recursive
Items
Array<object> recursive
ResultFamily

Typed result family resolved by the backend binder.

string
nullable
SourceFamily

Backend source family for lookup-like or complex fields.

string
nullable
ResolvedPath

Canonical field path resolved by the backend binder.

string
nullable
AllowMultiple

Whether the bound field allows multiple values.

boolean
DecimalPrecision

Decimal precision when applicable.

integer format: int32
nullable
DecimalScale

Decimal scale when applicable.

integer format: int32
nullable
StringMaxLength

String max length when applicable.

integer format: int32
nullable
ReferenceToEntityDefinitionId

Target entity definition identifier for reference-style fields.

string
nullable
PairedReferenceFieldId

Paired reference field identifier for inverse reference fields.

string
nullable
AllowSort

Whether root-list sorting by linked display value is allowed.

boolean
ReferenceDeleteBehavior
integer format: int32
Allowed values: 0 1
Options

Select options when applicable.

Array<object>
nullable

Option metadata for select fields.

object
Id

Option identifier.

string
nullable
EntityFieldDefinitionId

Owning field identifier.

string
nullable
Key

Option key.

string
nullable
Value

Option display value.

string
nullable
SortOrder

Sort order.

integer format: int32
TableFields

Access-shaped child-table fields when the binding targets a table field.

Array<object>
nullable

One access-shaped child-table field for runtime UI rendering.

object
Id

Child field identifier.

string
nullable
Label

Display label for the child field.

string
nullable
Binding
object recursive
Editor
integer format: int32
Allowed values: 0 1 2 3 4 5 6 7 8 9
Editable

Whether the caller may edit this child field.

boolean
ReferenceInputType
integer format: int32
Allowed values: 0 1 2
ReferenceRendererType
integer format: int32
Allowed values: 0 1
ReferenceLookupRenderType
integer format: int32
Allowed values: 0 1
ReferencePath

Reference path configured for breadcrumb rendering.

Array<string>
nullable
HasAccessibleChildFields

Whether the caller can access at least one child-table field.

boolean
HasNestedAccessibleTableFields

Whether the caller can access nested table child fields.

boolean
VisibleWhenOperationMode
integer format: int32
Allowed values: 0 1 2
RequiredWhenOperationMode
integer format: int32
Allowed values: 0 1 2
EditableWhenOperationMode
integer format: int32
Allowed values: 0 1 2
BaseCurrencyCode

Base currency code for Money fields.

string
nullable
RelationDefinitionId

Relation definition id when the binding targets a record-assignment relation slot.

string
nullable
RelationDefinitionKey

Relation definition key when the binding targets a record-assignment relation slot.

string
nullable
RelationDefinitionDisplayName

Relation display name when the binding targets a record-assignment relation slot.

string
nullable
RelationCardinality
integer format: int32
Allowed values: 0 1
RelationSubjectMode
integer format: int32
Allowed values: 0 1 2
DisplayFieldId

Display field identifier when the binding targets a display-only computed field.

string
nullable
DisplayFieldKey

Display field key when the binding targets a display-only computed field.

string
nullable
DisplayFieldDisplayName

Display field display name when the binding targets a display-only computed field.

string
nullable
ObjectContextFactId

Object-context fact configuration id when the binding targets a contextual fact.

string
nullable
ObjectContextFactProviderKey

Provider key that owns the object-context fact payload.

string
nullable
ObjectContextFactTarget
object
ModuleKey
string
nullable
ResourceKind
string
nullable
ContextResourceId
string
nullable
ResourceObjectId
string
nullable
AddressCoordinatesRequired

Whether an address field must be captured through a coordinate-aware editor.

boolean
Editor
integer format: int32
Allowed values: 0 1 2 3 4 5 6 7 8 9
Editable

Whether field editing is enabled.

boolean
EditorRows

Configured row count for textarea-style editors.

integer format: int32
nullable
TextBlockStyle
integer format: int32
Allowed values: 0 1 2 3 4 5 6 7 8
TextBlockText

Text-block content when the item is a text block.

string
nullable
AlertTone
integer format: int32
Allowed values: 0 1 2 3
AlertTitle

Optional alert title.

string
nullable
AlertText

Alert body.

string
nullable
MarginTop

Optional top margin in pixels.

integer format: int32
nullable
MarginBottom

Optional bottom margin in pixels.

integer format: int32
nullable
PaddingTop

Optional top padding in pixels.

integer format: int32
nullable
PaddingBottom

Optional bottom padding in pixels.

integer format: int32
nullable
PaddingLeft

Optional left padding in pixels.

integer format: int32
nullable
PaddingRight

Optional right padding in pixels.

integer format: int32
nullable
Visible

Whether the item remains visible in the effective runtime model.

boolean
ColumnSpan

Desktop column span.

integer format: int32
ReferenceInputType
integer format: int32
Allowed values: 0 1 2
ReferenceRendererType
integer format: int32
Allowed values: 0 1
ReferenceLookupRenderType
integer format: int32
Allowed values: 0 1
ReferencePath

Reference path configured for breadcrumb rendering.

Array<string>
nullable
LookupTableSelectors

Role-aware table selectors for lookup dialogs.

Array<object>
nullable

Role-aware selector row used by hosted surfaces and lookup inputs.

object
Id

Persisted selector row id. New client rows may send null.

string
nullable
Priority

Higher values are evaluated first.

integer format: int32
Mode
integer format: int32
Allowed values: 0 1
SurfaceKey

Custom surface key when Moltaro.Entity.Ui.Models.EntityUiSurfaceSelectorAdminModel.Mode is custom key.

string
nullable
RoleIds

Workspace role ids that may use the selector; empty means all roles.

Array<string>
nullable
RuleEvaluationContext

Rule evaluation context shared with fast UI runtime evaluation.

object
CurrentUserId

Current workspace user identifier.

string
nullable
CurrentLocalDate

Workspace-local current date in ISO format.

string
nullable
TimeZone

Workspace time zone identifier.

string
nullable
GeneratedAtUtc

UTC instant when the context was generated.

string format: date-time
nullable
NextLocalMidnightUtc

UTC instant for the next midnight in the workspace time zone.

string format: date-time
nullable
ContextValues

Owner-scoped runtime values available to rule plans.

object
key
additional properties
object
MissingSurface

Machine-readable state for a reusable UI surface that is intentionally missing.

object
SurfaceType
integer format: int32
Allowed values: 0 1 2 3 4 5
Reason
integer format: int32
Allowed values: 0 1
Selector

Selector for resolving an entity UI surface by default pointer or custom key.

object
Mode
integer format: int32
Allowed values: 0 1
SurfaceKey
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": {
"Meta": {
"AccessModel": 0
},
"Selector": {
"Mode": 0
},
"Model": {
"Surface": 0,
"Items": [
{
"ItemType": 0,
"Binding": {
"RefKind": 0,
"SystemField": 0,
"FieldType": 0,
"ReferenceDeleteBehavior": 0,
"TableFields": [
{
"Editor": 0,
"ReferenceInputType": 0,
"ReferenceRendererType": 0,
"ReferenceLookupRenderType": 0
}
],
"VisibleWhenOperationMode": 0,
"RequiredWhenOperationMode": 0,
"EditableWhenOperationMode": 0,
"RelationCardinality": 0,
"RelationSubjectMode": 0
},
"Editor": 0,
"TextBlockStyle": 0,
"AlertTone": 0,
"ReferenceInputType": 0,
"ReferenceRendererType": 0,
"ReferenceLookupRenderType": 0,
"LookupTableSelectors": [
{
"Mode": 0
}
]
}
]
},
"MissingSurface": {
"SurfaceType": 0,
"Reason": 0,
"Selector": {
"Mode": 0
}
}
},
"Errors": [
{
"Type": 0,
"Severity": 0
}
],
"Warnings": [
{
"Type": 0,
"Severity": 0
}
]
}