---
sidebar:
  hidden: true
title: roboto.domain.secrets.record
---
## Module Contents

### AwsSecretRetrievalLocation

```python
class roboto.domain.secrets.record.AwsSecretRetrievalLocation(/, **data: Any)
```

`from roboto.domain.secrets import AwsSecretRetrievalLocation`

[Source](https://github.com/roboto-ai/roboto-python-sdk/blob/main/src/roboto/domain/secrets/record.py#L55-L66)

Bases: `pydantic.BaseModel`

Information required to retrieve a secret from AWS Secrets Manager.

**Parameters**

- **data** (`Any`)

**Attributes**

- **AwsSecretRetrievalLocation.arn** (`str`): ARN of the secret.
- **AwsSecretRetrievalLocation.store_type** (`Literal[SecretStoreType]`): Type of secret store. Referenced here explicitly to make deserialization work better.

### AwsSecretsManagerAccessCreds

```python
class roboto.domain.secrets.record.AwsSecretsManagerAccessCreds(/, **data: Any)
```

`from roboto.domain.secrets import AwsSecretsManagerAccessCreds`

[Source](https://github.com/roboto-ai/roboto-python-sdk/blob/main/src/roboto/domain/secrets/record.py#L26-L48)

Bases: `pydantic.BaseModel`

Context required to update a secret in AWS Secrets Manager.

**Parameters**

- **data** (`Any`)

**Attributes**

- **AwsSecretsManagerAccessCreds.access_key_id** (`str`): AWS access key ID.
- **AwsSecretsManagerAccessCreds.region** (`str`): AWS region.
- **AwsSecretsManagerAccessCreds.secret_access_key** (`str`): AWS secret access key.
- **AwsSecretsManagerAccessCreds.session_token** (`str`): AWS session token.
- **AwsSecretsManagerAccessCreds.store_type** (`Literal[SecretStoreType]`): Type of secret store. Referenced here explicitly to make deserialization work better.

### CreateSecretRequest

```python
class roboto.domain.secrets.record.CreateSecretRequest(/, **data: Any)
```

`from roboto.domain.secrets import CreateSecretRequest`

[Source](https://github.com/roboto-ai/roboto-python-sdk/blob/main/src/roboto/domain/secrets/record.py#L107-L115)

Bases: `pydantic.BaseModel`

Request payload for the Create Secret

**Parameters**

- **data** (`Any`)

**Attributes**

- **CreateSecretRequest.name** (`str`): Name of the secret.

### GetSecretAccessCredsResponse

```python
class roboto.domain.secrets.record.GetSecretAccessCredsResponse(/, **data: Any)
```

`from roboto.domain.secrets import GetSecretAccessCredsResponse`

[Source](https://github.com/roboto-ai/roboto-python-sdk/blob/main/src/roboto/domain/secrets/record.py#L118-L127)

Bases: `pydantic.BaseModel`

Response payload for the Update Secret

**Parameters**

- **data** (`Any`)

**Attributes**

- **GetSecretAccessCredsResponse.creds** (`SecretAccessCreds`) = `None`: Creds required to update the secret in its underlying data store.
- **GetSecretAccessCredsResponse.record** (`SecretRecord`): The secret whose value is going to be updated.

### SecretAccessCreds

```python
roboto.domain.secrets.record.SecretAccessCreds
```

`from roboto.domain.secrets import SecretAccessCreds`

[Source](https://github.com/roboto-ai/roboto-python-sdk/blob/main/src/roboto/domain/secrets/record.py#L51-L51)

Union type for all possible secret update contexts.

### SecretRecord

```python
class roboto.domain.secrets.record.SecretRecord(/, **data: Any)
```

`from roboto.domain.secrets import SecretRecord`

[Source](https://github.com/roboto-ai/roboto-python-sdk/blob/main/src/roboto/domain/secrets/record.py#L73-L104)

Bases: `pydantic.BaseModel`

A wire-transmissible representation of a secret.

**Parameters**

- **data** (`Any`)

**Attributes**

- **SecretRecord.created** (`datetime.datetime`): Timestamp when the secret was created.
- **SecretRecord.created_by** (`str`): RobotoPrincipal which created the secret.
- **SecretRecord.last_used** (`datetime.datetime | None`) = `None`: Timestamp when the secret was last used in an action, or None if the secret has never been used.
- **SecretRecord.location** (`SecretRetrievalLocation`) = `None`: Information required to dereference the secret in its specific secret store. This is used in combination with temporary hyper-downscoped access creds to update or retrieve the secret's value.
- **SecretRecord.modified** (`datetime.datetime`): Timestamp when the secret was last modified.
- **SecretRecord.modified_by** (`str`): RobotoPrincipal which last modified the secret.
- **SecretRecord.name** (`str`): Name of the secret. Secret names must be unique within an organization.
- **SecretRecord.org_id** (`str`): Organization ID that owns the secret.
- **SecretRecord.store_type** (`SecretStoreType`): Type of secret store.

### SecretRetrievalLocation

```python
roboto.domain.secrets.record.SecretRetrievalLocation
```

`from roboto.domain.secrets.record import SecretRetrievalLocation`

[Source](https://github.com/roboto-ai/roboto-python-sdk/blob/main/src/roboto/domain/secrets/record.py#L69-L69)

Union type for all possible secret retrieval locations.

### SecretStoreType

```python
class roboto.domain.secrets.record.SecretStoreType
```

`from roboto.domain.secrets import SecretStoreType`

[Source](https://github.com/roboto-ai/roboto-python-sdk/blob/main/src/roboto/domain/secrets/record.py#L15-L23)

Bases: `roboto.compat.StrEnum`

Type of secret store.

**Attributes**

- **SecretStoreType.AWS** = `'aws'`: AWS Secrets Manager.