Workspace

Un workspace contiene i tuoi domini, template, contatti, campagne e chiavi API. Questa pagina descrive quanti workspace può avere un account, come passare dall'uno all'altro, e cosa chiude un workspace o l'accesso di qualcuno a esso.

Workspace posseduti e condivisi

Un account può possedere più workspace e appartenere ad altri come membro, quando i loro proprietari lo invitano (vedi Team).

Il piano è della persona, non del workspace: il piano del tuo account decide quanti workspace puoi possedere. Il limite conta i workspace attivi che possiedi, sospesi compresi; quelli in eliminazione non contano.

GET /v1/workspace restituisce il limite come limits.workspaces, accanto a domains, emailsPerMonth, membersPerAccount, membersPerWorkspace, webhooks e testSendsPerDay (richiede l'API 0.24.0 o successiva). I workspace in cui sei membro non contano. Il valore è quello del piano del proprietario del workspace: un membro che apre il workspace di un altro legge il limite del proprietario, non il proprio.

I workspace eliminati restano finché restano i loro dati (vedi Eliminare un workspace): un account può possedere al massimo 10 workspace in tutto, contando quelli in eliminazione. Oltre quella soglia la creazione di un workspace risponde 409 CONFLICT: scrivi a support@tratto.email.

Cambiare workspace nella dashboard

La dashboard ha un selettore che elenca i workspace che possiedi e quelli a cui appartieni. La scelta vale per la scheda del browser: due schede possono lavorare su due workspace diversi nello stesso momento.

Le chiavi API non risentono del selettore. Una chiave appartiene al workspace in cui è stata creata e opera sempre su quello: cambiare workspace nella dashboard non cambia nulla per le tue integrazioni. La dashboard dice all'API su quale workspace sta lavorando con l'header Tratto-Workspace (vedi Autenticazione).

Accettare un invito mentre possiedi già un workspace, o appartieni a uno, non è un errore: diventi membro del nuovo workspace e la tua sessione passa subito su quello. Con il selettore torni agli altri.

Elencare i tuoi workspace

La dashboard legge l'elenco con GET /v1/workspaces. La rotta accetta solo una sessione della dashboard: una chiave API riceve 403 FORBIDDEN.

{
  "data": [
    { "id": "ws_abc123", "name": "Acme Production", "role": "owner", "status": "active" },
    { "id": "ws_def456", "name": "Client Store", "role": "member", "status": "suspended" }
  ]
}

• role dice se l'account che fa la richiesta è il proprietario del workspace (owner) o un membro (member).
• status vale active o suspended. Un workspace sospeso è in sola lettura.
• I workspace in eliminazione non compaiono.
• L'elenco non è paginato.

Creare un workspace

Dalla dashboard, oppure con POST /v1/workspaces. La rotta accetta solo una sessione della dashboard: una chiave API riceve 403 FORBIDDEN, e così un account senza accesso alla beta. Il corpo è facoltativo:

{ "name": "Acme Staging" }

name è lungo da 1 a 100 caratteri (predefinito My Workspace); un nome non valido riceve 422 VALIDATION_ERROR. Una richiesta riuscita risponde 201 Created con lo stesso oggetto di GET /v1/workspace. Il nuovo workspace diventa quello su cui lavora la sessione, e la dashboard aggiorna il proprio accesso per vederlo.

Oltre il tuo primo workspace, la richiesta viene rifiutata in quest'ordine:

Vedi Codici di Errore per il formato del corpo d'errore.

Eliminare un workspace

Solo il proprietario può eliminare un workspace, e solo dalla dashboard. Prima di procedere la dashboard chiede tre cose:

• il nome esatto del workspace, digitato come conferma;
• un accesso recente, negli ultimi 5 minuti: se il tuo è più vecchio, la dashboard ti chiede di accedere di nuovo;
• un indirizzo email verificato sull'account del proprietario: se non è verificato, la dashboard offre l'invio dell'email di verifica.

Cosa succede

L'effetto è immediato e non si annulla:

• il workspace smette di inviare email;
• ogni chiave API del workspace viene rifiutata con 403 TENANT_CLOSED;
• nessuno può più aprire il workspace, membri compresi.

Il proprietario riceve un'email di conferma dell'eliminazione, e ogni membro riceve un'email che lo avvisa che il workspace è stato eliminato.

Il tuo account Tratto non viene eliminato: lo tieni, e puoi creare un workspace nuovo.

I tuoi dati

Eliminare il workspace chiude l'accesso, non cancella i dati: contatti, email e il resto del contenuto restano memorizzati. La cancellazione definitiva dei dati non è ancora automatica: per richiederla scrivi a support@tratto.email.

I tuoi domini

I domini di un workspace eliminato restano riservati a quel workspace. Se crei un workspace nuovo, non puoi aggiungervi da solo lo stesso dominio: scrivi a support@tratto.email.

La chiamata API

La dashboard chiama DELETE /v1/workspace. La rotta accetta solo una sessione della dashboard: una chiave API riceve sempre 403, qualunque permesso abbia. Per questo workspace.delete() negli SDK Node.js e Python non può eliminare un workspace: usa la dashboard. Dalla versione 1.3.0 di entrambi gli SDK il metodo è segnato come deprecato (@tratto/email 1.3.0 o successiva, tratto-email 1.3.0 o successiva) e sparirà nella prossima versione maggiore.

Il corpo della richiesta porta la conferma:

{ "confirmName": "Acme Production" }

Una richiesta riuscita risponde 202 Accepted:

{
  "data": {
    "id": "ws_abc123",
    "status": "pending_deletion",
    "deletedAt": "2026-10-05T09:30:00.000Z"
  }
}

Vedi Codici di Errore per il formato del corpo d'errore.

Rimuovere un membro

Quando un membro viene rimosso da un workspace:

• perde subito l'accesso;
• riceve un'email che lo avvisa che è stato rimosso dal workspace;
• il suo account Tratto resta attivo.

Prossimo: Autenticazione · Codici di Errore