ワークスペースを削除する
キーまたはアプリが属するワークスペースを中身ごと削除し、そのプランを解約する。
実際の呼び出しをワークスペースに対して実行します。
DELETE /workspaces/{id}
キーまたはアプリが属するワークスペースを中身ごと削除し、そのプランを解約する。
例
account:write が必要。confirm はワークスペース名で、アプリが削除前にその人に入力を求めるのと同じもの。大文字と小文字の違いや前後の空白は区別しない。
curl -X DELETE "$OE/workspaces/6d2f8a41-9c3e-4b7a-8e15-2f0c9d4b7a63?confirm=Acme%20Support" -H "$AUTH"{ "object": "workspace", "id": "6d2f8a41-9c3e-4b7a-8e15-2f0c9d4b7a63", "deleted": true, "activeWorkspaceId": "10417196-e324-4283-af98-66ec62167c47"}取り消しはできない。ワークスペースのドメイン、アドレス、メール、メンバー、キーがすべて消え、呼び出しを行ったキーも使えなくなる。
受け付けるのはキーまたはアプリが属するワークスペースの ID だけで、それ以外は 404 になる。メンバーとして動作するアクセストークンは 403 owner_only で、特定のアドレスやドメインに限定されたキーやアプリは 422 capability_unsupported で拒否される。
アカウントが最初に作ったワークスペースは削除できない (409 first_workspace) ので、代わりにアプリでアカウント全体を削除する。ドメインの移動元または移動先になっているワークスペースは 409 domain_moving になる。
confirm が誤っているか欠けている場合は confirm に対する 422 invalid_parameter になり、メッセージにワークスペース名が示される。
OAuth アクセストークンでこの呼び出しを行うには確認コードが必要です。アプリが直近 60 分以内にコードを確認するまで、呼び出しは 403 step_up_required を返し、何も変更しません。API キーが求められることはありません。コードの求め方と確認方法は「認証」ページにあります。