Перейти к документации
API

Удалить рабочее пространство

Удаляет рабочее пространство, которому принадлежит ключ или приложение, со всем содержимым и отменяет его тариф.

DELETE/workspaces/{id}

Выполняет настоящий запрос в вашем рабочем пространстве.

DELETE /workspaces/{id}

Удаляет рабочее пространство, которому принадлежит ключ или приложение, со всем содержимым и отменяет его тариф.

Пример

Требуется account:write. confirm это название рабочего пространства, как приложение просит человека ввести его перед удалением. Регистр букв и пробелы вокруг не важны.

curl
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"}

Это навсегда: домены, адреса, почта, участники и ключи рабочего пространства уходят вместе с ним, а ключ, сделавший вызов, перестаёт работать.

Принимается только идентификатор рабочего пространства, которому принадлежит ключ или приложение, а любой другой даёт 404. Токен доступа, действующий от имени участника, отклоняется с 403 owner_only, а ключ или приложение, ограниченные определёнными адресами или доменами, с 422 capability_unsupported.

Первое рабочее пространство, созданное аккаунтом, удалить нельзя (409 first_workspace), поэтому вместо этого удалите весь аккаунт в приложении. Пространство, в которое или из которого переносится домен, даёт 409 domain_moving.

Неверный или отсутствующий confirm даёт 422 invalid_parameter для confirm, и сообщение называет рабочее пространство.

Токену доступа OAuth для этого вызова нужен код подтверждения. Пока приложение не подтвердило код за последние 60 минут, вызов отвечает 403 step_up_required и ничего не меняет. У API-ключа его никогда не спрашивают. Страница «Аутентификация» показывает, как запросить код и подтвердить его.

Справочник