Saltar al contenido principal
POST
Iniciar la aplicación
string
requerido
El ID de la aplicación que quieres iniciar. Si la aplicación pertenece a un workspace, pasa su ID en el parámetro de consulta workspace_id.
string
Si la aplicación pertenece a un workspace, el ID del workspace. Es obligatorio para los miembros del workspace que actúen sobre una aplicación que no les pertenece.

Respuesta

object
La respuesta con el estado de la operación.

Respuestas de error

string
El código de error que indica el motivo del fallo. Valores posibles:
  • APP_NOT_FOUND: La aplicación indicada no existe.
  • ACCESS_DENIED: El usuario no tiene permiso para actuar sobre la aplicación.
  • PLAN_REQUIRED: La cuenta propietaria de la aplicación no tiene un plan activo (403). Contrata un plan para continuar.
  • APP_SHIELD_COOLDOWN: Vertra Shield pausó la aplicación; esta acción queda bloqueada hasta que termine la pausa (403). details.until indica cuándo.
  • OPERATION_IN_PROGRESS: Otra operación de ciclo de vida sobre la misma aplicación ya está en curso (409). El contenedor no se tocó; espera unos segundos y vuelve a intentarlo. Consulta Códigos de error comunes.
Esta ruta comparte con restart y stop un presupuesto de 10 peticiones por minuto por aplicación. Consulta Límite de peticiones.
Última modificación el 28 de octubre de 2026