# profiles

> Named sets of API key and base URL; switch between them. The `machinemail profiles` commands: arguments, flags, examples and the API routes they call.

Named sets of API key and base URL; switch between them.

| Command                               | Summary                             |
| ------------------------------------- | ----------------------------------- |
| [`profiles delete`](#profiles-delete) | Delete a profile and its stored key |
| [`profiles list`](#profiles-list)     | List profiles (keys masked)         |
| [`profiles use`](#profiles-use)       | Make a profile the current one      |

Every command also takes the [global flags](/content/docs/cli/commands#global-flags/index.html).

## profiles delete

Delete a profile and its stored key.

Also: `machinemail profiles rm`.

Removes the profile from the config file. The key stays valid on the server; revoke it with `machinemail api-keys delete`. On a terminal you confirm by typing the profile name; elsewhere pass --yes.

```bash
machinemail profiles delete <profile>
```

#### Arguments

| Field     | Type      |        | Description     |
| --------- | --------- | ------ | ---------------- |
| `<profile>` | `string` | required | Profile name    |

#### Examples

```bash
machinemail profiles delete old-work
machinemail profiles delete ci --yes
```

## profiles list

List profiles (keys masked).

Also: `machinemail profiles ls`.

```bash
machinemail profiles list
```

#### Examples

```bash
machinemail profiles list
machinemail profiles list --json | jq -r '.profiles[].name'
```

## profiles use

Make a profile the current one.

Also: `machinemail profiles switch`.

```bash
machinemail profiles use <profile>
```

#### Arguments

| Field     | Type      |        | Description     |
| --------- | --------- | ------ | ---------------- |
| `<profile>` | `string` | required | Profile name    |

#### Examples

```bash
machinemail profiles use work
```