Skip to content

Validate and enqueue an admin-launched Global action function.

POST
/api/workspace/admin/function-catalog/{functionId}/global-action/enqueue
curl --request POST \
--url https://example.com/api/workspace/admin/function-catalog/example/global-action/enqueue \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{ "FunctionId": "example", "Input": "example", "CorrelationId": "example" }'
functionId
required
string
access_token
string

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

Request payload to validate and enqueue an admin-launched Global action function.

object
FunctionId

Business function identifier.

string
nullable
Input

Action input object keyed by CLR property name.

nullable
CorrelationId

Optional correlation identifier.

string
nullable
Examplegenerated
{
"FunctionId": "example",
"Input": "example",
"CorrelationId": "example"
}

OK

Media typeapplication/json
object
Data

Backend-only queued action invocation result.

object
JobId

Queued function run identifier.

string
nullable
Job

Queued function run summary.

object
Id

Queued run identifier.

string
nullable
BusinessFunctionId

Queued function identifier.

string
nullable
BusinessFunctionVersionId

Captured function version identifier.

string
nullable
RuntimeKind
integer format: int32
Allowed values: 0 1 2
VersionResolutionMode
integer format: int32
Allowed values: 0 1
Status
integer format: int32
Allowed values: 0 1 2 3 4
Source

Execution source.

string
nullable
DeduplicationKey

Optional deduplication key.

string
nullable
Priority

Queue priority; lower numbers run first.

integer format: int32
AttemptCount

Execution attempt count.

integer format: int32
CreatedAt

Timestamp when the run was queued.

string format: date-time
NextRunAt

Next eligible run timestamp.

string format: date-time
ActorUserId

Original actor user identifier, when any.

string
nullable
OriginalUserId

Source user identifier when the worker runs under a different actor.

string
nullable
CorrelationId

Correlation identifier.

string
nullable
EntityDefinitionId

Related entity definition identifier.

string
nullable
EntityInstanceId

Related entity instance identifier.

string
nullable
EntityOperation

Related entity operation.

string
nullable
TriggerBindingId

Trigger binding identifier, when this run came from a trigger.

string
nullable
ScheduleId

Schedule identifier, when this run came from a schedule.

string
nullable
ActionId

Action binding identifier, when this run came from an action.

string
nullable
ActionTargetScope
integer format: int32
Allowed values: 0 1 2 3
ActionInputSnapshot

Action input JSON snapshot.

string
nullable
ActionSelectedEntityIdsSnapshot

Selected entity ids JSON snapshot for selection actions.

string
nullable
LastError

Last execution error summary.

string
nullable
CancellationRequestedAt

Timestamp when cancellation was requested.

string format: date-time
nullable
CancellationRequestedByUserId

User that requested cancellation.

string
nullable
CancellationObservedAt

Timestamp when cancellation was observed by the worker.

string format: date-time
nullable
CanCancel

Whether the queued run can be cancelled manually.

boolean
CancellationKind
integer format: int32
Allowed values: 0 1 2
TimeoutSeconds

Optional source-owned timeout captured for schedule or API-enqueue runs.

integer format: int32
nullable
LastFailureReasonCode

Stable machine-readable reason code for the latest failed attempt.

string
nullable
InvocationOwnerKey

Read-only product invocation owner key.

string
nullable
InvocationOwnerId

Read-only owning configuration identity.

string
nullable
InvocationOperationId

Durable module operation correlated with this invocation.

string
nullable
SourceNetOperationProjectRevisionId

Net Operation Project source revision captured for this job.

string
nullable
SourceNetOperationProjectBuildId

Net Operation Project build captured for this job.

string
nullable
SourceNetOperationProjectArtifactId

Net Operation Project artifact captured for this job.

string
nullable
EffectiveMaxAttempts

Maximum attempts captured when this job was enqueued.

integer format: int32
nullable
RetryDelaySeconds

Retry delay captured when this job was enqueued.

integer format: int32
nullable
RemainingAttempts

Attempts still available after the current attempt.

integer format: int32
WillRetry

Whether the persisted policy permits a later attempt.

boolean
CanStopRetries

Whether the administrator can stop this retry chain.

boolean
RetryStopState
integer format: int32
Allowed values: 0 1 2
CancellationReasonCode

Stable reason for the accepted retry stop.

string
nullable
CurrentAttempt

Current one-based execution attempt; zero means the initial attempt has not started.

integer format: int32
Validation

Backend-only action invocation validation result.

object
ActionId

Designer-owned action identifier, or null for admin-launched Global actions.

string
nullable
BusinessFunctionId

Business function identifier resolved from the binding.

string
nullable
BusinessFunctionVersionId

Published function version pinned for enqueue/execution.

string
nullable
ActionTargetScope
integer format: int32
Allowed values: 0 1 2 3
EntityDefinitionId

Resolved entity definition identifier, when applicable.

string
nullable
EntityInstanceId

Resolved entity instance identifier, when applicable.

string
nullable
SelectedEntityInstanceIds

Normalized selected entity instance ids.

Array<string>
nullable
InputSnapshot

Normalized action input JSON snapshot.

string
nullable
ValidationErrors

Validation errors returned by platform or package validation.

Array<object>
nullable

Structured validation error emitted during business-function execution or persistence.

object
FieldKey

Optional entity field key targeted by the error.

string
nullable
Message

User-facing validation message.

string
nullable
Code

Optional stable validation code.

string
nullable
IsValid
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": {
"Job": {
"RuntimeKind": 0,
"VersionResolutionMode": 0,
"Status": 0,
"ActionTargetScope": 0,
"CancellationKind": 0,
"RetryStopState": 0
},
"Validation": {
"ActionTargetScope": 0
}
},
"Errors": [
{
"Type": 0,
"Severity": 0
}
],
"Warnings": [
{
"Type": 0,
"Severity": 0
}
]
}

Bad Request

Media typeapplication/json
object
Data

Backend-only queued action invocation result.

object
JobId

Queued function run identifier.

string
nullable
Job

Queued function run summary.

object
Id

Queued run identifier.

string
nullable
BusinessFunctionId

Queued function identifier.

string
nullable
BusinessFunctionVersionId

Captured function version identifier.

string
nullable
RuntimeKind
integer format: int32
Allowed values: 0 1 2
VersionResolutionMode
integer format: int32
Allowed values: 0 1
Status
integer format: int32
Allowed values: 0 1 2 3 4
Source

Execution source.

string
nullable
DeduplicationKey

Optional deduplication key.

string
nullable
Priority

Queue priority; lower numbers run first.

integer format: int32
AttemptCount

Execution attempt count.

integer format: int32
CreatedAt

Timestamp when the run was queued.

string format: date-time
NextRunAt

Next eligible run timestamp.

string format: date-time
ActorUserId

Original actor user identifier, when any.

string
nullable
OriginalUserId

Source user identifier when the worker runs under a different actor.

string
nullable
CorrelationId

Correlation identifier.

string
nullable
EntityDefinitionId

Related entity definition identifier.

string
nullable
EntityInstanceId

Related entity instance identifier.

string
nullable
EntityOperation

Related entity operation.

string
nullable
TriggerBindingId

Trigger binding identifier, when this run came from a trigger.

string
nullable
ScheduleId

Schedule identifier, when this run came from a schedule.

string
nullable
ActionId

Action binding identifier, when this run came from an action.

string
nullable
ActionTargetScope
integer format: int32
Allowed values: 0 1 2 3
ActionInputSnapshot

Action input JSON snapshot.

string
nullable
ActionSelectedEntityIdsSnapshot

Selected entity ids JSON snapshot for selection actions.

string
nullable
LastError

Last execution error summary.

string
nullable
CancellationRequestedAt

Timestamp when cancellation was requested.

string format: date-time
nullable
CancellationRequestedByUserId

User that requested cancellation.

string
nullable
CancellationObservedAt

Timestamp when cancellation was observed by the worker.

string format: date-time
nullable
CanCancel

Whether the queued run can be cancelled manually.

boolean
CancellationKind
integer format: int32
Allowed values: 0 1 2
TimeoutSeconds

Optional source-owned timeout captured for schedule or API-enqueue runs.

integer format: int32
nullable
LastFailureReasonCode

Stable machine-readable reason code for the latest failed attempt.

string
nullable
InvocationOwnerKey

Read-only product invocation owner key.

string
nullable
InvocationOwnerId

Read-only owning configuration identity.

string
nullable
InvocationOperationId

Durable module operation correlated with this invocation.

string
nullable
SourceNetOperationProjectRevisionId

Net Operation Project source revision captured for this job.

string
nullable
SourceNetOperationProjectBuildId

Net Operation Project build captured for this job.

string
nullable
SourceNetOperationProjectArtifactId

Net Operation Project artifact captured for this job.

string
nullable
EffectiveMaxAttempts

Maximum attempts captured when this job was enqueued.

integer format: int32
nullable
RetryDelaySeconds

Retry delay captured when this job was enqueued.

integer format: int32
nullable
RemainingAttempts

Attempts still available after the current attempt.

integer format: int32
WillRetry

Whether the persisted policy permits a later attempt.

boolean
CanStopRetries

Whether the administrator can stop this retry chain.

boolean
RetryStopState
integer format: int32
Allowed values: 0 1 2
CancellationReasonCode

Stable reason for the accepted retry stop.

string
nullable
CurrentAttempt

Current one-based execution attempt; zero means the initial attempt has not started.

integer format: int32
Validation

Backend-only action invocation validation result.

object
ActionId

Designer-owned action identifier, or null for admin-launched Global actions.

string
nullable
BusinessFunctionId

Business function identifier resolved from the binding.

string
nullable
BusinessFunctionVersionId

Published function version pinned for enqueue/execution.

string
nullable
ActionTargetScope
integer format: int32
Allowed values: 0 1 2 3
EntityDefinitionId

Resolved entity definition identifier, when applicable.

string
nullable
EntityInstanceId

Resolved entity instance identifier, when applicable.

string
nullable
SelectedEntityInstanceIds

Normalized selected entity instance ids.

Array<string>
nullable
InputSnapshot

Normalized action input JSON snapshot.

string
nullable
ValidationErrors

Validation errors returned by platform or package validation.

Array<object>
nullable

Structured validation error emitted during business-function execution or persistence.

object
FieldKey

Optional entity field key targeted by the error.

string
nullable
Message

User-facing validation message.

string
nullable
Code

Optional stable validation code.

string
nullable
IsValid
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": {
"Job": {
"RuntimeKind": 0,
"VersionResolutionMode": 0,
"Status": 0,
"ActionTargetScope": 0,
"CancellationKind": 0,
"RetryStopState": 0
},
"Validation": {
"ActionTargetScope": 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

Backend-only queued action invocation result.

object
JobId

Queued function run identifier.

string
nullable
Job

Queued function run summary.

object
Id

Queued run identifier.

string
nullable
BusinessFunctionId

Queued function identifier.

string
nullable
BusinessFunctionVersionId

Captured function version identifier.

string
nullable
RuntimeKind
integer format: int32
Allowed values: 0 1 2
VersionResolutionMode
integer format: int32
Allowed values: 0 1
Status
integer format: int32
Allowed values: 0 1 2 3 4
Source

Execution source.

string
nullable
DeduplicationKey

Optional deduplication key.

string
nullable
Priority

Queue priority; lower numbers run first.

integer format: int32
AttemptCount

Execution attempt count.

integer format: int32
CreatedAt

Timestamp when the run was queued.

string format: date-time
NextRunAt

Next eligible run timestamp.

string format: date-time
ActorUserId

Original actor user identifier, when any.

string
nullable
OriginalUserId

Source user identifier when the worker runs under a different actor.

string
nullable
CorrelationId

Correlation identifier.

string
nullable
EntityDefinitionId

Related entity definition identifier.

string
nullable
EntityInstanceId

Related entity instance identifier.

string
nullable
EntityOperation

Related entity operation.

string
nullable
TriggerBindingId

Trigger binding identifier, when this run came from a trigger.

string
nullable
ScheduleId

Schedule identifier, when this run came from a schedule.

string
nullable
ActionId

Action binding identifier, when this run came from an action.

string
nullable
ActionTargetScope
integer format: int32
Allowed values: 0 1 2 3
ActionInputSnapshot

Action input JSON snapshot.

string
nullable
ActionSelectedEntityIdsSnapshot

Selected entity ids JSON snapshot for selection actions.

string
nullable
LastError

Last execution error summary.

string
nullable
CancellationRequestedAt

Timestamp when cancellation was requested.

string format: date-time
nullable
CancellationRequestedByUserId

User that requested cancellation.

string
nullable
CancellationObservedAt

Timestamp when cancellation was observed by the worker.

string format: date-time
nullable
CanCancel

Whether the queued run can be cancelled manually.

boolean
CancellationKind
integer format: int32
Allowed values: 0 1 2
TimeoutSeconds

Optional source-owned timeout captured for schedule or API-enqueue runs.

integer format: int32
nullable
LastFailureReasonCode

Stable machine-readable reason code for the latest failed attempt.

string
nullable
InvocationOwnerKey

Read-only product invocation owner key.

string
nullable
InvocationOwnerId

Read-only owning configuration identity.

string
nullable
InvocationOperationId

Durable module operation correlated with this invocation.

string
nullable
SourceNetOperationProjectRevisionId

Net Operation Project source revision captured for this job.

string
nullable
SourceNetOperationProjectBuildId

Net Operation Project build captured for this job.

string
nullable
SourceNetOperationProjectArtifactId

Net Operation Project artifact captured for this job.

string
nullable
EffectiveMaxAttempts

Maximum attempts captured when this job was enqueued.

integer format: int32
nullable
RetryDelaySeconds

Retry delay captured when this job was enqueued.

integer format: int32
nullable
RemainingAttempts

Attempts still available after the current attempt.

integer format: int32
WillRetry

Whether the persisted policy permits a later attempt.

boolean
CanStopRetries

Whether the administrator can stop this retry chain.

boolean
RetryStopState
integer format: int32
Allowed values: 0 1 2
CancellationReasonCode

Stable reason for the accepted retry stop.

string
nullable
CurrentAttempt

Current one-based execution attempt; zero means the initial attempt has not started.

integer format: int32
Validation

Backend-only action invocation validation result.

object
ActionId

Designer-owned action identifier, or null for admin-launched Global actions.

string
nullable
BusinessFunctionId

Business function identifier resolved from the binding.

string
nullable
BusinessFunctionVersionId

Published function version pinned for enqueue/execution.

string
nullable
ActionTargetScope
integer format: int32
Allowed values: 0 1 2 3
EntityDefinitionId

Resolved entity definition identifier, when applicable.

string
nullable
EntityInstanceId

Resolved entity instance identifier, when applicable.

string
nullable
SelectedEntityInstanceIds

Normalized selected entity instance ids.

Array<string>
nullable
InputSnapshot

Normalized action input JSON snapshot.

string
nullable
ValidationErrors

Validation errors returned by platform or package validation.

Array<object>
nullable

Structured validation error emitted during business-function execution or persistence.

object
FieldKey

Optional entity field key targeted by the error.

string
nullable
Message

User-facing validation message.

string
nullable
Code

Optional stable validation code.

string
nullable
IsValid
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": {
"Job": {
"RuntimeKind": 0,
"VersionResolutionMode": 0,
"Status": 0,
"ActionTargetScope": 0,
"CancellationKind": 0,
"RetryStopState": 0
},
"Validation": {
"ActionTargetScope": 0
}
},
"Errors": [
{
"Type": 0,
"Severity": 0
}
],
"Warnings": [
{
"Type": 0,
"Severity": 0
}
]
}