> ## Documentation Index
> Fetch the complete documentation index at: https://docs.olostep.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Comandi per account e fatturazione

> account, team, chiavi, crediti e fatturazione: gestisci il tuo account Olostep dal terminale.

Questi comandi gestiscono il tuo account Olostep. Agiscono sul team a cui sei connesso. I comandi che modificano qualcosa accettano `--preview` e `--dry-run`, così puoi verificarli prima.

`olostep whoami` è lo stesso comando di `olostep account info`.

## account

### olostep account info

Mostra il tuo account Olostep connesso, il tuo team, il piano del team e il suo saldo crediti.

```bash theme={null}
olostep account info [--json] [--fields a,b]
```

Abbreviazione: `olostep whoami`.

Accetta anche `--json` e `--fields`. Vedi [Flag globali](https://docs.olostep.com/cli/usage.md#global-flags).

```bash theme={null}
olostep whoami
olostep account info --json
```

## team

Membri, ruoli e inviti.

### olostep team info

Mostra il nome del tuo team, il metodo di pagamento, il piano e il saldo crediti.

```bash theme={null}
olostep team info [--json] [--fields a,b]
```

Accetta anche `--json` e `--fields`. Vedi [Flag globali](https://docs.olostep.com/cli/usage.md#global-flags).

```bash theme={null}
olostep team info
```

### olostep team members

Elenca i membri del tuo team attuale, i loro ruoli e le tue autorizzazioni.

```bash theme={null}
olostep team members [--json] [--fields a,b]
```

Accetta anche `--json` e `--fields`. Vedi [Flag globali](https://docs.olostep.com/cli/usage.md#global-flags).

```bash theme={null}
olostep team members
olostep team members --json
```

### olostep team rename

Rinomina il tuo team attuale.

```bash theme={null}
olostep team rename (--team-name text) [--preview] [--json] [--fields a,b] [--dry-run]
```

**Flag**

| Flag | Obbligatorio | Descrizione |
| - | - | - |
| `--team-name` | Sì | Nuovo nome del team. |

Accetta anche `--json`, `--fields`, `--dry-run` e `--preview`. Vedi [Flag globali](https://docs.olostep.com/cli/usage.md#global-flags).

```bash theme={null}
olostep team rename --team-name "Acme Research"
```

### olostep team invites

Elenca gli inviti in sospeso del tuo team.

```bash theme={null}
olostep team invites [--json] [--fields a,b]
```

Accetta anche `--json` e `--fields`. Vedi [Flag globali](https://docs.olostep.com/cli/usage.md#global-flags).

```bash theme={null}
olostep team invites
```

### olostep team invite

Invita una persona al tuo team tramite email. Olostep invia loro un invito.

```bash theme={null}
olostep team invite (--email text) [--preview] [--json] [--fields a,b] [--dry-run]
```

**Flag**

| Flag | Obbligatorio | Descrizione |
| - | - | - |
| `--email` | Sì | Indirizzo email dell'invitato. |

Accetta anche `--json`, `--fields`, `--dry-run` e `--preview`. Vedi [Flag globali](https://docs.olostep.com/cli/usage.md#global-flags).

```bash theme={null}
olostep team invite --email jane@example.com
```

### olostep team invite-revoke

Revoca un invito al team in sospeso.

> [!NOTE]
>
> Chiede conferma prima di eseguire; passa `--yes` quando non c'è un terminale.

```bash theme={null}
olostep team invite-revoke (--code text) [--preview] [--json] [--fields a,b] [--dry-run] [--yes]
```

**Flag**

| Flag | Obbligatorio | Descrizione |
| - | - | - |
| `--code` | Sì | Codice dell'invito dalla lista degli inviti. |

Accetta anche `--json`, `--fields`, `--dry-run`, `--preview` e `--yes`. Vedi [Flag globali](https://docs.olostep.com/cli/usage.md#global-flags).

```bash theme={null}
olostep team invites
olostep team invite-revoke --code <code>
```

### olostep team role

Cambia il ruolo di un membro del team. Non puoi cambiare il ruolo del proprietario, il tuo o l'ultimo admin.

> [!NOTE]
>
> Chiede conferma prima di eseguire; passa `--yes` quando non c'è un terminale.

```bash theme={null}
olostep team role (--email text) (--role admin|user) [--preview] [--json] [--fields a,b] [--dry-run] [--yes]
```

**Flag**

| Flag | Obbligatorio | Descrizione |
| - | - | - |
| `--email` | Sì | Indirizzo email del membro. |
| `--role` | Sì | Nuovo ruolo. Uno di: `admin`, `user`. |

Accetta anche `--json`, `--fields`, `--dry-run`, `--preview` e `--yes`. Vedi [Flag globali](https://docs.olostep.com/cli/usage.md#global-flags).

```bash theme={null}
olostep team role --email jane@example.com --role admin
```

### olostep team switch-preview

Anteprima dell'adesione al team a cui sei stato invitato, senza cambiare la tua appartenenza.

```bash theme={null}
olostep team switch-preview (--invite-code text) [--json] [--fields a,b]
```

**Flag**

| Flag | Obbligatorio | Descrizione |
| - | - | - |
| `--invite-code` | Sì | Codice dell'invito. |

Accetta anche `--json` e `--fields`. Vedi [Flag globali](https://docs.olostep.com/cli/usage.md#global-flags).

```bash theme={null}
olostep team switch-preview --invite-code <invite_code>
```

### olostep team switch

Accetta un invito e passa a quel team. Questo potrebbe rimuovere il tuo accesso al tuo team attuale.

> [!NOTE]
>
> Chiede conferma prima di eseguire; passa `--yes` quando non c'è un terminale.

```bash theme={null}
olostep team switch (--invite-code text) [--preview] [--json] [--fields a,b] [--dry-run] [--yes]
```

**Flag**

| Flag | Obbligatorio | Descrizione |
| - | - | - |
| `--invite-code` | Sì | Codice dell'invito. |

Accetta anche `--json`, `--fields`, `--dry-run`, `--preview` e `--yes`. Vedi [Flag globali](https://docs.olostep.com/cli/usage.md#global-flags).

```bash theme={null}
olostep team switch-preview --invite-code <invite_code>
olostep team switch --invite-code <invite_code>
```

### olostep team domain-invite

Mostra qualsiasi invito al team impostato per il dominio della tua email.

```bash theme={null}
olostep team domain-invite [--json] [--fields a,b]
```

Accetta anche `--json` e `--fields`. Vedi [Flag globali](https://docs.olostep.com/cli/usage.md#global-flags).

```bash theme={null}
olostep team domain-invite
```

## keys

Chiavi API per l'[API di Olostep](https://docs.olostep.com/get-started/authentication.md). Il CLI stesso non ne ha bisogno.

### olostep keys list

Elenca le tue chiavi API: nomi, metadati e `key_id`. Non stampa mai i valori delle chiavi.

```bash theme={null}
olostep keys list [--json] [--fields a,b]
```

Accetta anche `--json` e `--fields`. Vedi [Flag globali](https://docs.olostep.com/cli/usage.md#global-flags).

```bash theme={null}
olostep keys list
```

### olostep keys create

Crea una chiave API. Stampa i suoi metadati, non la chiave. Per vedere la chiave, usa `olostep keys reveal` o il dashboard.

```bash theme={null}
olostep keys create (--api-key-name text) [--preview] [--json] [--fields a,b] [--dry-run]
```

**Flag**

| Flag | Obbligatorio | Descrizione |
| - | - | - |
| `--api-key-name` | Sì | Nome descrittivo della chiave. |

Accetta anche `--json`, `--fields`, `--dry-run` e `--preview`. Vedi [Flag globali](https://docs.olostep.com/cli/usage.md#global-flags).

```bash theme={null}
olostep keys create --api-key-name "production-server"
```

### olostep keys reveal

Mostra una chiave API, o scrivila in un file env. La chiave viene mostrata solo in un terminale interattivo. Da un agente di codifica o una pipe, il CLI non la stampa mai: usa `--write-env <file>` per salvarla come `OLOSTEP_API_KEY` (o il nome in `--var`). Il file deve essere ignorato da git, a meno che non passi `--force`.

```bash theme={null}
olostep keys reveal [--write-env file] [--var value] [--force] <key>
```

**Argomenti**

| Argomento | Descrizione |
| - | - |
| `key` | Nome della chiave o key\_id dalla lista delle chiavi. |

**Flag**

| Flag | Obbligatorio | Descrizione |
| - | - | - |
| `--write-env` | No | Scrivi la chiave in questo file env invece di mostrarla. |
| `--var` | No | Nome della variabile per --write-env. Default: `OLOSTEP_API_KEY`. |
| `--force` | No | Scrivi anche se git non ignora il file. |

```bash theme={null}
olostep keys reveal production-server
olostep keys reveal production-server --write-env .env
olostep keys reveal <key_id> --write-env .env.local --var OLOSTEP_KEY
```

### olostep keys revoke

Revoca una chiave API tramite il suo `key_id`, mai tramite la chiave stessa.

> [!NOTE]
>
> Chiede conferma prima di eseguire; passa `--yes` quando non c'è un terminale.

```bash theme={null}
olostep keys revoke (--key-id text) [--preview] [--json] [--fields a,b] [--dry-run] [--yes]
```

**Flag**

| Flag | Obbligatorio | Descrizione |
| - | - | - |
| `--key-id` | Sì | key\_id opaco dalla lista delle chiavi. |

Accetta anche `--json`, `--fields`, `--dry-run`, `--preview` e `--yes`. Vedi [Flag globali](https://docs.olostep.com/cli/usage.md#global-flags).

```bash theme={null}
olostep keys list
olostep keys revoke --key-id <key_id>
```

### olostep keys manage

Ottieni un link alla pagina delle chiavi API sul dashboard di Olostep.

```bash theme={null}
olostep keys manage [--json] [--fields a,b]
```

Accetta anche `--json` e `--fields`. Vedi [Flag globali](https://docs.olostep.com/cli/usage.md#global-flags).

```bash theme={null}
olostep keys manage
```

## credits

Il tuo saldo, utilizzo e premi. Vedi [Saldo e fatturazione](https://docs.olostep.com/balance-billing/balance-and-billing.md).

### olostep credits rewards

Elenca i premi in crediti che puoi guadagnare e se li hai riscattati.

```bash theme={null}
olostep credits rewards [--json] [--fields a,b]
```

Accetta anche `--json` e `--fields`. Vedi [Flag globali](https://docs.olostep.com/cli/usage.md#global-flags).

```bash theme={null}
olostep credits rewards
```

### olostep credits reward-claim

Riscatta un premio dopo aver completato ciò che richiede.

```bash theme={null}
olostep credits reward-claim (--reward slack_join|x_follow|linkedin_follow|youtube_follow|docs_visit) [--preview] [--json] [--fields a,b] [--dry-run]
```

**Flag**

| Flag | Obbligatorio | Descrizione |
| - | - | - |
| `--reward` | Sì | Premio completato. Uno di: `slack_join`, `x_follow`, `linkedin_follow`, `youtube_follow`, `docs_visit`. |

Accetta anche `--json`, `--fields`, `--dry-run` e `--preview`. Vedi [Flag globali](https://docs.olostep.com/cli/usage.md#global-flags).

```bash theme={null}
olostep credits reward-claim --reward docs_visit
```

### olostep credits balance

Mostra il saldo crediti del tuo team, il piano, lo stato di utilizzo e quando scadono i crediti.

```bash theme={null}
olostep credits balance [--json] [--fields a,b]
```

Accetta anche `--json` e `--fields`. Vedi [Flag globali](https://docs.olostep.com/cli/usage.md#global-flags).

```bash theme={null}
olostep credits balance
olostep credits balance --json
```

### olostep credits history

Mostra l'utilizzo giornaliero dei crediti del tuo team per un intervallo di date UTC, inclusi i giorni con dati mancanti o parziali. Predefinito agli ultimi 30 giorni.

```bash theme={null}
olostep credits history [--start-date text] [--end-date text] [--json] [--fields a,b]
```

**Flag**

| Flag | Obbligatorio | Descrizione |
| - | - | - |
| `--start-date` | No | Primo giorno UTC incluso, YYYY-MM-DD; predefinito a 29 giorni prima di end\_date. |
| `--end-date` | No | Ultimo giorno UTC incluso, YYYY-MM-DD; predefinito a oggi. Non può essere nel futuro. |

Accetta anche `--json` e `--fields`. Vedi [Flag globali](https://docs.olostep.com/cli/usage.md#global-flags).

```bash theme={null}
olostep credits history
olostep credits history --start-date 2026-10-01 --end-date 2026-10-28 --json
```

## billing

Piani, fatture, metodi di pagamento e ricarica automatica. I pagamenti avvengono sempre nel browser; i dettagli della carta non passano mai attraverso il CLI.

### olostep billing cleanup-abandoned

Annulla le fatture aperte e cancella gli abbonamenti incompleti lasciati da checkout abbandonati. Distruttivo.

> [!NOTE]
>
> Chiede conferma prima di eseguire; passa `--yes` quando non c'è un terminale.

```bash theme={null}
olostep billing cleanup-abandoned [--subscription-id text] [--preview] [--json] [--fields a,b] [--dry-run] [--yes]
```

**Flag**

| Flag | Obbligatorio | Descrizione |
| - | - | - |
| `--subscription-id` | No | Abbonamento incompleto specifico, o ometti per acquisti abbandonati idonei. |

Accetta anche `--json`, `--fields`, `--dry-run`, `--preview` e `--yes`. Vedi [Flag globali](https://docs.olostep.com/cli/usage.md#global-flags).

```bash theme={null}
olostep billing cleanup-abandoned --preview
```

### olostep billing subscription

Mostra gli abbonamenti disponibili e quello attivo.

```bash theme={null}
olostep billing subscription [--json] [--fields a,b]
```

Accetta anche `--json` e `--fields`. Vedi [Flag globali](https://docs.olostep.com/cli/usage.md#global-flags).

```bash theme={null}
olostep billing subscription
```

### olostep billing plans

Elenca i piani di abbonamento disponibili per il tuo account.

```bash theme={null}
olostep billing plans [--json] [--fields a,b]
```

Accetta anche `--json` e `--fields`. Vedi [Flag globali](https://docs.olostep.com/cli/usage.md#global-flags).

```bash theme={null}
olostep billing plans
```

### olostep billing topups

Elenca le ricariche di crediti che puoi acquistare, in una valuta.

```bash theme={null}
olostep billing topups [--currency text] [--json] [--fields a,b]
```

**Flag**

| Flag | Obbligatorio | Descrizione |
| - | - | - |
| `--currency` | No | Codice valuta a tre lettere, come `USD`. |

Accetta anche `--json` e `--fields`. Vedi [Flag globali](https://docs.olostep.com/cli/usage.md#global-flags).

```bash theme={null}
olostep billing topups --currency USD
```

### olostep billing invoices

Elenca le fatture del tuo team.

```bash theme={null}
olostep billing invoices [--limit integer] [--json] [--fields a,b]
```

**Flag**

| Flag | Obbligatorio | Descrizione |
| - | - | - |
| `--limit` | No | Fatture per pagina. |

Accetta anche `--json` e `--fields`. Vedi [Flag globali](https://docs.olostep.com/cli/usage.md#global-flags).

```bash theme={null}
olostep billing invoices --limit 10
```

### olostep billing auto-refill

Mostra le tue impostazioni di ricarica automatica e i metodi di pagamento salvati.

```bash theme={null}
olostep billing auto-refill [--json] [--fields a,b]
```

Accetta anche `--json` e `--fields`. Vedi [Flag globali](https://docs.olostep.com/cli/usage.md#global-flags).

```bash theme={null}
olostep billing auto-refill
```

### olostep billing auto-refill-update

Attiva o disattiva la ricarica automatica, o modifica quando e come acquista i crediti.

```bash theme={null}
olostep billing auto-refill-update (--enable true|false) [--threshold integer] [--price-id text] [--payment-method-id text] [--preview] [--json] [--fields a,b] [--dry-run]
```

**Flag**

| Flag | Obbligatorio | Descrizione |
| - | - | - |
| `--enable` | Sì | Abilita la ricarica automatica. |
| `--threshold` | No | Soglia di crediti per la ricarica. |
| `--price-id` | No | ID prezzo della ricarica. |
| `--payment-method-id` | No | ID metodo di pagamento salvato. |

Accetta anche `--json`, `--fields`, `--dry-run` e `--preview`. Vedi [Flag globali](https://docs.olostep.com/cli/usage.md#global-flags).

```bash theme={null}
olostep billing auto-refill-update --enable true --threshold 1000
olostep billing auto-refill-update --enable false
```

### olostep billing checkout

Avvia un checkout per un piano a pagamento o una ricarica. Paghi nel browser. `SUB_BASE` è il piano gratuito e non è un'opzione di checkout.

```bash theme={null}
olostep billing checkout (--plan text) [--preview] [--json] [--fields a,b] [--dry-run]
```

**Flag**

| Flag | Obbligatorio | Descrizione |
| - | - | - |
| `--plan` | Sì | Un piano a pagamento o ID prezzo di ricarica da `billing plans` o `billing topups`, come `SUB_STARTER`. |

Accetta anche `--json`, `--fields`, `--dry-run` e `--preview`. Vedi [Flag globali](https://docs.olostep.com/cli/usage.md#global-flags).

```bash theme={null}
olostep billing plans
olostep billing checkout --plan SUB_STARTER
```

### olostep billing cancel

Annulla il tuo abbonamento attivo.

> [!NOTE]
>
> Chiede conferma prima di eseguire; passa `--yes` quando non c'è un terminale.

```bash theme={null}
olostep billing cancel [--preview] [--json] [--fields a,b] [--dry-run] [--yes]
```

Accetta anche `--json`, `--fields`, `--dry-run`, `--preview` e `--yes`. Vedi [Flag globali](https://docs.olostep.com/cli/usage.md#global-flags).

```bash theme={null}
olostep billing cancel --preview
olostep billing cancel
```

### olostep billing portal

Ottieni un link al tuo portale di fatturazione.

```bash theme={null}
olostep billing portal [--preview] [--json] [--fields a,b] [--dry-run]
```

Accetta anche `--json`, `--fields`, `--dry-run` e `--preview`. Vedi [Flag globali](https://docs.olostep.com/cli/usage.md#global-flags).

```bash theme={null}
olostep billing portal
```

### olostep billing payment-default

Imposta un metodo di pagamento salvato come predefinito per il team.

```bash theme={null}
olostep billing payment-default (--payment-method-id text) [--preview] [--json] [--fields a,b] [--dry-run]
```

**Flag**

| Flag | Obbligatorio | Descrizione |
| - | - | - |
| `--payment-method-id` | Sì | ID metodo di pagamento salvato. |

Accetta anche `--json`, `--fields`, `--dry-run` e `--preview`. Vedi [Flag globali](https://docs.olostep.com/cli/usage.md#global-flags).

```bash theme={null}
olostep billing auto-refill
olostep billing payment-default --payment-method-id <payment_method_id>
```

### olostep billing payment-remove

Rimuovi un metodo di pagamento salvato. Potresti non essere in grado di rimuovere uno che utilizza la ricarica automatica.

> [!NOTE]
>
> Chiede conferma prima di eseguire; passa `--yes` quando non c'è un terminale.

```bash theme={null}
olostep billing payment-remove (--payment-method-id text) [--preview] [--json] [--fields a,b] [--dry-run] [--yes]
```

**Flag**

| Flag | Obbligatorio | Descrizione |
| - | - | - |
| `--payment-method-id` | Sì | ID metodo di pagamento salvato. |

Accetta anche `--json`, `--fields`, `--dry-run`, `--preview` e `--yes`. Vedi [Flag globali](https://docs.olostep.com/cli/usage.md#global-flags).

```bash theme={null}
olostep billing payment-remove --payment-method-id <payment_method_id>
```

### olostep billing payment-add

Ottieni un link per aggiungere una carta sul dashboard. I dettagli della carta non passano mai attraverso il CLI.

```bash theme={null}
olostep billing payment-add [--json] [--fields a,b]
```

Accetta anche `--json` e `--fields`. Vedi [Flag globali](https://docs.olostep.com/cli/usage.md#global-flags).

```bash theme={null}
olostep billing payment-add
```

### olostep billing pending-cancel

Annulla un abbonamento incompleto lasciato da un checkout abbandonato.

> [!NOTE]
>
> Chiede conferma prima di eseguire; passa `--yes` quando non c'è un terminale.

```bash theme={null}
olostep billing pending-cancel (--subscription-id text) [--preview] [--json] [--fields a,b] [--dry-run] [--yes]
```

**Flag**

| Flag | Obbligatorio | Descrizione |
| - | - | - |
| `--subscription-id` | Sì | ID abbonamento incompleto. |

Accetta anche `--json`, `--fields`, `--dry-run`, `--preview` e `--yes`. Vedi [Flag globali](https://docs.olostep.com/cli/usage.md#global-flags).

```bash theme={null}
olostep billing pending-cancel --subscription-id <subscription_id>
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.