Skip to content

Return designer data for configuring function-backed UI actions.

GET
/api/workspace/admin/entity-definitions/{entityDefinitionId}/ui/actions/designer-model
curl --request GET \
--url 'https://example.com/api/workspace/admin/entity-definitions/example/ui/actions/designer-model?Surface=0'
  • None
entityDefinitionId
required
string
Surface
integer format: int32
Allowed values: 0 1 2 3 4 5
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

Designer payload for configuring function-backed UI actions on one entity definition.

object
EntityDefinitionId
string
nullable
Surface
integer format: int32
Allowed values: 0 1 2 3 4 5
Actions
Array<object>
nullable

Designer-owned action connecting a business function to a compatible UI surface context.

object
Id

Action identifier.

string
nullable
BusinessFunctionId

Bound business function identifier.

string
nullable
EntityDefinitionId

Entity definition identifier for entity-scoped action targets.

string
nullable
EntityUiSurfaceModelId

Entity UI surface model identifier when bound to a concrete surface.

string
nullable
Surface
integer format: int32
Allowed values: 0 1 2 3 4 5
ActionTargetScope
integer format: int32
Allowed values: 0 1 2 3
Placement
integer format: int32
Allowed values: 0 1 2
ToolbarPresentation
integer format: int32
Allowed values: 0 1
SortOrder

Action order within the placement.

integer format: int32
IsEnabled

Whether the binding is enabled.

boolean
Label

Optional label override.

string
nullable
Icon

Optional icon override.

string
nullable
Color

Vuetify color token.

string
nullable
Variant

Vuetify variant token.

string
nullable
PermissionKey

Optional action-specific permission gate.

string
nullable
RowVersion

Concurrency token.

string format: uuid
AvailableFunctions
Array<object>
nullable

Administrative business function summary.

object
Id

Function identifier.

string
nullable
Key

Stable function key.

string
nullable
Name

User-facing function name.

string
nullable
Description

Optional description.

string
nullable
Kind
integer format: int32
Allowed values: 0 1
EntityDefinitionId

Owning entity definition for entity functions.

string
nullable
IsEnabled

Whether the function can be invoked by future runtime slices.

boolean
CurrentPublishedVersionId

Current published version identifier.

string
nullable
CurrentPublishedContract
integer format: int32
Allowed values: 0 1 2 3 5 6 7
CreatedAt

Creation timestamp.

string format: date-time
ModifiedAt

Last metadata modification timestamp.

string format: date-time
nullable
ModifiedByUserId

Last modifying user identifier.

string
nullable
VersionCount

Number of stored immutable versions.

integer format: int32
LatestVersionNumber

Latest stored version number.

integer format: int32
nullable
LatestVersionPublishedAt

Publication timestamp for the latest stored version.

string format: date-time
nullable
CurrentPublishedVersionNumber

Current published version number.

integer format: int32
nullable
CurrentPublishedVersionPublishedAt

Publication timestamp for the current published version.

string format: date-time
nullable
LastRunStatus
integer format: int32
Allowed values: 0 1 2 3 4 5 6 7 8
LastRunStartedAt

Most recent persisted run start timestamp.

string format: date-time
nullable
RowVersion

Concurrency token.

string format: uuid
SupportedSurfaces
Array<integer>
nullable
Allowed values: 0 1 2 3 4 5
SupportedTargetScopes
Array<integer>
nullable
Allowed values: 0 1 2 3
SupportedPlacements
Array<integer>
nullable
Allowed values: 0 1 2
SupportedToolbarPresentations
Array<integer>
nullable
Allowed values: 0 1
SupportedColors
Array<string>
nullable
SupportedVariants
Array<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": {
"Surface": 0,
"Actions": [
{
"Surface": 0,
"ActionTargetScope": 0,
"Placement": 0,
"ToolbarPresentation": 0
}
],
"AvailableFunctions": [
{
"Kind": 0,
"CurrentPublishedContract": 0,
"LastRunStatus": 0
}
],
"SupportedSurfaces": [
0
],
"SupportedTargetScopes": [
0
],
"SupportedPlacements": [
0
],
"SupportedToolbarPresentations": [
0
]
},
"Errors": [
{
"Type": 0,
"Severity": 0
}
],
"Warnings": [
{
"Type": 0,
"Severity": 0
}
]
}

Bad Request

Media typeapplication/json
object
Data

Designer payload for configuring function-backed UI actions on one entity definition.

object
EntityDefinitionId
string
nullable
Surface
integer format: int32
Allowed values: 0 1 2 3 4 5
Actions
Array<object>
nullable

Designer-owned action connecting a business function to a compatible UI surface context.

object
Id

Action identifier.

string
nullable
BusinessFunctionId

Bound business function identifier.

string
nullable
EntityDefinitionId

Entity definition identifier for entity-scoped action targets.

string
nullable
EntityUiSurfaceModelId

Entity UI surface model identifier when bound to a concrete surface.

string
nullable
Surface
integer format: int32
Allowed values: 0 1 2 3 4 5
ActionTargetScope
integer format: int32
Allowed values: 0 1 2 3
Placement
integer format: int32
Allowed values: 0 1 2
ToolbarPresentation
integer format: int32
Allowed values: 0 1
SortOrder

Action order within the placement.

integer format: int32
IsEnabled

Whether the binding is enabled.

boolean
Label

Optional label override.

string
nullable
Icon

Optional icon override.

string
nullable
Color

Vuetify color token.

string
nullable
Variant

Vuetify variant token.

string
nullable
PermissionKey

Optional action-specific permission gate.

string
nullable
RowVersion

Concurrency token.

string format: uuid
AvailableFunctions
Array<object>
nullable

Administrative business function summary.

object
Id

Function identifier.

string
nullable
Key

Stable function key.

string
nullable
Name

User-facing function name.

string
nullable
Description

Optional description.

string
nullable
Kind
integer format: int32
Allowed values: 0 1
EntityDefinitionId

Owning entity definition for entity functions.

string
nullable
IsEnabled

Whether the function can be invoked by future runtime slices.

boolean
CurrentPublishedVersionId

Current published version identifier.

string
nullable
CurrentPublishedContract
integer format: int32
Allowed values: 0 1 2 3 5 6 7
CreatedAt

Creation timestamp.

string format: date-time
ModifiedAt

Last metadata modification timestamp.

string format: date-time
nullable
ModifiedByUserId

Last modifying user identifier.

string
nullable
VersionCount

Number of stored immutable versions.

integer format: int32
LatestVersionNumber

Latest stored version number.

integer format: int32
nullable
LatestVersionPublishedAt

Publication timestamp for the latest stored version.

string format: date-time
nullable
CurrentPublishedVersionNumber

Current published version number.

integer format: int32
nullable
CurrentPublishedVersionPublishedAt

Publication timestamp for the current published version.

string format: date-time
nullable
LastRunStatus
integer format: int32
Allowed values: 0 1 2 3 4 5 6 7 8
LastRunStartedAt

Most recent persisted run start timestamp.

string format: date-time
nullable
RowVersion

Concurrency token.

string format: uuid
SupportedSurfaces
Array<integer>
nullable
Allowed values: 0 1 2 3 4 5
SupportedTargetScopes
Array<integer>
nullable
Allowed values: 0 1 2 3
SupportedPlacements
Array<integer>
nullable
Allowed values: 0 1 2
SupportedToolbarPresentations
Array<integer>
nullable
Allowed values: 0 1
SupportedColors
Array<string>
nullable
SupportedVariants
Array<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": {
"Surface": 0,
"Actions": [
{
"Surface": 0,
"ActionTargetScope": 0,
"Placement": 0,
"ToolbarPresentation": 0
}
],
"AvailableFunctions": [
{
"Kind": 0,
"CurrentPublishedContract": 0,
"LastRunStatus": 0
}
],
"SupportedSurfaces": [
0
],
"SupportedTargetScopes": [
0
],
"SupportedPlacements": [
0
],
"SupportedToolbarPresentations": [
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"
}