netlify

Netlify

Operates Netlify via REST API. Covers sites, deploys, builds, functions, env vars, forms, DNS. Use when needing the current account state.

Usage

• Use for: Checking deploy status, triggering builds, rotating env vars, reading forms, managing Netlify DNS.
• Skip for: Editing app source code, other providers (Vercel, etc.), local config tweaks (netlify.toml), external DNS.

Credentials check

[ -n "${NETLIFY_AUTH_TOKEN:-$NETLIFY_PERSONAL_TOKEN}" ] && echo "NETLIFY_TOKEN: PRESENT" || echo "NETLIFY_TOKEN: MISSING"

Never echo the variable directly.

If MISSING, respond to the user with EXACTLY this message (do NOT paraphrase, do NOT suggest manual JSON edits):

I need your netlify credential. Run this in another terminal — it'll open the signup page, validate format, and save it safely with masked input:

teleport-setup add-key netlify

Then restart Claude Code (/exit, then claude) and ask me again.

Do NOT suggest editing ~/.claude/settings.local.json manually. The teleport-setup add-key command handles it with backup, validation, and masked input. Stop execution until the user has run the command and restarted.

API

• Base URL: https://api.netlify.com/api/v1
• Auth: Authorization: Bearer $NETLIFY_AUTH_TOKEN
• Content-Type: application/json (writes); application/octet-stream or application/zip (file uploads).
• Pagination: ?page= (1-indexed) + ?per_page= (max 100). Parse Link header for rel="next".
• Rate limits: 500 req/min general; deploys stricter — 3/min + 100/day. Check X-RateLimit-* headers.

Entity hierarchy

team → site (UUID or slug name) → deploy / build / function / form + submissions / env vars / hooks / build_hooks. dns_zones → dns_records are account-scoped.

Endpoints

Resource	Method · Path
Sites	GET /sites, GET/PATCH/DELETE /sites/{site_id}, POST /sites
Deploys	GET /sites/{site_id}/deploys, GET /deploys/{deploy_id}, POST /sites/{site_id}/deploys
Builds	POST /sites/{site_id}/builds, GET /sites/{site_id}/builds
Env vars	GET/POST /accounts/{account_id}/env, PATCH/DELETE .../env/{key}
Functions	GET /sites/{site_id}/functions, GET /sites/{site_id}/functions/{name}
Forms	GET /sites/{site_id}/forms, GET /sites/{site_id}/submissions, GET /forms/{id}/submissions
DNS	GET /dns_zones, GET /dns_zones/{id}, GET/POST /dns_zones/{id}/dns_records, DELETE .../{rec_id}
Hooks	GET/POST /sites/{site_id}/hooks, GET/POST /sites/{site_id}/build_hooks