Aller à la documentation
API

Supprimer l'espace de travail

Supprime l'espace de travail auquel appartient la clé ou l'application, avec tout ce qu'il contient, et résilie sa formule.

DELETE/workspaces/{id}

Exécute le véritable appel sur votre espace de travail.

DELETE /workspaces/{id}

Supprime l'espace de travail auquel appartient la clé ou l'application, avec tout ce qu'il contient, et résilie sa formule.

Exemple

Nécessite account:write. confirm est le nom de l'espace de travail, tel que l'application demande à la personne de le saisir avant la suppression. La casse et les espaces autour n'ont pas d'importance.

curl
curl -X DELETE "$OE/workspaces/6d2f8a41-9c3e-4b7a-8e15-2f0c9d4b7a63?confirm=Acme%20Support" -H "$AUTH"
Réponse
{  "object": "workspace",  "id": "6d2f8a41-9c3e-4b7a-8e15-2f0c9d4b7a63",  "deleted": true,  "activeWorkspaceId": "10417196-e324-4283-af98-66ec62167c47"}

C'est définitif : les domaines, les adresses, le courrier, les membres et les clés de l'espace de travail disparaissent avec lui, et la clé qui a fait l'appel cesse de fonctionner.

Seul l'identifiant de l'espace de travail auquel appartient la clé ou l'application est accepté, et tout autre est un 404. Un jeton d'accès agissant pour un membre est refusé avec 403 owner_only, et une clé ou une application limitée à certaines adresses ou certains domaines avec 422 capability_unsupported.

Le premier espace de travail créé par un compte ne peut pas être supprimé (409 first_workspace), donc supprimez plutôt le compte entier dans l'application. Un espace de travail vers lequel ou depuis lequel un domaine est en cours de déplacement est un 409 domain_moving.

Un confirm erroné ou manquant est un 422 invalid_parameter sur confirm, et le message nomme l'espace de travail.

Un jeton d'accès OAuth a besoin d'un code de vérification pour cet appel. Tant que l'application n'en a pas vérifié un dans les 60 dernières minutes, l'appel répond 403 step_up_required et ne change rien. On ne le demande jamais à une clé API. La page Authentification montre comment demander un code et le vérifier.

Référence