Skip to content

Cancel a queued run or request cancellation for a running function.

POST
/api/workspace/admin/function-operations/jobs/{jobId}/cancel
curl --request POST \
--url https://example.com/api/workspace/admin/function-operations/jobs/example/cancel
  • None
jobId
required
string
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

Queued function run summary.

object
Id

Queued run identifier.

string
nullable
BusinessFunctionId

Queued function identifier.

string
nullable
BusinessFunctionVersionId

Captured function version identifier.

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

Queued function run summary.

object
Id

Queued run identifier.

string
nullable
BusinessFunctionId

Queued function identifier.

string
nullable
BusinessFunctionVersionId

Captured function version identifier.

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

Conflict

Media typeapplication/json
object
Data

Queued function run summary.

object
Id

Queued run identifier.

string
nullable
BusinessFunctionId

Queued function identifier.

string
nullable
BusinessFunctionVersionId

Captured function version identifier.

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