Saltar para a documentação
API

Eliminar o espaço de trabalho

Elimina o espaço de trabalho a que pertence a chave ou a aplicação, com tudo o que contém, e cancela o seu plano.

DELETE/workspaces/{id}

Executa a chamada real no seu espaço de trabalho.

DELETE /workspaces/{id}

Elimina o espaço de trabalho a que pertence a chave ou a aplicação, com tudo o que contém, e cancela o seu plano.

Exemplo

Requer account:write. confirm é o nome do espaço de trabalho, tal como a aplicação pede à pessoa que o escreva antes de eliminar. As maiúsculas e os espaços à volta não importam.

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

É definitivo: os domínios, endereços, correio, membros e chaves do espaço de trabalho vão com ele, e a chave que fez a chamada deixa de funcionar.

Só é aceite o id do espaço de trabalho a que pertence a chave ou a aplicação, e qualquer outro é um 404. Um token de acesso que atua em nome de um membro é recusado com 403 owner_only, e uma chave ou uma aplicação limitada a certos endereços ou domínios com 422 capability_unsupported.

O primeiro espaço de trabalho que uma conta criou não pode ser eliminado (409 first_workspace), por isso elimine antes a conta inteira na aplicação. Um com um domínio a ser movido para ele ou dele é um 409 domain_moving.

Um confirm errado ou em falta é um 422 invalid_parameter em confirm, e a mensagem indica o espaço de trabalho.

Um token de acesso OAuth precisa de um código de verificação para esta chamada. Até a aplicação ter verificado um nos últimos 60 minutos, a chamada responde 403 step_up_required e não altera nada. A uma chave de API nunca é pedido. A página Autenticação mostra como pedir um código e verificá-lo.

Referência