Netlify integration

Lets your app list the sites and deploys of a Netlify account, read a deploy’s state and start a new build of a site.

Connecting

On the Integrations page choose Connect on Netlify and fill in:

• Personal access token — Netlify → User settings → Applications → Personal access tokens → New access token.

Sapilon checks the key with the provider before it saves it, and stores it encrypted; it is never shown again.

What your app can do

Only these requests are available; anything else is refused.

• GET /user
• GET /sites
• GET /sites/*
• GET /sites/*/deploys
• POST /sites/*/builds
• GET /deploys/*

How the agent uses it

Use integrations.request('netlify', …); paths are relative to https://api.netlify.com/api/v1.

• GET /user — the token’s account.
• GET /sites, GET /sites/{siteId} — Example: { method: 'GET', path: '/sites', query: { filter: 'all' } }.
• GET /sites/{siteId}/deploys — newest first. Example: { method: 'GET', path: '/sites/abc/deploys', query: { per_page: '10' } }.
• POST /sites/{siteId}/builds — start a build of the site’s linked repository. Example: { method: 'POST', path: '/sites/abc/builds' }.
• GET /deploys/{deployId} — one deploy; body.state is ready, building or error.

More from Netlify: https://docs.netlify.com/api/get-started/