---
sidebar:
  label: roboto.domain.actions
  order: 0
title: roboto.domain.actions
---
Actions domain module for the Roboto SDK.

This module provides the core domain entities and operations for working with Actions, Invocations, and Triggers in the Roboto platform. Actions are reusable functions that process, transform, or analyze data. Invocations represent executions of actions, and Triggers automatically invoke actions when specific events or conditions occur.

The main classes in this module are:

- [`Action`](/docs/reference/python-sdk/roboto/domain/actions#roboto.domain.actions.Action): A reusable function to process data
- [`Invocation`](/docs/reference/python-sdk/roboto/domain/actions#roboto.domain.actions.Invocation): An execution instance of an action
- [`Trigger`](/docs/reference/python-sdk/roboto/domain/actions#roboto.domain.actions.Trigger) and [`ScheduledTrigger`](/docs/reference/python-sdk/roboto/domain/actions#roboto.domain.actions.ScheduledTrigger): the legacy trigger model, deprecated. Triggers now live in [`roboto.domain.triggers`](/docs/reference/python-sdk/roboto/domain/triggers); the classes here remain only so existing code keeps working, and read only the triggers the old model can express.

**Usage**

Basic action invocation:

```python
from roboto.domain.actions import Action, InvocationSource
action = Action.from_name("my_action", owner_org_id="my-org")
invocation = action.invoke(invocation_source=InvocationSource.Manual, parameter_values={"param1": "value1"})
invocation.wait_for_terminal_status()
```

Creating a trigger:

```python
from roboto.domain.actions import Trigger, TriggerForEachPrimitive
trigger = Trigger.create(
    name="auto_process",
    action_name="my_action",
    required_inputs=["**/*.bag"],
    for_each=TriggerForEachPrimitive.Dataset,
)
```

## Submodules

- [roboto.domain.actions.action](/docs/reference/python-sdk/roboto/domain/actions/action)
- [roboto.domain.actions.action_config](/docs/reference/python-sdk/roboto/domain/actions/action_config)
- [roboto.domain.actions.action_operations](/docs/reference/python-sdk/roboto/domain/actions/action_operations)
- [roboto.domain.actions.action_record](/docs/reference/python-sdk/roboto/domain/actions/action_record)
- [roboto.domain.actions.invocation](/docs/reference/python-sdk/roboto/domain/actions/invocation)
- [roboto.domain.actions.invocation_operations](/docs/reference/python-sdk/roboto/domain/actions/invocation_operations)
- [roboto.domain.actions.invocation_record](/docs/reference/python-sdk/roboto/domain/actions/invocation_record)
- [roboto.domain.actions.scheduled_trigger](/docs/reference/python-sdk/roboto/domain/actions/scheduled_trigger)
- [roboto.domain.actions.scheduled_trigger_operations](/docs/reference/python-sdk/roboto/domain/actions/scheduled_trigger_operations)
- [roboto.domain.actions.scheduled_trigger_record](/docs/reference/python-sdk/roboto/domain/actions/scheduled_trigger_record)
- [roboto.domain.actions.stats](/docs/reference/python-sdk/roboto/domain/actions/stats)
- [roboto.domain.actions.trigger](/docs/reference/python-sdk/roboto/domain/actions/trigger)
- [roboto.domain.actions.trigger_operations](/docs/reference/python-sdk/roboto/domain/actions/trigger_operations)
- [roboto.domain.actions.trigger_record](/docs/reference/python-sdk/roboto/domain/actions/trigger_record)
- [roboto.domain.actions.trigger_view](/docs/reference/python-sdk/roboto/domain/actions/trigger_view)

## Package Contents

- [Accessibility](/reference/python-sdk/roboto/domain/actions/action_record#roboto.domain.actions.action_record.Accessibility) (class): Controls who can query for and invoke an action.

- [Action](/reference/python-sdk/roboto/domain/actions/action#roboto.domain.actions.action.Action) (class): A reusable function to process, transform or analyze data in Roboto.

- [ActionConfig](/reference/python-sdk/roboto/domain/actions/action_config#roboto.domain.actions.action_config.ActionConfig) (class): User-facing model for Action configuration used when creating or updating Actions.

- [ActionParameter](/reference/python-sdk/roboto/domain/actions/action_record#roboto.domain.actions.action_record.ActionParameter) (class): A parameter that can be provided to an Action at invocation time.

- [ActionParameterChangeset](/reference/python-sdk/roboto/domain/actions/action_record#roboto.domain.actions.action_record.ActionParameterChangeset) (class): A changeset used to modify Action parameters.

- [ActionProvenance](/reference/python-sdk/roboto/domain/actions/invocation_record#roboto.domain.actions.invocation_record.ActionProvenance) (class): Provenance information for an action

- [ActionRecord](/reference/python-sdk/roboto/domain/actions/action_record#roboto.domain.actions.action_record.ActionRecord) (class): A wire-transmissible representation of an action.

- [ActionReference](/reference/python-sdk/roboto/domain/actions/action_record#roboto.domain.actions.action_record.ActionReference) (class): Qualified action reference.

- [ActionStatsRecord](/reference/python-sdk/roboto/domain/actions/stats#roboto.domain.actions.stats.ActionStatsRecord) (class): Statistical summary of action invocations for a specific action within a time period.

- [CancelActiveInvocationsRequest](/reference/python-sdk/roboto/domain/actions/invocation_operations#roboto.domain.actions.invocation_operations.CancelActiveInvocationsRequest) (class): Request payload to bulk cancel all active invocations within an organization.

- [CancelActiveInvocationsResponse](/reference/python-sdk/roboto/domain/actions/invocation_operations#roboto.domain.actions.invocation_operations.CancelActiveInvocationsResponse) (class): Response payload from bulk cancellation of active invocations.

- [ComputeRequirements](/reference/python-sdk/roboto/domain/actions/action_record#roboto.domain.actions.action_record.ComputeRequirements) (class): Compute requirements for an action invocation.

- [ContainerParameters](/reference/python-sdk/roboto/domain/actions/action_record#roboto.domain.actions.action_record.ContainerParameters) (class): Container parameters for an action invocation.

- [CreateActionRequest](/reference/python-sdk/roboto/domain/actions/action_operations#roboto.domain.actions.action_operations.CreateActionRequest) (class): Request payload to create a new action.

- [CreateInvocationRequest](/reference/python-sdk/roboto/domain/actions/invocation_operations#roboto.domain.actions.invocation_operations.CreateInvocationRequest) (class): Request payload to create a new action invocation.

- [CreateScheduledTriggerRequest](/reference/python-sdk/roboto/domain/actions/scheduled_trigger_operations#roboto.domain.actions.scheduled_trigger_operations.CreateScheduledTriggerRequest) (class): Request payload to create a scheduled trigger.

- [CreateTriggerRequest](/reference/python-sdk/roboto/domain/actions/trigger_operations#roboto.domain.actions.trigger_operations.CreateTriggerRequest) (class): Request payload to create a new trigger.

- [DataSelector](/reference/python-sdk/roboto/domain/actions/invocation_record#roboto.domain.actions.invocation_record.DataSelector) (class): Selector for inputs (e.g. files) to an action invocation.

- [EvaluateTriggersRequest](/reference/python-sdk/roboto/domain/actions/trigger_operations#roboto.domain.actions.trigger_operations.EvaluateTriggersRequest) (class): Request payload to manually evaluate specific triggers.

- [ExecutableProvenance](/reference/python-sdk/roboto/domain/actions/invocation_record#roboto.domain.actions.invocation_record.ExecutableProvenance) (class): Provenance information for an action executable

- [ExecutorContainer](/reference/python-sdk/roboto/domain/actions/action_record#roboto.domain.actions.action_record.ExecutorContainer) (class): Type of container running as part of an action invocation

- [FileSelector](/reference/python-sdk/roboto/domain/actions/invocation_record#roboto.domain.actions.invocation_record.FileSelector) (class): Selector for file inputs to an action invocation.

- [Invocation](/reference/python-sdk/roboto/domain/actions/invocation#roboto.domain.actions.invocation.Invocation) (class): An instance of an execution of an action, initiated manually by a user or automatically by a trigger.

- [InvocationDataSource](/reference/python-sdk/roboto/domain/actions/invocation_record#roboto.domain.actions.invocation_record.InvocationDataSource) (class): Abstracted data source that can be provided to an invocation.

- [InvocationDataSourceType](/reference/python-sdk/roboto/domain/actions/invocation_record#roboto.domain.actions.invocation_record.InvocationDataSourceType) (class): Source of data for an action's input binding.

- [InvocationInput](/reference/python-sdk/roboto/domain/actions/invocation_record#roboto.domain.actions.invocation_record.InvocationInput) (class): Input specification for an action invocation.

- [InvocationProvenance](/reference/python-sdk/roboto/domain/actions/invocation_record#roboto.domain.actions.invocation_record.InvocationProvenance) (class): Provenance information for an invocation

- [InvocationRecord](/reference/python-sdk/roboto/domain/actions/invocation_record#roboto.domain.actions.invocation_record.InvocationRecord) (class): A wire-transmissible representation of an invocation.

- [InvocationSource](/reference/python-sdk/roboto/domain/actions/invocation_record#roboto.domain.actions.invocation_record.InvocationSource) (class): Method by which an invocation was run

- [InvocationStatus](/reference/python-sdk/roboto/domain/actions/invocation_record#roboto.domain.actions.invocation_record.InvocationStatus) (class): Invocation status enum

- [InvocationStatusRecord](/reference/python-sdk/roboto/domain/actions/invocation_record#roboto.domain.actions.invocation_record.InvocationStatusRecord) (class): A wire-transmissible representation of an invocation status.

- [InvocationUploadDestination](/reference/python-sdk/roboto/domain/actions/invocation_record#roboto.domain.actions.invocation_record.InvocationUploadDestination) (class): Default destination to which invocation outputs - if any - should be uploaded.

- [LogRecord](/reference/python-sdk/roboto/domain/actions/invocation_record#roboto.domain.actions.invocation_record.LogRecord) (class): A wire-transmissible representation of a log record.

- [LogsLocation](/reference/python-sdk/roboto/domain/actions/invocation_record#roboto.domain.actions.invocation_record.LogsLocation) (class): Invocation log storage location

- [QueryTriggersRequest](/reference/python-sdk/roboto/domain/actions/trigger_operations#roboto.domain.actions.trigger_operations.QueryTriggersRequest) (class): Request payload to query triggers with filters.

- [ScheduledTrigger](/reference/python-sdk/roboto/domain/actions/scheduled_trigger#roboto.domain.actions.scheduled_trigger.ScheduledTrigger) (class): A trigger that invokes actions on a recurring schedule, e.g. hourly or daily.

- [ScheduledTriggerRecord](/reference/python-sdk/roboto/domain/actions/scheduled_trigger_record#roboto.domain.actions.scheduled_trigger_record.ScheduledTriggerRecord) (class): Wire-transmissible representation of a scheduled trigger.

- [SetActionAccessibilityRequest](/reference/python-sdk/roboto/domain/actions/action_operations#roboto.domain.actions.action_operations.SetActionAccessibilityRequest) (class): Request payload to set action accessibility.

- [SetContainerInfoRequest](/reference/python-sdk/roboto/domain/actions/invocation_operations#roboto.domain.actions.invocation_operations.SetContainerInfoRequest) (class): Request to set container information for an invocation.

- [SetLogsLocationRequest](/reference/python-sdk/roboto/domain/actions/invocation_operations#roboto.domain.actions.invocation_operations.SetLogsLocationRequest) (class): Request to set the location where invocation logs are stored.

- [SourceProvenance](/reference/python-sdk/roboto/domain/actions/invocation_record#roboto.domain.actions.invocation_record.SourceProvenance) (class): Provenance information for an invocation source

- [Trigger](/reference/python-sdk/roboto/domain/actions/trigger#roboto.domain.actions.trigger.Trigger) (class): A rule that automatically invokes an action when specific events or conditions occur.

- [TriggerEvaluationCause](/reference/python-sdk/roboto/domain/actions/trigger_record#roboto.domain.actions.trigger_record.TriggerEvaluationCause) (class): The cause of a TriggerEvaluationRecord is the reason why the trigger was selected for evaluation.

- [TriggerEvaluationDataConstraint](/reference/python-sdk/roboto/domain/actions/trigger_record#roboto.domain.actions.trigger_record.TriggerEvaluationDataConstraint) (class): An optional filtering constraint applied to the data considered by a trigger evaluation.

- [TriggerEvaluationOutcome](/reference/python-sdk/roboto/domain/actions/trigger_record#roboto.domain.actions.trigger_record.TriggerEvaluationOutcome) (class): The outcome of a TriggerEvaluationRecord is the result of the evaluation.

- [TriggerEvaluationOutcomeReason](/reference/python-sdk/roboto/domain/actions/trigger_record#roboto.domain.actions.trigger_record.TriggerEvaluationOutcomeReason) (class): Context for why a trigger evaluation has its TriggerEvaluationOutcome

- [TriggerEvaluationRecord](/reference/python-sdk/roboto/domain/actions/trigger_record#roboto.domain.actions.trigger_record.TriggerEvaluationRecord) (class): Record of a point-in-time evaluation of whether to invoke an action associated with a trigger for a data source.

- [TriggerEvaluationStatus](/reference/python-sdk/roboto/domain/actions/trigger_record#roboto.domain.actions.trigger_record.TriggerEvaluationStatus) (class): When a trigger is selected for evaluation, a trigger evaluation record is created with a status of Pending.

- [TriggerEvaluationsSummaryResponse](/reference/python-sdk/roboto/domain/actions/trigger_operations#roboto.domain.actions.trigger_operations.TriggerEvaluationsSummaryResponse) (class): Response containing summary information about trigger evaluations.

- [TriggerForEachPrimitive](/reference/python-sdk/roboto/domain/actions/trigger_record#roboto.domain.actions.trigger_record.TriggerForEachPrimitive) (class): Defines the granularity at which a trigger executes.

- [TriggerOnEvent](/reference/python-sdk/roboto/domain/actions/trigger_view#roboto.domain.actions.trigger_view.TriggerOnEvent) (class): Properties specific to event-driven triggers.

- [TriggerOnSchedule](/reference/python-sdk/roboto/domain/actions/trigger_view#roboto.domain.actions.trigger_view.TriggerOnSchedule) (class): Properties specific to scheduled triggers.

- [TriggerRecord](/reference/python-sdk/roboto/domain/actions/trigger_record#roboto.domain.actions.trigger_record.TriggerRecord) (class): A wire-transmissible representation of a trigger.

- [TriggerSchedule](/reference/python-sdk/roboto/domain/actions/scheduled_trigger#roboto.domain.actions.scheduled_trigger.TriggerSchedule) (class): Utility for defining trigger schedules.

- [TriggerType](/reference/python-sdk/roboto/domain/actions/trigger_view#roboto.domain.actions.trigger_view.TriggerType) (class): Types of triggers supported by the Roboto platform.

- [TriggerView](/reference/python-sdk/roboto/domain/actions/trigger_view#roboto.domain.actions.trigger_view.TriggerView) (class): Unified data model for all Roboto trigger types.

- [UpdateActionRequest](/reference/python-sdk/roboto/domain/actions/action_operations#roboto.domain.actions.action_operations.UpdateActionRequest) (class): Request payload to update an action.

- [UpdateInvocationStatus](/reference/python-sdk/roboto/domain/actions/invocation_operations#roboto.domain.actions.invocation_operations.UpdateInvocationStatus) (class): Request payload to update an invocation's status.

- [UpdateScheduledTriggerRequest](/reference/python-sdk/roboto/domain/actions/scheduled_trigger_operations#roboto.domain.actions.scheduled_trigger_operations.UpdateScheduledTriggerRequest) (class): Request payload to update a scheduled trigger.

- [UpdateTriggerRequest](/reference/python-sdk/roboto/domain/actions/trigger_operations#roboto.domain.actions.trigger_operations.UpdateTriggerRequest) (class): Request payload to update an existing trigger.

- [UploadDestinationType](/reference/python-sdk/roboto/domain/actions/invocation_record#roboto.domain.actions.invocation_record.UploadDestinationType) (class): Type of upload destination for invocation outputs.