---
sidebar:
  label: roboto.upload_agent.files
  order: 2
title: roboto.upload_agent.files
---
## Module Contents

### UPLOAD_COMPLETE_FILENAME

```python
roboto.upload_agent.files.UPLOAD_COMPLETE_FILENAME = '.roboto_upload_complete.json'
```

`from roboto.upload_agent.files import UPLOAD_COMPLETE_FILENAME`

[Source](https://github.com/roboto-ai/roboto-python-sdk/blob/main/src/roboto/upload_agent/files.py#L15-L15)

### UPLOAD_IN_PROGRESS_FILENAME

```python
roboto.upload_agent.files.UPLOAD_IN_PROGRESS_FILENAME = '.roboto_upload_in_progress.json'
```

`from roboto.upload_agent.files import UPLOAD_IN_PROGRESS_FILENAME`

[Source](https://github.com/roboto-ai/roboto-python-sdk/blob/main/src/roboto/upload_agent/files.py#L16-L16)

### UploadAgentConfig

```python
class roboto.upload_agent.files.UploadAgentConfig(/, **data: Any)
```

`from roboto.upload_agent.files import UploadAgentConfig`

[Source](https://github.com/roboto-ai/roboto-python-sdk/blob/main/src/roboto/upload_agent/files.py#L45-L74)

Bases: `pydantic.BaseModel`

Upload agent configuration

**Parameters**

- **data** (`Any`)

**Attributes**

- **UploadAgentConfig.default_org_id** (`str | None`) = `None`: The org ID to use when creating datasets via --merge-uploads, or other operations which may have an ambiguous org.
- **UploadAgentConfig.delete_empty_directories** (`bool`) = `False`: If set to true, directories which are empty (or only contain a .roboto_upload_complete.json) after being uploaded will be automatically deleted. This is most useful if combined with delete_upload_files=True
- **UploadAgentConfig.delete_uploaded_files** (`bool`) = `False`: If set to true, will delete files from disk after they've been successfully uploaded to Roboto.
- **UploadAgentConfig.search_paths** (`list[pathlib.Path]`): Directories to recursively scan for files to upload.
- **UploadAgentConfig.upload_config_filename** (`str`) = `'.roboto_upload.json'`: The name of the upload marker file to look for.
- **UploadAgentConfig.version** (`Literal['v1']`) = `'v1'`

### UploadCompleteFile

```python
class roboto.upload_agent.files.UploadCompleteFile(/, **data: Any)
```

`from roboto.upload_agent.files import UploadCompleteFile`

[Source](https://github.com/roboto-ai/roboto-python-sdk/blob/main/src/roboto/upload_agent/files.py#L85-L90)

Bases: `pydantic.BaseModel`

Upload agent complete file

**Parameters**

- **data** (`Any`)

**Attributes**

- **UploadCompleteFile.completed** (`datetime.datetime`)
- **UploadCompleteFile.dataset_id** (`str`)
- **UploadCompleteFile.version** (`Literal['v1']`) = `'v1'`

### UploadConfigFile

```python
class roboto.upload_agent.files.UploadConfigFile(/, **data: Any)
```

`from roboto.upload_agent.files import UploadConfigFile`

[Source](https://github.com/roboto-ai/roboto-python-sdk/blob/main/src/roboto/upload_agent/files.py#L36-L42)

Bases: `pydantic.BaseModel`

Upload agent config file

**Parameters**

- **data** (`Any`)

**Attributes**

- **UploadConfigFile.dataset** (`UploadConfigFileDatasetSection`) = `None`
- **UploadConfigFile.upload** (`UploadConfigFileUploadSection`) = `None`
- **UploadConfigFile.version** (`Literal['v1']`) = `'v1'`

### UploadConfigFileDatasetSection

```python
class roboto.upload_agent.files.UploadConfigFileDatasetSection(**data)
```

`from roboto.upload_agent.files import UploadConfigFileDatasetSection`

[Source](https://github.com/roboto-ai/roboto-python-sdk/blob/main/src/roboto/upload_agent/files.py#L19-L25)

Bases: [`roboto.domain.datasets.CreateDatasetRequest`](/reference/python-sdk/roboto/domain/datasets/operations#roboto.domain.datasets.operations.CreateDatasetRequest)

Upload agent config file dataset section

**Attributes**

- **UploadConfigFileDatasetSection.add_to_collections** (`List[str] | None`) = `None`: An optional list of collection IDs to attempt to add this dataset to.
- **UploadConfigFileDatasetSection.org_id** (`str | None`) = `None`

### UploadConfigFileUploadSection

```python
class roboto.upload_agent.files.UploadConfigFileUploadSection(/, **data: Any)
```

`from roboto.upload_agent.files import UploadConfigFileUploadSection`

[Source](https://github.com/roboto-ai/roboto-python-sdk/blob/main/src/roboto/upload_agent/files.py#L28-L33)

Bases: `pydantic.BaseModel`

Upload agent config file upload section

**Parameters**

- **data** (`Any`)

**Attributes**

- **UploadConfigFileUploadSection.delete_uploaded_files** (`bool | None`) = `None`
- **UploadConfigFileUploadSection.exclude_patterns** (`List[str] | None`) = `None`
- **UploadConfigFileUploadSection.include_patterns** (`List[str] | None`) = `None`

### UploadInProgressFile

```python
class roboto.upload_agent.files.UploadInProgressFile(/, **data: Any)
```

`from roboto.upload_agent.files import UploadInProgressFile`

[Source](https://github.com/roboto-ai/roboto-python-sdk/blob/main/src/roboto/upload_agent/files.py#L77-L82)

Bases: `pydantic.BaseModel`

Upload agent in progress file

**Parameters**

- **data** (`Any`)

**Attributes**

- **UploadInProgressFile.dataset_id** (`str`)
- **UploadInProgressFile.started** (`datetime.datetime`)
- **UploadInProgressFile.version** (`Literal['v1']`) = `'v1'`