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

### CancelActiveInvocationsRequest

```python
class roboto.domain.actions.invocation_operations.CancelActiveInvocationsRequest(
    /,
    **data: Any,
)
```

`from roboto.domain.actions import CancelActiveInvocationsRequest`

[Source](https://github.com/roboto-ai/roboto-python-sdk/blob/main/src/roboto/domain/actions/invocation_operations.py#L26-L42)

Bases: `pydantic.BaseModel`

Request payload to bulk cancel all active invocations within an organization.

This operation cancels multiple invocations in a single request, but only affects invocations that are in non-terminal states (Queued, Running, etc.). The operation is limited in the number of invocations it will attempt to cancel in a single call for performance reasons.

For large numbers of active invocations, continue calling this operation until the has_more returned in the response is False.

**Parameters**

- **data** (`Any`)

**Attributes**

- **CancelActiveInvocationsRequest.created_before** (`datetime.datetime | None`) = `None`: Only cancel invocations created before this timestamp.

  If not provided, cancels all active invocations regardless of age.

### CancelActiveInvocationsResponse

```python
class roboto.domain.actions.invocation_operations.CancelActiveInvocationsResponse(
    /,
    **data: Any,
)
```

`from roboto.domain.actions import CancelActiveInvocationsResponse`

[Source](https://github.com/roboto-ai/roboto-python-sdk/blob/main/src/roboto/domain/actions/invocation_operations.py#L45-L60)

Bases: `pydantic.BaseModel`

Response payload from bulk cancellation of active invocations.

Contains the results of a bulk cancellation operation, including counts of successful and failed cancellations, and whether there are more active invocations to cancel.

**Parameters**

- **data** (`Any`)

**Attributes**

- **CancelActiveInvocationsResponse.failure_count** (`int`): Number of invocations that failed to cancel.
- **CancelActiveInvocationsResponse.has_more** (`bool`): Whether there are more active invocations to cancel.
- **CancelActiveInvocationsResponse.success_count** (`int`): Number of invocations successfully cancelled.

### CreateInvocationRequest

```python
class roboto.domain.actions.invocation_operations.CreateInvocationRequest(
    /,
    **data: Any,
)
```

`from roboto import CreateInvocationRequest`

[Source](https://github.com/roboto-ai/roboto-python-sdk/blob/main/src/roboto/domain/actions/invocation_operations.py#L63-L104)

Bases: `pydantic.BaseModel`

Request payload to create a new action invocation.

Contains all the configuration needed to invoke an action, including input data specifications, parameter values, and execution overrides.

**Parameters**

- **data** (`Any`)

**Attributes**

- **CreateInvocationRequest.compute_requirement_overrides** (`roboto.domain.actions.action_record.ComputeRequirements | None`) = `None`: Optional overrides for CPU, memory, and other compute specifications.
- **CreateInvocationRequest.container_parameter_overrides** (`roboto.domain.actions.action_record.ContainerParameters | None`) = `None`: Optional overrides for container image, entrypoint, and environment variables.
- **CreateInvocationRequest.data_source_id** (`str`): ID of the data source providing input data.
- **CreateInvocationRequest.data_source_type** (`roboto.domain.actions.invocation_record.InvocationDataSourceType`): Type of the data source (e.g., Dataset).
- **CreateInvocationRequest.idempotency_id** (`str | None`) = `None`: Optional unique ID to ensure the invocation runs exactly once.
- **CreateInvocationRequest.input_data** (`list[str]`): List of file patterns for input data selection.
- **CreateInvocationRequest.invocation_source** (`roboto.domain.actions.invocation_record.InvocationSource`): Source of the invocation (Manual, Trigger, etc.).
- **CreateInvocationRequest.invocation_source_id** (`str | None`) = `None`: Optional ID of the entity that initiated the invocation.
- **CreateInvocationRequest.parameter_values** (`dict[str, Any] | None`) = `None`: Optional parameter values to pass to the action.
- **CreateInvocationRequest.rich_input_data** (`roboto.domain.actions.invocation_record.InvocationInput | None`) = `None`: Optional rich input data specification that supersedes the simple input_data patterns.
- **CreateInvocationRequest.timeout** (`int | None`) = `None`: Optional timeout override in minutes.
- **CreateInvocationRequest.upload_destination** (`roboto.domain.actions.invocation_record.InvocationUploadDestination | None`) = `None`: Optional destination for output files.

### SetContainerInfoRequest

```python
class roboto.domain.actions.invocation_operations.SetContainerInfoRequest(
    /,
    **data: Any,
)
```

`from roboto import SetContainerInfoRequest`

[Source](https://github.com/roboto-ai/roboto-python-sdk/blob/main/src/roboto/domain/actions/invocation_operations.py#L107-L119)

Bases: `pydantic.BaseModel`

Request to set container information for an invocation.

Used internally by the Roboto platform to record container details after the action image has been pulled and inspected.

> **Note**
>
> This is typically called from the monitor process and is not intended for direct use by SDK users.

**Parameters**

- **data** (`Any`)

**Attributes**

- **SetContainerInfoRequest.image_digest** (`str`): The digest of the container image that was pulled.

### SetLogsLocationRequest

```python
class roboto.domain.actions.invocation_operations.SetLogsLocationRequest(/, **data: Any)
```

`from roboto import SetLogsLocationRequest`

[Source](https://github.com/roboto-ai/roboto-python-sdk/blob/main/src/roboto/domain/actions/invocation_operations.py#L122-L137)

Bases: `pydantic.BaseModel`

Request to set the location where invocation logs are stored.

Used internally by the Roboto platform to record where log files are saved for later retrieval.

> **Note**
>
> This is typically called from the invocation-scheduling-service and is not intended for direct use by SDK users.

**Parameters**

- **data** (`Any`)

**Attributes**

- **SetLogsLocationRequest.bucket** (`str`): S3 bucket name where logs are stored.
- **SetLogsLocationRequest.prefix** (`str`): S3 key prefix for the log files.

### UpdateInvocationStatus

```python
class roboto.domain.actions.invocation_operations.UpdateInvocationStatus(/, **data: Any)
```

`from roboto import UpdateInvocationStatus`

[Source](https://github.com/roboto-ai/roboto-python-sdk/blob/main/src/roboto/domain/actions/invocation_operations.py#L140-L151)

Bases: `pydantic.BaseModel`

Request payload to update an invocation's status.

Used to record status changes during invocation execution, such as transitioning from Queued to Running to Completed.

**Parameters**

- **data** (`Any`)

**Attributes**

- **UpdateInvocationStatus.detail** (`str`): Additional detail about the status change.
- **UpdateInvocationStatus.status** (`roboto.domain.actions.invocation_record.InvocationStatus`): The new status for the invocation.