Skip to content
MoltaroMoltaroMoltaro Docs

Atomically execute one Manual Order move for a persisted Lookup table.

POST
/api/workspace/entity/{entityIdOrKey}/ui/form/{formSurfaceId}/items/{formItemId}/lookup-table/move
curl --request POST \
  --url https://example.com/api/workspace/entity/example/ui/form/example/items/example/lookup-table/move \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "OperationKey": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "MovedInstanceId": "example", "Kind": 0, "TargetInstanceId": "example", "ExpectedInstanceRowVersion": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "ExpectedTargetInstanceRowVersion": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "ExpectedTableSurfaceId": "example", "ExpectedTableSurfaceRowVersion": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "ExpectedLookupFormSurfaceRowVersion": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0" }'

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”

Persisted Lookup Manual Order move intent with its saved Form revision.

object
OperationKey
required

Caller-owned stable key used to replay one logical move safely.

string format: uuid
MovedInstanceId
required

Entity Instance to move.

string
>= 1 characters
Kind
required
integer format: int32
Allowed values: 0 1 2 3 4 5 6
TargetInstanceId

Target instance for target-bearing kinds; absent for root-boundary kinds.

string
nullable
ExpectedInstanceRowVersion
required

Expected moved Entity Instance concurrency token.

string format: uuid
ExpectedTargetInstanceRowVersion

Expected target Entity Instance concurrency token, required exactly when a target is present.

string format: uuid
nullable
ExpectedTableSurfaceId
required

Expected resolved Table Surface identifier.

string
>= 1 characters
ExpectedTableSurfaceRowVersion
required

Expected resolved Table Surface concurrency token.

string format: uuid
ExpectedLookupFormSurfaceRowVersion
required

Expected saved Form Surface revision that owns the Lookup item.

string format: uuid

Responses

Section titled “Responses”

200

Section titled “200”

OK

Media typeapplication/json
object
Data

Committed or authoritative no-op Manual Order move result.

object
Changed

Whether the move committed a rank or Parent change.

boolean
Instance

List item for one entity instance.

object
Id

Instance identifier.

string
nullable
Number

Server-generated entity number.

string
nullable
DisplayName

Resolved entity display name or fallback number.

string
nullable
Subtitle

Resolved entity subtitle from the presentation cache.

string
nullable
CreatedAt

Instance creation timestamp.

string format: date-time
CreatedByUserId

Creating user identifier when available.

string
nullable
ModifiedAt

Last modification timestamp when available.

string format: date-time
nullable
ModifiedByUserId

Last modifying user identifier when available.

string
nullable
ArchivedAt

Archive timestamp when the instance is archived.

string format: date-time
nullable
ArchivedByUserId

Archiving user identifier when available.

string
nullable
LastComment

Compact summary of the latest comment on an entity instance.

object
Id

Comment identifier.

string
nullable
CommentText

Comment text.

string
nullable
CreatedByUserId

Comment author identifier.

string
nullable
CreatedByUserName

Comment author display name.

string
nullable
CreatedAt

Comment creation timestamp.

string format: date-time
Tags

Visible tags for the instance. List payloads include the first few tags only.

Array<object>
nullable

Compact tag details for one entity instance.

object
Id

Tag identifier.

string
nullable
TagName

Tag name.

string
nullable
Color

Optional color value.

string
nullable
Category

Optional category.

string
nullable
TagCount

Total number of tags on the instance.

integer format: int32
LastActivityDateTime

Last activity timestamp for the instance.

string format: date-time
RowVersion

Runtime row-version token from the primary table.

string format: uuid
Fields

Readable primary-table scalar fields keyed by field key. Denied fields are omitted.

object
key
additional properties

Field envelope for runtime entity-instance responses.

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

Canonical stored value for the field when State is Moltaro.Enums.EntityInstanceFieldStateEnum.Value.

nullable
PlainTextPreview

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
Predicates

Runtime-evaluated statement results keyed by statement identifier.

object
key
additional properties
boolean
Permissions

Item-level permissions for one entity instance.

object
CanRead

Whether the caller can read the active instance.

boolean
CanReadArchive

Whether the caller can read the instance while it is archived.

boolean
CanReadChangesHistory

Whether the caller can read the change history for this instance.

boolean
CanReadComments

Whether comments can be viewed for this instance.

boolean
CanReadTags

Whether tags can be viewed for this instance.

boolean
CanReadAttachments

Whether attachments can be viewed for this instance.

boolean
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
Assignments

Relation assignments keyed by relation key for record-scoped entities.

object
key
additional properties
Array<object>

Display-safe common responsibility subject in Entity runtime payloads.

object
SubjectType

Common subject discriminator: User or ResponsibilityGroup.

string
nullable
SubjectId

Assigned subject identifier.

string
nullable
DisplayName

Display name resolved for the subject when available.

string
nullable
Description

Optional secondary subject description.

string
nullable
EffectiveFrom

Inclusive start of the responsibility interval.

string format: date-time
nullable
EffectiveTo

Exclusive end of the responsibility interval, or null for an open interval.

string format: date-time
nullable
MergeState

Merge state attached to entity instance payloads.

object
IsMergedAway
boolean
MergedIntoInstanceId
string
nullable
MergeOperationId
string
nullable
DisplayFields

Display-only computed fields keyed by display-field key.

object
key
additional properties
string
ProjectionSource

Display-only source member metadata for a projection row.

object
ProjectionMemberId
string
nullable
ReferenceFieldId
string
nullable
SourceEntityDefinitionId
string
nullable
Label
string
nullable
SourceEntityDisplayNameSingular
string
nullable
SourceEntityDisplayNamePlural
string
nullable
ObjectContextFacts

Provider-owned object-context facts keyed by provider key.

object
key
additional properties
ObjectContextFactMembers

Validated live context members keyed by Entity binding identifier.

object
key
additional properties

Authorized members from one selected source instance, projected once per binding and record.

object
State

Availability of a context source or one of its typed members.

integer format: int32
Allowed values: 0 1 2 3 4
Handle

Exact selected source instance and its provider-owned version token. Core must not interpret the token or reselect another instance when a mutation supplies this handle.

object
Resource

Stable identity of one Moltaro resource instance.

object
ModuleKey
string
nullable
ResourceKind
string
nullable
ContextResourceId
string
nullable
ResourceObjectId
string
nullable
Version
string
nullable
Values
object
key
additional properties

One typed value; restricted and unavailable values carry no payload or display text.

object
State

Availability of a context source or one of its typed members.

integer format: int32
Allowed values: 0 1 2 3 4
Value
nullable
DisplayValue
string
nullable
PlainTextPreview

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
CanEdit

Whether the provider permits ordinary editing of this exact readable source member.

boolean
ObjectInvariant

Resource-neutral current invariant state and complete object-operation decision set.

object
Resource

Stable identity of one Moltaro resource instance.

object
ModuleKey
string
nullable
ResourceKind
string
nullable
ContextResourceId
string
nullable
ResourceObjectId
string
nullable
BusinessInvariants

Current safe state of every applicable enabled Business Invariant.

Array<object>
nullable

Current safe state of one Business Invariant target for one resource.

object
InvariantKey

Stable invariant key.

string
nullable
TargetKey

Stable target key within the invariant.

string
nullable
IsActive

Whether the invariant is active for the current resource state.

boolean
SafeMessage

Localized safe active-state message, or null when inactive.

string
nullable
Operations

Explicit decision for every applicable and discoverable Object Operation Catalog entry on the current surface.

object
key
additional properties

Composed current decision for one applicable object operation.

object
OperationKey

Stable Object Operation Catalog key.

string
nullable
IsAllowed

Whether all independent authorities allow the operation.

boolean
Denials

Deterministically ordered safe denial details.

Array<object>
nullable

One safe denial contributing to a composed object-operation decision.

object
Source

Identifies the independent authority that denied an object operation.

integer format: int32
Allowed values: 0 1 2 3
SourceKey

Stable source identity, such as an invariant key or domain policy key.

string
nullable
ReasonCode

Stable machine-readable reason code.

string
nullable
SafeMessage

Non-empty localized safe message.

string
nullable
WritableFieldIds

Readable primary scalar field identifiers the current actor may write on this row, in ordinal order; empty when the actor cannot update the row (including archived rows). Read-only definitions, calculated targets and editability rules are decided separately; this list only reflects field access, and a save remains authoritative. The list grows with the number of writable fields on every row of a list or query response.

Array<string>
nullable
ProjectionEventId

Opaque matching projection event identifier for a changed committed move only.

string
nullable
Receipt

Returns a safe receipt when post-state View is denied.

object
OperationKey
string format: uuid
CompletedAt
string format: date-time
CallerKnownIdentity
object
key
additional properties
string
AuditCorrelationId
string
nullable
Kind
string
nullable
Success
boolean
CanViewResult
boolean
IsIdempotentReplay

Whether this result was returned from the durable replay record.

boolean
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": {
    "Instance": {
      "Fields": {
        "additionalProperty": {
          "State": 0,
          "PlainTextPreview": {
            "State": 0
          }
        }
      },
      "SemanticPresentation": {
        "UsageType": 0
      },
      "ObjectContextFactMembers": {
        "additionalProperty": {
          "State": 0,
          "Values": {
            "additionalProperty": {
              "State": 0,
              "PlainTextPreview": {
                "State": 0
              }
            }
          }
        }
      },
      "ObjectInvariant": {
        "Operations": {
          "additionalProperty": {
            "Denials": [
              {
                "Source": 0
              }
            ]
          }
        }
      }
    }
  },
  "Errors": [
    {
      "Type": 0,
      "Severity": 0
    }
  ],
  "Warnings": [
    {
      "Type": 0,
      "Severity": 0
    }
  ]
}

400

Section titled “400”

Bad Request

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

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

409

Section titled “409”

Conflict

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

503

Section titled “503”

Service Unavailable