---
sidebar:
  hidden: true
title: roboto.domain.actions.trigger_operations
---
## Module Contents

### CreateTriggerRequest

```python
class roboto.domain.actions.trigger_operations.CreateTriggerRequest(/, **data: Any)
```

`from roboto import CreateTriggerRequest`

[Source](https://github.com/roboto-ai/roboto-python-sdk/blob/main/src/roboto/domain/actions/trigger_operations.py#L30-L89)

Bases: `pydantic.BaseModel`

Request payload to create a new trigger.

Contains all the configuration needed to create a trigger that automatically invokes actions when specific conditions are met.

**Parameters**

- **data** (`Any`)

**Attributes**

- **CreateTriggerRequest.action_digest** (`str | None`) = `None`: Optional specific version digest of the action to invoke. If not provided, uses the latest version.

- **CreateTriggerRequest.action_name** (`str`): Name of the action to invoke when the trigger fires.

- **CreateTriggerRequest.action_owner_id** (`str | None`) = `None`: Organization ID that owns the target action. If not provided, searches in the caller's organization.

- **CreateTriggerRequest.additional_inputs** (`list[str] | None`) = `None`: Optional additional file patterns to include in action invocations beyond the required inputs.

- **CreateTriggerRequest.causes** (`list[roboto.domain.actions.trigger_record.TriggerEvaluationCause] | None`) = `None`: List of events that can cause this trigger to be evaluated. If not provided, uses default causes.

- **CreateTriggerRequest.compute_requirement_overrides** (`roboto.domain.actions.ComputeRequirements | None`) = `None`: Optional compute requirement overrides for action invocations.

- **CreateTriggerRequest.condition** (`roboto.query.ConditionType | None`) = `None`: Optional condition that must be met for the trigger to fire.

  Can filter based on metadata, file properties, etc.

- **CreateTriggerRequest.container_parameter_overrides** (`roboto.domain.actions.ContainerParameters | None`) = `None`: Optional container parameter overrides for action invocations.

- **CreateTriggerRequest.enabled** (`bool`) = `True`: Whether the trigger should be active immediately after creation.

- **CreateTriggerRequest.for_each** (`roboto.domain.actions.trigger_record.TriggerForEachPrimitive`): Granularity of execution - Dataset or DatasetFile.

- **CreateTriggerRequest.name** (`str`) = `None`: Unique name for the trigger (alphanumeric, hyphens, underscores only, max 256 characters).

- **CreateTriggerRequest.parameter_values** (`dict[str, Any] | None`) = `None`: Parameter values to pass to the action when invoked.

- **CreateTriggerRequest.required_inputs** (`list[str]`): List of file patterns that must be present for the trigger to fire. Uses glob patterns like '\*\*/\*.bag'.

- **CreateTriggerRequest.service_user_id** (`str | None`) = `None`: Optional service user ID for authentication.

- **CreateTriggerRequest.timeout** (`int | None`) = `None`: Optional timeout override for action invocations in minutes.

#### CreateTriggerRequest.validate_additional_inputs()

```python
def validate_additional_inputs(value: Optional[list[str]]) -> Optional[list[str]]
```

[Source](https://github.com/roboto-ai/roboto-python-sdk/blob/main/src/roboto/domain/actions/trigger_operations.py#L88-L89)

**Parameters**

- **value** (`Optional[list[str]]`)

**Returns**

- `Optional[list[str]]`

#### CreateTriggerRequest.validate_required_inputs()

```python
def validate_required_inputs(value: list[str]) -> list[str]
```

[Source](https://github.com/roboto-ai/roboto-python-sdk/blob/main/src/roboto/domain/actions/trigger_operations.py#L84-L85)

**Parameters**

- **value** (`list[str]`)

**Returns**

- `list[str]`

### EvaluateTriggersRequest

```python
class roboto.domain.actions.trigger_operations.EvaluateTriggersRequest(/, **data: Any)
```

`from roboto import EvaluateTriggersRequest`

[Source](https://github.com/roboto-ai/roboto-python-sdk/blob/main/src/roboto/domain/actions/trigger_operations.py#L92-L105)

Bases: `pydantic.BaseModel`

Request payload to manually evaluate specific triggers.

Used to force evaluation of triggers outside of their normal automatic evaluation cycle. This is typically used for testing or debugging trigger behavior.

> **Note**
>
> This is primarily used internally by the Roboto platform and is not commonly needed by SDK users.

**Parameters**

- **data** (`Any`)

**Attributes**

- **EvaluateTriggersRequest.trigger_evaluation_ids** (`collections.abc.Iterable[int]`): Collection of trigger evaluation IDs to process.

### QueryTriggersRequest

```python
class roboto.domain.actions.trigger_operations.QueryTriggersRequest(/, **data: Any)
```

`from roboto import QueryTriggersRequest`

[Source](https://github.com/roboto-ai/roboto-python-sdk/blob/main/src/roboto/domain/actions/trigger_operations.py#L108-L117)

Bases: `pydantic.BaseModel`

Request payload to query triggers with filters.

Used to search for triggers based on various criteria such as name, status, or other attributes.

**Parameters**

- **data** (`Any`)

**Attributes**

- **QueryTriggersRequest.filters** (`dict[str, Any]`) = `None`: Dictionary of filter criteria to apply to the trigger search.
- **QueryTriggersRequest.model_config**: Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].

### TriggerEvaluationsSummaryResponse

```python
class roboto.domain.actions.trigger_operations.TriggerEvaluationsSummaryResponse(
    /,
    **data: Any,
)
```

`from roboto import TriggerEvaluationsSummaryResponse`

[Source](https://github.com/roboto-ai/roboto-python-sdk/blob/main/src/roboto/domain/actions/trigger_operations.py#L120-L131)

Bases: `pydantic.BaseModel`

Response containing summary information about trigger evaluations.

Provides high-level statistics about trigger evaluation status, useful for monitoring and debugging trigger performance.

**Parameters**

- **data** (`Any`)

**Attributes**

- **TriggerEvaluationsSummaryResponse.count_pending** (`int`): Number of trigger evaluations currently pending.
- **TriggerEvaluationsSummaryResponse.last_evaluation_start** (`datetime.datetime | None`): Timestamp of the most recent evaluation start, if any evaluations have occurred.

### UpdateTriggerRequest

```python
class roboto.domain.actions.trigger_operations.UpdateTriggerRequest(/, **data: Any)
```

`from roboto import UpdateTriggerRequest`

[Source](https://github.com/roboto-ai/roboto-python-sdk/blob/main/src/roboto/domain/actions/trigger_operations.py#L134-L180)

Bases: `pydantic.BaseModel`

Request payload to update an existing trigger.

Contains the changes to apply to a trigger. Only specified fields will be updated; others remain unchanged. Uses NotSet sentinel values to distinguish between explicit None values and unspecified fields.

**Parameters**

- **data** (`Any`)

**Attributes**

- **UpdateTriggerRequest.action_digest** (`str | roboto.sentinels.NotSetType | None`): New specific version digest of the action.
- **UpdateTriggerRequest.action_name** (`str | roboto.sentinels.NotSetType`): New action name to invoke.
- **UpdateTriggerRequest.action_owner_id** (`str | roboto.sentinels.NotSetType`): New organization ID that owns the target action.
- **UpdateTriggerRequest.additional_inputs** (`list[str] | roboto.sentinels.NotSetType | None`): New additional file patterns to include.
- **UpdateTriggerRequest.causes** (`list[roboto.domain.actions.trigger_record.TriggerEvaluationCause] | roboto.sentinels.NotSetType`): New list of events that can cause trigger evaluation.
- **UpdateTriggerRequest.compute_requirement_overrides** (`roboto.domain.actions.ComputeRequirements | roboto.sentinels.NotSetType | None`): New compute requirement overrides.
- **UpdateTriggerRequest.condition** (`roboto.query.ConditionType | roboto.sentinels.NotSetType | None`): New condition that must be met for trigger to fire.
- **UpdateTriggerRequest.container_parameter_overrides** (`roboto.domain.actions.ContainerParameters | roboto.sentinels.NotSetType | None`): New container parameter overrides.
- **UpdateTriggerRequest.enabled** (`bool | roboto.sentinels.NotSetType`): New enabled status for the trigger.
- **UpdateTriggerRequest.for_each** (`roboto.domain.actions.trigger_record.TriggerForEachPrimitive | roboto.sentinels.NotSetType`): New execution granularity (Dataset or DatasetFile).
- **UpdateTriggerRequest.model_config**: Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].
- **UpdateTriggerRequest.parameter_values** (`dict[str, Any] | roboto.sentinels.NotSetType | None`): New parameter values to pass to the action.
- **UpdateTriggerRequest.required_inputs** (`list[str] | roboto.sentinels.NotSetType`): New list of required file patterns.
- **UpdateTriggerRequest.timeout** (`int | roboto.sentinels.NotSetType | None`): New timeout override for action invocations.