Zur Dokumentation springen
API

Workspace löschen

Löscht den Workspace, zu dem der Schlüssel oder die App gehört, mit allem darin, und kündigt seinen Tarif.

DELETE/workspaces/{id}

Führt den echten Aufruf in Ihrem Workspace aus.

DELETE /workspaces/{id}

Löscht den Workspace, zu dem der Schlüssel oder die App gehört, mit allem darin, und kündigt seinen Tarif.

Beispiel

Erfordert account:write. confirm ist der Name des Workspace, so wie die App die Person ihn vor dem Löschen eintippen lässt. Groß- und Kleinschreibung und Leerzeichen davor und danach spielen keine Rolle.

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

Es ist endgültig: Die Domains, Adressen, E-Mails, Mitglieder und Schlüssel des Workspace gehen mit, und der Schlüssel, der den Aufruf gemacht hat, funktioniert nicht mehr.

Nur die ID des Workspace, zu dem der Schlüssel oder die App gehört, wird angenommen, und jede andere ist ein 404. Ein Zugriffstoken, das für ein Mitglied handelt, wird mit 403 owner_only abgelehnt, und ein Schlüssel oder eine App, die auf bestimmte Adressen oder Domains beschränkt ist, mit 422 capability_unsupported.

Der erste Workspace, den ein Konto angelegt hat, lässt sich nicht löschen (409 first_workspace), also löschen Sie stattdessen das ganze Konto in der App. Einer, in den oder aus dem gerade eine Domain verschoben wird, ist ein 409 domain_moving.

Ein falsches oder fehlendes confirm ist ein 422 invalid_parameter für confirm, und die Meldung nennt den Workspace.

Ein OAuth-Zugriffstoken braucht für diesen Aufruf einen Bestätigungscode. Solange die App in den letzten 60 Minuten keinen bestätigt hat, antwortet der Aufruf mit 403 step_up_required und ändert nichts. Ein API-Schlüssel wird nie gefragt. Die Seite Authentifizierung zeigt, wie Sie einen Code anfordern und bestätigen.

Referenz