Skip to content

Run a published business function with supplied test context.

POST
/api/workspace/admin/function-catalog/{functionId}/test-invocations
curl --request POST \
--url https://example.com/api/workspace/admin/function-catalog/example/test-invocations \
--header 'Content-Type: application/json' \
--data '{ "Args": {}, "CorrelationId": "example", "EntityDefinitionId": "example", "EntityInstanceId": "example", "EntityOperation": "example", "Record": {}, "PreviousRecord": {} }'
  • None
functionId
required
string
access_token
string

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

Admin test invocation request for a published business function.

object
Args

Optional JSON arguments exposed as ctx.args.

object
CorrelationId

Optional correlation identifier.

string
nullable
EntityDefinitionId

Optional related entity definition identifier for entity-scoped execution.

string
nullable
EntityInstanceId

Optional related entity instance identifier for entity-scoped execution.

string
nullable
EntityOperation

Optional related entity operation label for entity-scoped execution.

string
nullable
Record

Optional draft/current entity record exposed to dynamic functions and package entity bridges.

object
PreviousRecord

Optional previous entity record exposed to dynamic functions and package entity bridges.

object
Examplegenerated
{
"Args": {},
"CorrelationId": "example",
"EntityDefinitionId": "example",
"EntityInstanceId": "example",
"EntityOperation": "example",
"Record": {},
"PreviousRecord": {}
}

OK

Media typeapplication/json
object
Data

Business function execution result.

object
RunId

Persisted run identifier.

string
nullable
BusinessFunctionId

Function identifier.

string
nullable
BusinessFunctionVersionId

Executed function version identifier.

string
nullable
Source

Execution source.

string
nullable
ActorUserId

Actor user identifier.

string
nullable
CorrelationId

Correlation identifier.

string
nullable
Status
integer format: int32
Allowed values: 0 1 2 3 4 5 6 7 8
StartedAt

Execution start timestamp.

string format: date-time
CompletedAt

Execution completion timestamp.

string format: date-time
nullable
DurationMs

Execution duration in milliseconds.

integer format: int64
nullable
ResultSummary

Bounded result summary.

string
nullable
ResultData

Structured JSON result payload.

object
ErrorSummary

Bounded error summary.

string
nullable
LogSummary

Bounded diagnostic log summary.

string
nullable
ValidationErrors

Structured validation errors produced by a Validation contract.

Array<object>
nullable

Structured validation error emitted by a Validation business function.

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
MutationOutput

Output produced by a BeforeSaveMutation function.

object
Record

Mutated save draft exposed as ctx.record.

object
FailureReasonCode

Stable machine-readable reason code for a platform or runtime failure.

string
nullable
SourceNetOperationProjectRevisionId

Net Operation Project source revision captured for this execution.

string
nullable
SourceNetOperationProjectBuildId

Net Operation Project build captured for this execution.

string
nullable
SourceNetOperationProjectArtifactId

Net Operation Project artifact captured by the published function version.

string
nullable
ResolvedNetOperationProjectArtifactId

Net Operation Project artifact selected before runtime activation.

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": {
"Status": 0
},
"Errors": [
{
"Type": 0,
"Severity": 0
}
],
"Warnings": [
{
"Type": 0,
"Severity": 0
}
]
}

Bad Request

Media typeapplication/json
object
Data

Business function execution result.

object
RunId

Persisted run identifier.

string
nullable
BusinessFunctionId

Function identifier.

string
nullable
BusinessFunctionVersionId

Executed function version identifier.

string
nullable
Source

Execution source.

string
nullable
ActorUserId

Actor user identifier.

string
nullable
CorrelationId

Correlation identifier.

string
nullable
Status
integer format: int32
Allowed values: 0 1 2 3 4 5 6 7 8
StartedAt

Execution start timestamp.

string format: date-time
CompletedAt

Execution completion timestamp.

string format: date-time
nullable
DurationMs

Execution duration in milliseconds.

integer format: int64
nullable
ResultSummary

Bounded result summary.

string
nullable
ResultData

Structured JSON result payload.

object
ErrorSummary

Bounded error summary.

string
nullable
LogSummary

Bounded diagnostic log summary.

string
nullable
ValidationErrors

Structured validation errors produced by a Validation contract.

Array<object>
nullable

Structured validation error emitted by a Validation business function.

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
MutationOutput

Output produced by a BeforeSaveMutation function.

object
Record

Mutated save draft exposed as ctx.record.

object
FailureReasonCode

Stable machine-readable reason code for a platform or runtime failure.

string
nullable
SourceNetOperationProjectRevisionId

Net Operation Project source revision captured for this execution.

string
nullable
SourceNetOperationProjectBuildId

Net Operation Project build captured for this execution.

string
nullable
SourceNetOperationProjectArtifactId

Net Operation Project artifact captured by the published function version.

string
nullable
ResolvedNetOperationProjectArtifactId

Net Operation Project artifact selected before runtime activation.

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": {
"Status": 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

Business function execution result.

object
RunId

Persisted run identifier.

string
nullable
BusinessFunctionId

Function identifier.

string
nullable
BusinessFunctionVersionId

Executed function version identifier.

string
nullable
Source

Execution source.

string
nullable
ActorUserId

Actor user identifier.

string
nullable
CorrelationId

Correlation identifier.

string
nullable
Status
integer format: int32
Allowed values: 0 1 2 3 4 5 6 7 8
StartedAt

Execution start timestamp.

string format: date-time
CompletedAt

Execution completion timestamp.

string format: date-time
nullable
DurationMs

Execution duration in milliseconds.

integer format: int64
nullable
ResultSummary

Bounded result summary.

string
nullable
ResultData

Structured JSON result payload.

object
ErrorSummary

Bounded error summary.

string
nullable
LogSummary

Bounded diagnostic log summary.

string
nullable
ValidationErrors

Structured validation errors produced by a Validation contract.

Array<object>
nullable

Structured validation error emitted by a Validation business function.

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
MutationOutput

Output produced by a BeforeSaveMutation function.

object
Record

Mutated save draft exposed as ctx.record.

object
FailureReasonCode

Stable machine-readable reason code for a platform or runtime failure.

string
nullable
SourceNetOperationProjectRevisionId

Net Operation Project source revision captured for this execution.

string
nullable
SourceNetOperationProjectBuildId

Net Operation Project build captured for this execution.

string
nullable
SourceNetOperationProjectArtifactId

Net Operation Project artifact captured by the published function version.

string
nullable
ResolvedNetOperationProjectArtifactId

Net Operation Project artifact selected before runtime activation.

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": {
"Status": 0
},
"Errors": [
{
"Type": 0,
"Severity": 0
}
],
"Warnings": [
{
"Type": 0,
"Severity": 0
}
]
}