Skip to main content
Version: 11 - TBD

Execution

class resources.execution.Execution

Base class: Activity

An automation (flow, script, or connection) which is or was running.

See the corresponding Flow Api class at Execution

PropertyDescriptionTypeImport/Export
activity_typeEnum('EXECUTION', 'MESSAGE', 'PROCESS', name='activitytype')neither
breakA flag to control if the execution should pause on the next line.Boolean()neither
breakpointsThe breakpoints of the execution.ARRAY(SmallInteger())import only
bundle_idReference to the bundle this record is associated with. Allowed for BUNDLE_REPOSITORY, CONNECTOR, CUSTOM_OBJECT, DEVOLUTIONS_CONFIG, EXECUTION, FILE, FLOW, LDAP_CONFIG, MESSAGE, OAUTH, OBJECT_TEMPLATE, PLUGIN, ROLE, SCHEDULE, SCHEDULER, SCHEMA, SETTING, SYNC_CONFIG, TAG, VAULT_CONFIG, WEBHOOK, WRAPPER. Not allowed for BUNDLE, ORGANIZATION, PROCESS, PROJECT, USER, WORKSPACE. Mutually exclusive with project_idUUID(as_uuid=False)both
bundle_nameThe name of the bundle. Will look up the bundle and set bundle_id.String(length=128)neither
commit_messageThe commit message for this change.Text()import only
connector_idThe ID of the connector record the execution is using.UUID(as_uuid=False)both
connector_nameThe name of the connector. Only used for type CONNECTIONString(length=128)neither
connector_typeThe type of the connector / the type of the remote system.Enum('AWS', 'AZURE', 'AZUREAI', 'FTP', 'GIT', 'GOOGLE', 'IMAP', 'K8S', 'LDAP', 'MSTEAMS', 'MYSQL', 'OPENAI', 'PS', 'REDIS', 'REST', 'SCP', 'SFTP', 'SMB', 'SMTP', 'SOAP', 'SQLMSSQL', 'SQLORACLE', 'SQLPG', 'SSH', 'VAULT', 'WEBDAV', 'XMLRPC', name='connectortype')both
created_atDateTime(timezone=True)export only
created_byUUID(as_uuid=False)export only
custom_object_idIf this execution was created by the on_create, on_update, or on_delete hook of an object template, this field contains the reference to the custom object.UUID(as_uuid=False)both
deleted_atDateTime(timezone=True)export only
deleted_byUUID(as_uuid=False)export only
dependency_idThe ID of the dependency record the execution is currently waiting for.UUID(as_uuid=False)export only
descriptionA multiline description of what this record is and does.Text()both
end_statusEnum('WAITING_DEPENDENCY', 'WAITING_LOCK', 'WAITING_ENGINE', 'WAITING_RESPONSE', 'AT_ENGINE', 'ENDED_SUCCESS', 'ENDED_ERROR', 'ENDED_CANCELLED', 'PAUSED', 'SCHEDULED', 'LOST', name='executionstatus')neither
ended_atThe timestamp when the execution ended.DateTime(timezone=True)both
flow_idThe ID of the flow record the execution is processing.UUID(as_uuid=False)both
flow_nameThe name of the flow. Only used for type FLOWString(length=128)neither
has_deprecationBoolean()export only
has_syntax_errorBoolean()export only
idUUID(as_uuid=False)neither
identity_typeEnum('EXECUTION', 'LDAP_CONFIG', 'SCHEDULE', 'SYNC_CONFIG', 'USER', 'WEBHOOK', 'WORKSPACE', name='identitytype')neither
input_schemaThe schema of the data the execution accepts in input_value.JSONEncodedData()both
input_valueThe data which was passed to the execution.JSONEncodedData()both
is_bundle_readonlyBoolean()neither
is_deletedBoolean()export only
is_hiddenBoolean()neither
is_pausedA flag to control if the execution should be processed.Boolean()both
is_productiveA flag to control if the execution runs in productive mode.Boolean()both
is_project_readonlyBoolean()neither
is_queuedIf set, the execution is waiting to be processed.Boolean()neither
is_readonlyA flag to control if the record can be modified. Allowed for BUNDLE, BUNDLE_REPOSITORY, CONNECTOR, CUSTOM_OBJECT, DEVOLUTIONS_CONFIG, FILE, FLOW, OAUTH, OBJECT_TEMPLATE, PLUGIN, PROJECT, ROLE, SCHEDULE, SCHEDULER, SCHEMA, SETTING, SYNC_CONFIG, TAG, VAULT_CONFIG, WEBHOOK, WRAPPER. Not allowed for EXECUTION, LDAP_CONFIG, MESSAGE, ORGANIZATION, PROCESS, USER, WORKSPACEBoolean()both
is_remote_processedA flag to control if the execution is processed in a remote workspace.Boolean()both
last_activityThe last time the identity was active in Cloudomation. Output only.DateTime(timezone=True)neither
last_commandThe flow_api command which is currently executed.String(length=128)export only
last_syncTimestamp of when the execution was last synced with a workspace sync_config.DateTime(timezone=True)both
linenoThe line number of the script which is currently executed.SmallInteger()export only
location_inheritanceControls the project/bundle association of a newly created record when no project_id/project_name/bundle_id/bundle_name is specified in the create request. Depending on the record type different options are available:
location_inheritance record types description
created_by all use the same location as the identity which creates the record
default all use the "Default project" where applicable or "Workspace" for record types which cannot be in a project
wrapped_resource execution use the same location as the innermost resource which is wrapped
resource execution use the same location as the resource on which the execution is based on
Notes:
  • If a project_id/project_name/bundle_id/bundle_name is specified in the request, it always takes precedence.
  • The options wrapped_resource and resource only work with executions which are based on a resource, not with ad-hoc connections or executions of type "SCRIPT". If used with ad-hoc connections or "SCRIPT" it will fall back to default.
  • If the record being created cannot be associated with the specified location, the fallback to default will be used.
  • If location_inheritance is unset, the default value used depends on the type of identity which creates the record as well as the type of record which is created. If an execution is created by any identity which is not an execution, it defaults to wrapped_resource. In all other cases it defaults to created_by.
String(length=128)neither
messageA status message.Text()both
message_idThe ID of the message record the execution is currently awaiting a response from.UUID(as_uuid=False)export only
metadataAdditional data which can be stored in the execution.JSONEncodedData()both
modified_atDateTime(timezone=True)export only
modified_byUUID(as_uuid=False)export only
nameThe name of this record. Must be unique across a workspace.String(length=128)both
organization_idUUID(as_uuid=False)export only
orphanIf set, the child execution will be disconnected from the execution treeBoolean()neither
output_schemaThe schema of the data the execution produces in output_value.JSONEncodedData()both
output_valueThe data returned by the executionJSONEncodedData()both
parent_execution_idThe ID of the execution which created this execution.UUID(as_uuid=False)export only
plugin_action_idReference to the plugin_action this execution was started by.UUID(as_uuid=False)both
priorityThe priority of the execution. Higher priority executions will be processed first.SmallInteger()export only
process_idUUID(as_uuid=False)neither
project_idReference to the project this record is associated with. Allowed for CONNECTOR, CUSTOM_OBJECT, DEVOLUTIONS_CONFIG, EXECUTION, FILE, FLOW, MESSAGE, OAUTH, OBJECT_TEMPLATE, PLUGIN, SCHEDULE, SCHEDULER, SCHEMA, SETTING, SYNC_CONFIG, TAG, VAULT_CONFIG, WEBHOOK, WRAPPER. Not allowed for BUNDLE, BUNDLE_REPOSITORY, LDAP_CONFIG, ORGANIZATION, PROCESS, PROJECT, ROLE, USER, WORKSPACE. Mutually exclusive with bundle_id.UUID(as_uuid=False)both
project_nameThe name of the project. Will look up the project and set project_id.String(length=128)neither
provisioning_typeIf this execution was created by the on_create, on_update, or on_delete hook of an object template.String(length=128)export only
record_typeEnum('BUNDLE', 'BUNDLE_REPOSITORY', 'CONNECTOR', 'CUSTOM_OBJECT', 'DEVOLUTIONS_CONFIG', 'EXECUTION', 'FILE', 'FLOW', 'LDAP_CONFIG', 'MESSAGE', 'OAUTH', 'OBJECT_TEMPLATE', 'ORGANIZATION', 'PLUGIN', 'PROCESS', 'PROJECT', 'ROLE', 'SCHEDULE', 'SCHEDULER', 'SCHEMA', 'SETTING', 'SYNC_CONFIG', 'TAG', 'USER', 'VAULT_CONFIG', 'WEBHOOK', 'WORKSPACE', 'WRAPPER', name='recordtype')neither
remote_workspace_nameThe name of the workspace where this execution is remotely runningString(length=128)neither
repository_pathThe path to the storing repository, relative to GIT_REPOSITORY_SAVE_PATHString(length=256)neither
rolesThe roles this identity has.JSONEncodedData()import only
savepoint_retentionControls which savepoints are retained during execution (e.g. LAST, ALL)Enum('ALL', 'LAST', name='savepointretention')both
schedule_idThe associated schedule for this executionUUID(as_uuid=False)both
schedule_nameThe name of the schedule. Only used for type SCHEDULEString(length=128)neither
scheduled_forThe timestamp when the execution will continue. This field is also used for timeouts.DateTime(timezone=True)both
schema_versionString(length=128)both
scriptThe script the execution is processing.Text()both
setting_idThe ID of the setting record the execution is currently trying to acquire a lock from.UUID(as_uuid=False)export only
started_atThe timestamp when the execution started.DateTime(timezone=True)both
statusThe status of the execution. Output only.Enum('WAITING_DEPENDENCY', 'WAITING_LOCK', 'WAITING_ENGINE', 'WAITING_RESPONSE', 'AT_ENGINE', 'ENDED_SUCCESS', 'ENDED_ERROR', 'ENDED_CANCELLED', 'PAUSED', 'SCHEDULED', 'LOST', name='executionstatus')both
status_labelString(length=128)neither
sync_config_idThe ID of the workspace sync_config the execution is associated with.UUID(as_uuid=False)both
top_execution_idThe ID of the top-most execution which created this execution.UUID(as_uuid=False)export only
typeThe type of the execution.Enum('FLOW', 'SCRIPT', 'CONNECTION', 'SCHEDULE', 'WRAPPER', name='executiontype')both
unwrappedIf set, static wrappers which are registered on the flow are not used. Dynamically added wrappers and wrappers which are explicitly added using the wrappers field are still used.Boolean()neither
use_breakpointsA flag to control if the execution will stop at breakpoints.Boolean()both
use_only_explicit_breakpointsShould only explicitly defined breakpoints be used, this disables the step-through feature.Boolean()both
webhook_idThe associated webhook for this executionUUID(as_uuid=False)both
workspace_idUUID(as_uuid=False)export only
wrapper_idThe ID of the wrapper record the execution is processing.UUID(as_uuid=False)both
wrapper_nameThe name of the wrapper. Only used for type WRAPPERString(length=128)neither
wrappersA list of dynamic wrappers to apply around the execution. Provide a list of objects in the form [{"wrapper_id": ..., "params": {...}}].JSONEncodedData()neither