Pular para o conteúdo principal
POST
Iniciar aplicação
string
obrigatório
O ID da aplicação a iniciar. Se a aplicação pertencer a um workspace, informe o ID dele no query parameter workspace_id.
string
Se a aplicação pertencer a um workspace, o ID do workspace. Obrigatório para membros do workspace que agem sobre uma aplicação que não lhes pertence.

Resposta

object
A resposta com o status da operação.

Respostas de erro

string
O código de erro que indica o motivo da falha. Valores possíveis:
  • APP_NOT_FOUND: a aplicação informada não existe.
  • ACCESS_DENIED: o usuário não tem permissão para agir sobre a aplicação.
  • PLAN_REQUIRED: a conta dona da aplicação não tem um plano ativo (403). Assine um plano para continuar.
  • APP_SHIELD_COOLDOWN: a Vertra Shield pausou a aplicação; esta ação fica bloqueada até a pausa terminar (403). details.until informa quando.
  • OPERATION_IN_PROGRESS: outra operação de ciclo de vida na mesma aplicação já está em execução (409). O container não foi tocado — aguarde alguns segundos e tente de novo. Veja Códigos de erro comuns.
Esta rota compartilha com restart e stop um orçamento de 10 requisições por minuto por aplicação. Veja Limite de requisições.
Última modificação em 28 de outubro de 2026