Skip to content

Patch instance.

PATCH
/api/workspace/entity/{entityIdOrKey}/instances/{instanceId}
curl --request PATCH \
--url https://example.com/api/workspace/entity/example/instances/example \
--header 'Content-Type: application/json' \
--data '{ "Fields": { "additionalProperty": {} }, "RowVersion": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0" }'

PATCH uses tri-state field semantics: omitted keys are undefined and remain unchanged, explicit null clears a field, and any other value replaces the stored value. Undefined fields do not pass through required validation. Unauthorized field inputs are skipped and returned as warnings.

  • None
entityIdOrKey
required
string

Entity definition identifier or normalized entity key.

instanceId
required
string

Entity instance identifier.

access_token
string

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

Partial mutation payload.

PATCH payload for a dynamic entity instance.

object
Fields

Dynamic field map keyed by field key. Omitted keys are treated as undefined and remain unchanged. Explicit null values clear the stored value. Any other value replaces the stored value. Required validation runs only for writable fields that participate in the current patch. Table field rows may include a reserved top-level Id to update an existing child row in place.

object
key
additional properties
object
RowVersion

Expected runtime row version of the instance being patched.

string format: uuid
Examplegenerated
{
"Fields": {
"additionalProperty": {}
},
"RowVersion": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0"
}

OK

Media typeapplication/json
object
Data

Mutation response for create, patch, archive, restore, and delete operations.

object
InstanceId

Affected instance identifier.

string
nullable
RowVersion

Current optimistic-concurrency token after the mutation completes. This is null after permanent delete.

string format: uuid
nullable
ReadableAfterMutation

Whether the active caller can read the instance after the mutation completes.

boolean
Instance

Detailed entity-instance response.

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.

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

All runtime fields keyed by field key. User and role fields return compact reference models. Table fields return table metadata together with child rows.

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.

object
Predicates

Runtime-evaluated statement results keyed by statement identifier.

object
key
additional properties
boolean
Assignments

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

object
key
additional properties
Array<object>

Assignment target in runtime entity-instance payloads.

object
SubjectType
integer format: int32
Allowed values: 0 1
SubjectId

Assigned subject identifier.

string
nullable
DisplayName

Display name resolved for the assignment subject when available.

string
nullable
Description

Optional secondary subject description.

string
nullable
Origin
integer format: int32
Allowed values: 0 1
SystemManaged

Whether the assignment row is managed by Moltaro runtime logic instead of direct user mutation.

boolean
InheritanceSource

Display-safe source metadata for a runtime assignment inherited from a parent record.

object
ParentEntityDefinitionId

Parent entity definition identifier.

string
nullable
ParentEntityDisplayName

Parent entity user-facing display name.

string
nullable
ParentRecord

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
SourceRelationDefinitionId

Immediate source assignment relation identifier when available.

string
nullable
SourceRelationKey

Immediate source assignment relation key when available.

string
nullable
SourceRelationDisplayName

Immediate source assignment relation display name when available.

string
nullable
RecalculatedAtUtc

Timestamp when the inherited assignment row was last recalculated.

string format: date-time
nullable
InheritedDepth

Materialized inheritance depth.

integer format: int32
nullable
AssignmentPermissions

Per-relation assignment mutation permissions keyed by relation key.

object
key
additional properties

Server-computed mutation permissions for one relation slot on one entity instance.

object
CanUpdate

Whether the caller can replace the assignment set for the relation slot.

boolean
Permissions

Item-level permissions for one entity instance.

object
CanRead

Whether the caller can read the active instance.

boolean
CanUpdate

Whether the caller can patch the active instance.

boolean
CanArchive

Whether the caller can archive the active instance.

boolean
CanDelete

Whether the caller can permanently delete the instance after archival.

boolean
CanRestore

Whether the caller can restore the archived instance.

boolean
CanMerge

Whether the caller can merge this active instance with another 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
CanCreateComments

Whether comments can be created for this instance.

boolean
CanUpdateComments

Whether comments can be updated for this instance.

boolean
CanDeleteComments

Whether comments can be deleted for this instance.

boolean
CanReadTags

Whether tags can be viewed for this instance.

boolean
CanCreateTags

Whether tags can be created for this instance.

boolean
CanUpdateTags

Whether tags can be updated for this instance.

boolean
CanDeleteTags

Whether tags can be deleted for this instance.

boolean
CanReadAttachments

Whether attachments can be viewed for this instance.

boolean
CanCreateAttachments

Whether attachments can be created for this instance.

boolean
CanUpdateAttachments

Whether attachments can be updated for this instance.

boolean
CanDeleteAttachments

Whether attachments can be deleted for this instance.

boolean
AssignmentRelations

Runtime relation metadata for record-scoped assignment sections.

Array<object>
nullable

Runtime relation slot metadata for record-scoped assignments.

object
Id

Relation definition identifier.

string
nullable
Key

Relation definition key.

string
nullable
DisplayName

Relation display name.

string
nullable
Cardinality
integer format: int32
Allowed values: 0 1
IsRequired

Whether the relation must keep at least one assignment.

boolean
SubjectMode
integer format: int32
Allowed values: 0 1 2
SortOrder

Relation display order.

integer format: int32
Permissions

Server-computed mutation permissions for one relation slot on one entity instance.

object
CanUpdate

Whether the caller can replace the assignment set for the relation slot.

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

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

object
key
additional properties
object
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
}
},
"Assignments": {
"additionalProperty": [
{
"SubjectType": 0,
"Origin": 0,
"InheritanceSource": {
"ParentRecord": {
"State": 0
}
}
}
]
},
"AssignmentRelations": [
{
"Cardinality": 0,
"SubjectMode": 0
}
]
}
},
"Errors": [
{
"Type": 0,
"Severity": 0
}
],
"Warnings": [
{
"Type": 0,
"Severity": 0
}
]
}

Bad Request

Media typeapplication/json
object
Data

Mutation response for create, patch, archive, restore, and delete operations.

object
InstanceId

Affected instance identifier.

string
nullable
RowVersion

Current optimistic-concurrency token after the mutation completes. This is null after permanent delete.

string format: uuid
nullable
ReadableAfterMutation

Whether the active caller can read the instance after the mutation completes.

boolean
Instance

Detailed entity-instance response.

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.

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

All runtime fields keyed by field key. User and role fields return compact reference models. Table fields return table metadata together with child rows.

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.

object
Predicates

Runtime-evaluated statement results keyed by statement identifier.

object
key
additional properties
boolean
Assignments

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

object
key
additional properties
Array<object>

Assignment target in runtime entity-instance payloads.

object
SubjectType
integer format: int32
Allowed values: 0 1
SubjectId

Assigned subject identifier.

string
nullable
DisplayName

Display name resolved for the assignment subject when available.

string
nullable
Description

Optional secondary subject description.

string
nullable
Origin
integer format: int32
Allowed values: 0 1
SystemManaged

Whether the assignment row is managed by Moltaro runtime logic instead of direct user mutation.

boolean
InheritanceSource

Display-safe source metadata for a runtime assignment inherited from a parent record.

object
ParentEntityDefinitionId

Parent entity definition identifier.

string
nullable
ParentEntityDisplayName

Parent entity user-facing display name.

string
nullable
ParentRecord

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
SourceRelationDefinitionId

Immediate source assignment relation identifier when available.

string
nullable
SourceRelationKey

Immediate source assignment relation key when available.

string
nullable
SourceRelationDisplayName

Immediate source assignment relation display name when available.

string
nullable
RecalculatedAtUtc

Timestamp when the inherited assignment row was last recalculated.

string format: date-time
nullable
InheritedDepth

Materialized inheritance depth.

integer format: int32
nullable
AssignmentPermissions

Per-relation assignment mutation permissions keyed by relation key.

object
key
additional properties

Server-computed mutation permissions for one relation slot on one entity instance.

object
CanUpdate

Whether the caller can replace the assignment set for the relation slot.

boolean
Permissions

Item-level permissions for one entity instance.

object
CanRead

Whether the caller can read the active instance.

boolean
CanUpdate

Whether the caller can patch the active instance.

boolean
CanArchive

Whether the caller can archive the active instance.

boolean
CanDelete

Whether the caller can permanently delete the instance after archival.

boolean
CanRestore

Whether the caller can restore the archived instance.

boolean
CanMerge

Whether the caller can merge this active instance with another 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
CanCreateComments

Whether comments can be created for this instance.

boolean
CanUpdateComments

Whether comments can be updated for this instance.

boolean
CanDeleteComments

Whether comments can be deleted for this instance.

boolean
CanReadTags

Whether tags can be viewed for this instance.

boolean
CanCreateTags

Whether tags can be created for this instance.

boolean
CanUpdateTags

Whether tags can be updated for this instance.

boolean
CanDeleteTags

Whether tags can be deleted for this instance.

boolean
CanReadAttachments

Whether attachments can be viewed for this instance.

boolean
CanCreateAttachments

Whether attachments can be created for this instance.

boolean
CanUpdateAttachments

Whether attachments can be updated for this instance.

boolean
CanDeleteAttachments

Whether attachments can be deleted for this instance.

boolean
AssignmentRelations

Runtime relation metadata for record-scoped assignment sections.

Array<object>
nullable

Runtime relation slot metadata for record-scoped assignments.

object
Id

Relation definition identifier.

string
nullable
Key

Relation definition key.

string
nullable
DisplayName

Relation display name.

string
nullable
Cardinality
integer format: int32
Allowed values: 0 1
IsRequired

Whether the relation must keep at least one assignment.

boolean
SubjectMode
integer format: int32
Allowed values: 0 1 2
SortOrder

Relation display order.

integer format: int32
Permissions

Server-computed mutation permissions for one relation slot on one entity instance.

object
CanUpdate

Whether the caller can replace the assignment set for the relation slot.

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

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

object
key
additional properties
object
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
}
},
"Assignments": {
"additionalProperty": [
{
"SubjectType": 0,
"Origin": 0,
"InheritanceSource": {
"ParentRecord": {
"State": 0
}
}
}
]
},
"AssignmentRelations": [
{
"Cardinality": 0,
"SubjectMode": 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

Mutation response for create, patch, archive, restore, and delete operations.

object
InstanceId

Affected instance identifier.

string
nullable
RowVersion

Current optimistic-concurrency token after the mutation completes. This is null after permanent delete.

string format: uuid
nullable
ReadableAfterMutation

Whether the active caller can read the instance after the mutation completes.

boolean
Instance

Detailed entity-instance response.

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.

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

All runtime fields keyed by field key. User and role fields return compact reference models. Table fields return table metadata together with child rows.

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.

object
Predicates

Runtime-evaluated statement results keyed by statement identifier.

object
key
additional properties
boolean
Assignments

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

object
key
additional properties
Array<object>

Assignment target in runtime entity-instance payloads.

object
SubjectType
integer format: int32
Allowed values: 0 1
SubjectId

Assigned subject identifier.

string
nullable
DisplayName

Display name resolved for the assignment subject when available.

string
nullable
Description

Optional secondary subject description.

string
nullable
Origin
integer format: int32
Allowed values: 0 1
SystemManaged

Whether the assignment row is managed by Moltaro runtime logic instead of direct user mutation.

boolean
InheritanceSource

Display-safe source metadata for a runtime assignment inherited from a parent record.

object
ParentEntityDefinitionId

Parent entity definition identifier.

string
nullable
ParentEntityDisplayName

Parent entity user-facing display name.

string
nullable
ParentRecord

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
SourceRelationDefinitionId

Immediate source assignment relation identifier when available.

string
nullable
SourceRelationKey

Immediate source assignment relation key when available.

string
nullable
SourceRelationDisplayName

Immediate source assignment relation display name when available.

string
nullable
RecalculatedAtUtc

Timestamp when the inherited assignment row was last recalculated.

string format: date-time
nullable
InheritedDepth

Materialized inheritance depth.

integer format: int32
nullable
AssignmentPermissions

Per-relation assignment mutation permissions keyed by relation key.

object
key
additional properties

Server-computed mutation permissions for one relation slot on one entity instance.

object
CanUpdate

Whether the caller can replace the assignment set for the relation slot.

boolean
Permissions

Item-level permissions for one entity instance.

object
CanRead

Whether the caller can read the active instance.

boolean
CanUpdate

Whether the caller can patch the active instance.

boolean
CanArchive

Whether the caller can archive the active instance.

boolean
CanDelete

Whether the caller can permanently delete the instance after archival.

boolean
CanRestore

Whether the caller can restore the archived instance.

boolean
CanMerge

Whether the caller can merge this active instance with another 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
CanCreateComments

Whether comments can be created for this instance.

boolean
CanUpdateComments

Whether comments can be updated for this instance.

boolean
CanDeleteComments

Whether comments can be deleted for this instance.

boolean
CanReadTags

Whether tags can be viewed for this instance.

boolean
CanCreateTags

Whether tags can be created for this instance.

boolean
CanUpdateTags

Whether tags can be updated for this instance.

boolean
CanDeleteTags

Whether tags can be deleted for this instance.

boolean
CanReadAttachments

Whether attachments can be viewed for this instance.

boolean
CanCreateAttachments

Whether attachments can be created for this instance.

boolean
CanUpdateAttachments

Whether attachments can be updated for this instance.

boolean
CanDeleteAttachments

Whether attachments can be deleted for this instance.

boolean
AssignmentRelations

Runtime relation metadata for record-scoped assignment sections.

Array<object>
nullable

Runtime relation slot metadata for record-scoped assignments.

object
Id

Relation definition identifier.

string
nullable
Key

Relation definition key.

string
nullable
DisplayName

Relation display name.

string
nullable
Cardinality
integer format: int32
Allowed values: 0 1
IsRequired

Whether the relation must keep at least one assignment.

boolean
SubjectMode
integer format: int32
Allowed values: 0 1 2
SortOrder

Relation display order.

integer format: int32
Permissions

Server-computed mutation permissions for one relation slot on one entity instance.

object
CanUpdate

Whether the caller can replace the assignment set for the relation slot.

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

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

object
key
additional properties
object
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
}
},
"Assignments": {
"additionalProperty": [
{
"SubjectType": 0,
"Origin": 0,
"InheritanceSource": {
"ParentRecord": {
"State": 0
}
}
}
]
},
"AssignmentRelations": [
{
"Cardinality": 0,
"SubjectMode": 0
}
]
}
},
"Errors": [
{
"Type": 0,
"Severity": 0
}
],
"Warnings": [
{
"Type": 0,
"Severity": 0
}
]
}

Conflict

Media typeapplication/json
object
Data

Mutation response for create, patch, archive, restore, and delete operations.

object
InstanceId

Affected instance identifier.

string
nullable
RowVersion

Current optimistic-concurrency token after the mutation completes. This is null after permanent delete.

string format: uuid
nullable
ReadableAfterMutation

Whether the active caller can read the instance after the mutation completes.

boolean
Instance

Detailed entity-instance response.

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.

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

All runtime fields keyed by field key. User and role fields return compact reference models. Table fields return table metadata together with child rows.

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.

object
Predicates

Runtime-evaluated statement results keyed by statement identifier.

object
key
additional properties
boolean
Assignments

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

object
key
additional properties
Array<object>

Assignment target in runtime entity-instance payloads.

object
SubjectType
integer format: int32
Allowed values: 0 1
SubjectId

Assigned subject identifier.

string
nullable
DisplayName

Display name resolved for the assignment subject when available.

string
nullable
Description

Optional secondary subject description.

string
nullable
Origin
integer format: int32
Allowed values: 0 1
SystemManaged

Whether the assignment row is managed by Moltaro runtime logic instead of direct user mutation.

boolean
InheritanceSource

Display-safe source metadata for a runtime assignment inherited from a parent record.

object
ParentEntityDefinitionId

Parent entity definition identifier.

string
nullable
ParentEntityDisplayName

Parent entity user-facing display name.

string
nullable
ParentRecord

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
SourceRelationDefinitionId

Immediate source assignment relation identifier when available.

string
nullable
SourceRelationKey

Immediate source assignment relation key when available.

string
nullable
SourceRelationDisplayName

Immediate source assignment relation display name when available.

string
nullable
RecalculatedAtUtc

Timestamp when the inherited assignment row was last recalculated.

string format: date-time
nullable
InheritedDepth

Materialized inheritance depth.

integer format: int32
nullable
AssignmentPermissions

Per-relation assignment mutation permissions keyed by relation key.

object
key
additional properties

Server-computed mutation permissions for one relation slot on one entity instance.

object
CanUpdate

Whether the caller can replace the assignment set for the relation slot.

boolean
Permissions

Item-level permissions for one entity instance.

object
CanRead

Whether the caller can read the active instance.

boolean
CanUpdate

Whether the caller can patch the active instance.

boolean
CanArchive

Whether the caller can archive the active instance.

boolean
CanDelete

Whether the caller can permanently delete the instance after archival.

boolean
CanRestore

Whether the caller can restore the archived instance.

boolean
CanMerge

Whether the caller can merge this active instance with another 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
CanCreateComments

Whether comments can be created for this instance.

boolean
CanUpdateComments

Whether comments can be updated for this instance.

boolean
CanDeleteComments

Whether comments can be deleted for this instance.

boolean
CanReadTags

Whether tags can be viewed for this instance.

boolean
CanCreateTags

Whether tags can be created for this instance.

boolean
CanUpdateTags

Whether tags can be updated for this instance.

boolean
CanDeleteTags

Whether tags can be deleted for this instance.

boolean
CanReadAttachments

Whether attachments can be viewed for this instance.

boolean
CanCreateAttachments

Whether attachments can be created for this instance.

boolean
CanUpdateAttachments

Whether attachments can be updated for this instance.

boolean
CanDeleteAttachments

Whether attachments can be deleted for this instance.

boolean
AssignmentRelations

Runtime relation metadata for record-scoped assignment sections.

Array<object>
nullable

Runtime relation slot metadata for record-scoped assignments.

object
Id

Relation definition identifier.

string
nullable
Key

Relation definition key.

string
nullable
DisplayName

Relation display name.

string
nullable
Cardinality
integer format: int32
Allowed values: 0 1
IsRequired

Whether the relation must keep at least one assignment.

boolean
SubjectMode
integer format: int32
Allowed values: 0 1 2
SortOrder

Relation display order.

integer format: int32
Permissions

Server-computed mutation permissions for one relation slot on one entity instance.

object
CanUpdate

Whether the caller can replace the assignment set for the relation slot.

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

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

object
key
additional properties
object
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
}
},
"Assignments": {
"additionalProperty": [
{
"SubjectType": 0,
"Origin": 0,
"InheritanceSource": {
"ParentRecord": {
"State": 0
}
}
}
]
},
"AssignmentRelations": [
{
"Cardinality": 0,
"SubjectMode": 0
}
]
}
},
"Errors": [
{
"Type": 0,
"Severity": 0
}
],
"Warnings": [
{
"Type": 0,
"Severity": 0
}
]
}