---
sidebar:
  label: roboto.auth.scope
  order: 2
title: roboto.auth.scope
---
## Module Contents

### ApiScope

```python
class roboto.auth.scope.ApiScope
```

`from roboto.auth.scope import ApiScope`

[Source](https://github.com/roboto-ai/roboto-python-sdk/blob/main/src/roboto/auth/scope.py#L12-L38)

Bases: `roboto.compat.StrEnum`

Scopes define the set of APIs a credential holder can access.

**Attributes**

- **ApiScope.ApiEverythingElse** = `'api.everything_else'`: Holder has access to all other APIs not covered by other scopes.

  A developer API token will likely want to include this scope, whereas an upload-only device token will likely want to omit it for principle of least privilege.

- **ApiScope.DatasetsCreate** = `'datasets.create'`: Holder can create new datasets.

- **ApiScope.FilesImport** = `'files.import'`: Holder can import existing files from an external object store into Roboto.

- **ApiScope.FilesUpload** = `'files.upload'`: Holder can upload new files to Roboto's managed storage.

#### ApiScope.all()

```python
@classmethod
def all() -> set[ApiScope]
```

[Source](https://github.com/roboto-ai/roboto-python-sdk/blob/main/src/roboto/auth/scope.py#L33-L34)

**Returns**

- `set[ApiScope]`

#### ApiScope.minimal_uploader()

```python
@classmethod
def minimal_uploader() -> set[ApiScope]
```

[Source](https://github.com/roboto-ai/roboto-python-sdk/blob/main/src/roboto/auth/scope.py#L37-L38)

**Returns**

- `set[ApiScope]`