Un despliegue puede hacer que una web devuelva errores durante un minuto. Inicia una ventana de mantenimiento desde tu pipeline y sus monitores no se comprueban, no se abren incidencias ni se envían alertas, y ese tiempo no cuenta en contra de la disponibilidad. Cierra la ventana cuando termine el despliegue y las comprobaciones se reanudan al momento.
Antes de empezar
La API REST está incluida en Professional y Business. Crea una clave de API con Read & write en Settings › API y guárdala como secreto en tu CI, aquí UPTIMECHECK_API_KEY.Busca los ID de los monitores que quieres pausar. Cada uno empieza por mon_ y es la última parte de la dirección de la página del monitor; también puedes listarlos todos:
curl -sS https://app.uptimecheck.com/api/v1/monitors \
-H «Authorization: Bearer $UPTIMECHECK_API_KEY» | jq -r ‘.data[] | [.id, .name] | @tsv’
GitHub Actions
Este workflow inicia una ventana de 30 minutos, despliega y cierra la ventana tanto si el despliegue ha funcionado como si no. Sustituye los ID de los monitores y el paso de despliegue por los tuyos. En cualquier otro CI funcionan las mismas dos llamadas.
name: Deploy
on:
push:
branches: [main]
jobs:
deploy:
runs-on: ubuntu-latest
env:
UPTIMECHECK_API_KEY: ${{ secrets.UPTIMECHECK_API_KEY }}
steps:
– uses: actions/checkout@v4
– name: Start maintenance
id: maintenance
run: |
body=$(jq -n \
–arg start «$(date -u +%Y-%m-%dT%H:%M:%SZ)» \
–arg end «$(date -u -d «+30 minutes» +%Y-%m-%dT%H:%M:%SZ)» \
‘{title: «Deploying a new version», startsAt: $start, endsAt: $end,
monitorIds: [«mon_9xk2m1q8w4», «mon_4t7p2k8d1z»]}’)
id=$(curl -sS -X POST https://app.uptimecheck.com/api/v1/maintenance \
-H «Authorization: Bearer $UPTIMECHECK_API_KEY» \
-H «Content-Type: application/json» \
-d «$body» | jq -r ‘.data.id // empty’)
echo «id=$id» >> «$GITHUB_OUTPUT»
– name: Deploy
run: ./deploy.sh
– name: End maintenance
if: always() && steps.maintenance.outputs.id != »
run: |
curl -sS -X DELETE \
«https://app.uptimecheck.com/api/v1/maintenance/${{ steps.maintenance.outputs.id }}» \
-H «Authorization: Bearer $UPTIMECHECK_API_KEY»
Si no se puede contactar con Uptimecheck, el despliegue se ejecuta igualmente, sin ventana.
Las dos llamadas
POST /api/v1/maintenance inicia o programa una ventana. Envía title, startsAt y endsAt como horas ISO 8601, por ejemplo 2026-10-18T14:00:00Z, y monitorIds. Un inicio en el pasado la inicia ahora, y una ventana dura como máximo 14 días. El data.id de la respuesta empieza por mw_.Campos opcionales: message, que se muestra en las páginas de estado, y notifySubscribers (false salvo que envíes true), que avisa por email a los suscriptores de la página de estado.DELETE /api/v1/maintenance/{id} cierra al instante una ventana en curso o cancela una que aún no ha empezado. Responde 204.
Conviene saber
Pon endsAt un poco después de lo que tarda tu despliegue más lento. Si el job se interrumpe antes del último paso, la ventana termina igualmente a su hora.Las páginas de estado que muestran estos monitores indican Maintenance in progress durante la ventana y la listan con su título, igual que el widget de estado. Elige un título que puedan ver los visitantes.Si hay una incidencia abierta cuando empieza la ventana, se cierra, y el monitor vuelve a empezar con una comprobación nueva cuando termina la ventana.Los pings de cron jobs que llegan durante la ventana se registran pero no cambian nada, y un ping que falte durante ella no genera alertas.La API también puede pausar y reanudar monitores sueltos (POST /api/v1/monitors/{id}/pause y /resume). Para un despliegue es más sencilla una ventana, porque termina sola.
Todos los campos están en la referencia de la API. Para planificar ventanas desde la app, consulta cómo programar una ventana de mantenimiento. Más sobre la API REST.