Skip to main content
POST
Create Execution

Authorizations

x-api-key
string
header
required

API key for authentication. Create one from the Kodexa platform UI under Settings > Access Tokens.

Body

application/json

An execution records the details and results of a processing session.

assistantId
string | null
context
object | null
description
string
documentFamilyId
string | null
documentFamilyPath
string
endDate
string<date-time> | null
exceptionDetails
object | null
idempotencyKey
string | null
organizationId
string
parentExecutionId
string | null
pipeline
object | null
priority
integer<int32>
processingTime
integer<int64>
sessionId
string | null
startDate
string<date-time> | null
status
enum<string>
Available options:
PENDING,
RUNNING,
SUCCEEDED,
FAILED,
REQUESTED,
SKIPPED,
CANCELLING,
CANCELLED,
PENDING_REPROCESSING,
REPROCESSED
statusDetails
object | null
targets
object | null

Response

Created Execution

An execution records the details and results of a processing session.

changeSequence
integer<int32>
required

Optimistic locking version number.

createdOn
string<date-time>
required

Timestamp when the execution was created.

id
string
required

Unique identifier (UUID) for the execution.

priority
integer<int32>
required
processingTime
integer<int64>
required
status
enum<string>
required
Available options:
PENDING,
RUNNING,
SUCCEEDED,
FAILED,
REQUESTED,
SKIPPED,
CANCELLING,
CANCELLED,
PENDING_REPROCESSING,
REPROCESSED
updatedOn
string<date-time>
required

Timestamp when the execution was last updated.

uuid
string
required

Secondary UUID identifier.

assistantId
string | null
context
object | null
description
string
documentFamilyId
string | null
documentFamilyPath
string
endDate
string<date-time> | null
exceptionDetails
object | null
idempotencyKey
string | null
organizationId
string
parentExecutionId
string | null
pipeline
object | null
sessionId
string | null
startDate
string<date-time> | null
statusDetails
object | null
targets
object | null