LoopCLI

Vercel Connector

LoopCLI keeps your Vercel projects humming—promote previews, warm caches, and orchestrate background jobs without leaving the terminal.

Required secrets

Vault key Description
vercel-token Personal token or team token for the Vercel API.
loopcli secret add vercel-token --value V1...

Common automations

  • Promote preview deployments to production on a schedule.
  • Re-warm ISR caches or trigger On-Demand Revalidation.
  • Kick off marketing site rebuilds after CMS changes.

Example loop

name: vercel-promote
description: Promote a preview deployment to production nightly.
steps:
  - id: get-preview
    name: Find latest preview
    type: http
    config:
      url: https://api.vercel.com/v6/deployments?projectId={{env:VERCEL_PROJECT_ID}}&limit=1
      method: GET
      headers:
        Authorization: "Bearer {{secret:vercel-token}}"
  - id: promote
    name: Promote deployment
    type: http
    config:
      url: https://api.vercel.com/v1/deployments/{{steps.get-preview.response.body.deployments[0].uid}}/alias
      method: POST
      headers:
        Authorization: "Bearer {{secret:vercel-token}}"
      body:
        alias: "{{env:PRODUCTION_DOMAIN}}"

ISR cache warmup

- id: revalidate
  name: Warm homepage cache
  type: http
  config:
    url: https://{{env:PRODUCTION_DOMAIN}}/api/revalidate?path=/&secret={{secret:vercel-revalidate}}
    method: POST

Store the revalidate secret in the vault (vercel-revalidate) to keep it out of source control.

Templates

Helpful links

Related Documentation

Continue learning with these related topics