Skip to content

feat(netlify): add Netlify block with deploys, env vars, and deploy triggers #4518

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
stylessh wants to merge 5 commits into
base: staging
Choose a base branch
from
Open

feat(netlify): add Netlify block with deploys, env vars, and deploy triggers #4518

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
d6b44f0
feat(netlify): add Netlify block with deploys, env vars, and deploy t…
stylessh May 8, 2026
36c8db9
refactor(netlify): switch trigger to manual webhook setup
stylessh May 8, 2026
287fbb1
fix(netlify): include deploy state in idempotency key
stylessh May 8, 2026
34cb274
chore(netlify): generate docs and align registry with skill checklist
stylessh May 8, 2026
a5a8100
fix(netlify): expose pagination + expand block outputs
stylessh May 8, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
24 changes: 24 additions & 0 deletions apps/docs/components/icons.tsx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6727,6 +6727,30 @@ export function VercelIcon(props: SVGProps<SVGSVGElement>) {
)
}

export function NetlifyIcon(props: SVGProps<SVGSVGElement>) {
return (
<svg
{...props}
viewBox='0 0 256 226'
xmlns='http://www.w3.org/2000/svg'
preserveAspectRatio='xMidYMid'
>
<path
fill='#fff'
d='M69.181 188.087h-2.417l-12.065-12.065v-2.417l18.444-18.444h12.778l1.704 1.704v12.778zM54.699 51.628v-2.417l12.065-12.065h2.417L87.625 55.59v12.778l-1.704 1.704H73.143z'
/>
<path
fill='#014847'
d='M160.906 149.198h-17.552l-1.466-1.466v-41.089c0-7.31-2.873-12.976-11.689-13.174-4.537-.119-9.727 0-15.274.218l-.833.852v53.173l-1.466 1.466H95.074l-1.466-1.466v-70.19l1.466-1.467h39.503c15.354 0 27.795 12.441 27.795 27.795v43.882l-1.466 1.466Z'
/>
<path
fill='#fff'
d='M71.677 122.889H1.466L0 121.423V103.83l1.466-1.466h70.211l1.466 1.466v17.593zM254.534 122.889h-70.211l-1.466-1.466V103.83l1.466-1.466h70.211L256 103.83v17.593zM117.876 54.124V1.466L119.342 0h17.593l1.466 1.466v52.658l-1.466 1.466h-17.593zM117.876 223.787v-52.658l1.466-1.466h17.593l1.466 1.466v52.658l-1.466 1.465h-17.593z'
/>
</svg>
)
}

export function CloudflareIcon(props: SVGProps<SVGSVGElement>) {
return (
<svg {...props} xmlns='http://www.w3.org/2000/svg' viewBox='0 0 512 512'>
Expand Down
2 changes: 2 additions & 0 deletions apps/docs/components/ui/icon-mapping.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -126,6 +126,7 @@ import {
MongoDBIcon,
MySQLIcon,
Neo4jIcon,
NetlifyIcon,
NotionIcon,
ObsidianIcon,
OktaIcon,
Expand Down Expand Up @@ -341,6 +342,7 @@ export const blockTypeToIconMap: Record<string, IconComponent> = {
mongodb: MongoDBIcon,
mysql: MySQLIcon,
neo4j: Neo4jIcon,
netlify: NetlifyIcon,
notion: NotionIcon,
notion_v2: NotionIcon,
obsidian: ObsidianIcon,
Expand Down
1 change: 1 addition & 0 deletions apps/docs/content/docs/en/tools/meta.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -122,6 +122,7 @@
"mongodb",
"mysql",
"neo4j",
"netlify",
"notion",
"obsidian",
"okta",
Expand Down
294 changes: 294 additions & 0 deletions apps/docs/content/docs/en/tools/netlify.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,294 @@
---
title: Netlify
description: Manage Netlify sites, deploys, and environment variables
---

import { BlockInfoCard } from "@/components/ui/block-info-card"

<BlockInfoCard
type="netlify"
color="#00C7B7"
/>

## Usage Instructions

Trigger and inspect Netlify deploys (builds), and manage account or site-scoped environment variables. Generate a Personal Access Token at https://app.netlify.com/user/applications#personal-access-tokens.



## Tools

### `netlify_list_sites`

List Netlify sites accessible to the authenticated user

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | Netlify Personal Access Token |
| `name` | string | No | Filter sites by name |
| `filter` | string | No | Filter scope: all, owner, or guest |
| `page` | number | No | Page number \(1-indexed\) |
| `perPage` | number | No | Results per page \(max 100\) |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `sites` | array | List of Netlify sites |
| ↳ `id` | string | Site ID |
| ↳ `name` | string | Site name |
| ↳ `url` | string | Primary site URL |
| ↳ `sslUrl` | string | HTTPS site URL |
| ↳ `adminUrl` | string | Netlify admin URL |
| ↳ `customDomain` | string | Custom domain |
| ↳ `accountId` | string | Owning account ID |
| ↳ `accountSlug` | string | Owning account slug |
| ↳ `createdAt` | string | Creation timestamp |
| ↳ `updatedAt` | string | Last update timestamp |
| `count` | number | Number of sites returned |

### `netlify_list_deploys`

List deploys for a Netlify site

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | Netlify Personal Access Token |
| `siteId` | string | Yes | Site ID or primary domain |
| `state` | string | No | Filter by deploy state: ready, error, building, enqueued, processing, uploading, new |
| `branch` | string | No | Filter by git branch |
| `production` | string | No | Filter to production deploys only \("true" or "false"\) |
| `page` | number | No | Page number \(1-indexed\) |
| `perPage` | number | No | Results per page \(max 100\) |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `deploys` | array | List of deploys |
| ↳ `id` | string | Deploy ID |
| ↳ `siteId` | string | Site ID |
| ↳ `state` | string | Deploy state: new, enqueued, building, uploading, processing, ready, error, retrying |
| ↳ `name` | string | Site name |
| ↳ `url` | string | Site URL |
| ↳ `deployUrl` | string | Unique deploy URL |
| ↳ `deploySslUrl` | string | Unique deploy HTTPS URL |
| ↳ `adminUrl` | string | Netlify admin URL |
| ↳ `branch` | string | Git branch |
| ↳ `context` | string | Deploy context: production, deploy-preview, branch-deploy |
| ↳ `commitRef` | string | Git commit SHA |
| ↳ `commitUrl` | string | Git commit URL |
| ↳ `errorMessage` | string | Error message if failed |
| ↳ `createdAt` | string | Creation timestamp |
| ↳ `updatedAt` | string | Last update timestamp |
| ↳ `publishedAt` | string | Publish timestamp |
| `count` | number | Number of deploys returned |

### `netlify_get_deploy`

Get details of a specific Netlify deploy

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | Netlify Personal Access Token |
| `deployId` | string | Yes | Deploy ID |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `id` | string | Deploy ID |
| `siteId` | string | Site ID |
| `state` | string | Deploy state |
| `name` | string | Site name |
| `url` | string | Site URL |
| `deployUrl` | string | Unique deploy URL |
| `deploySslUrl` | string | Unique deploy HTTPS URL |
| `adminUrl` | string | Netlify admin URL |
| `branch` | string | Git branch |
| `context` | string | Deploy context |
| `commitRef` | string | Git commit SHA |
| `commitUrl` | string | Git commit URL |
| `errorMessage` | string | Error message if failed |
| `createdAt` | string | Creation timestamp |
| `updatedAt` | string | Last update timestamp |
| `publishedAt` | string | Publish timestamp |

### `netlify_create_deploy`

Trigger a new Netlify deploy by starting a build for a site (optionally from a specific branch)

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | Netlify Personal Access Token |
| `siteId` | string | Yes | Site ID or primary domain to deploy |
| `branch` | string | No | Git branch to build from \(defaults to the site’s configured production branch\) |
| `title` | string | No | Optional human-readable label shown in the deploy log |
| `clearCache` | string | No | Clear the build cache before deploying \("true" or "false"\) |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `id` | string | Build ID |
| `deployId` | string | Deploy ID produced by this build \(use to poll status\) |
| `siteId` | string | Site ID |
| `sha` | string | Git commit SHA being built |
| `done` | boolean | Whether the build has completed |
| `error` | string | Build error if any |
| `createdAt` | string | Creation timestamp |

### `netlify_cancel_deploy`

Cancel an in-progress Netlify deploy

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | Netlify Personal Access Token |
| `deployId` | string | Yes | Deploy ID to cancel |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `id` | string | Deploy ID |
| `siteId` | string | Site ID |
| `state` | string | Deploy state after cancellation |
| `name` | string | Site name |
| `url` | string | Site URL |
| `deployUrl` | string | Unique deploy URL |
| `deploySslUrl` | string | Unique deploy HTTPS URL |
| `adminUrl` | string | Netlify admin URL |
| `branch` | string | Git branch |
| `context` | string | Deploy context |
| `commitRef` | string | Git commit SHA |
| `commitUrl` | string | Git commit URL |
| `errorMessage` | string | Error message if failed |
| `createdAt` | string | Creation timestamp |
| `updatedAt` | string | Last update timestamp |
| `publishedAt` | string | Publish timestamp |

### `netlify_list_env_vars`

List environment variables for an account, optionally scoped to a site

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | Netlify Personal Access Token |
| `accountId` | string | Yes | Account ID or slug that owns the environment variables |
| `siteId` | string | No | Optional site ID to scope variables to a specific site |
| `contextName` | string | No | Filter by deploy context \(production, deploy-preview, branch-deploy, dev\) |
| `scope` | string | No | Filter by scope \(builds, functions, runtime, post_processing\) |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `envVars` | array | List of environment variables |
| ↳ `key` | string | Variable name |
| ↳ `scopes` | array | Where the variable applies \(builds, functions, runtime, post_processing\) |
| ↳ `values` | array | Per-context values |
| ↳ `id` | string | Value ID |
| ↳ `context` | string | Context name |
| ↳ `contextParameter` | string | Branch name when context is branch-deploy |
| ↳ `value` | string | Variable value |
| ↳ `isSecret` | boolean | Whether the value is secret |
| ↳ `updatedAt` | string | Last update timestamp |
| `count` | number | Number of variables returned |

### `netlify_create_env_var`

Create a new environment variable for an account, optionally scoped to a site

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | Netlify Personal Access Token |
| `accountId` | string | Yes | Account ID or slug that owns the variable |
| `siteId` | string | No | Optional site ID to scope the variable to a specific site |
| `key` | string | Yes | Variable name \(e.g., DATABASE_URL\) |
| `value` | string | Yes | Variable value |
| `context` | string | No | Deploy context this value applies to: all, production, deploy-preview, branch-deploy, dev \(default: all\) |
| `scopes` | string | No | Comma-separated scopes \(builds, functions, runtime, post_processing\). Defaults to all scopes |
| `isSecret` | string | No | Mark the value as secret \("true" or "false"\) |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `envVar` | object | Created environment variable |
| ↳ `key` | string | Variable name |
| ↳ `scopes` | array | Scopes |
| ↳ `values` | array | Per-context values |
| ↳ `id` | string | Value ID |
| ↳ `context` | string | Context name |
| ↳ `contextParameter` | string | Branch name for branch-deploy context |
| ↳ `value` | string | Variable value |
| ↳ `isSecret` | boolean | Whether the value is secret |
| ↳ `updatedAt` | string | Last update timestamp |

### `netlify_update_env_var`

Replace an environment variable for an account, optionally scoped to a site

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | Netlify Personal Access Token |
| `accountId` | string | Yes | Account ID or slug that owns the variable |
| `siteId` | string | No | Optional site ID to scope the variable to a specific site |
| `key` | string | Yes | Variable name to update |
| `value` | string | Yes | New variable value \(replaces all existing values\) |
| `context` | string | No | Deploy context: all, production, deploy-preview, branch-deploy, dev \(default: all\) |
| `scopes` | string | No | Comma-separated scopes \(builds, functions, runtime, post_processing\) |
| `isSecret` | string | No | Mark the value as secret \("true" or "false"\) |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `envVar` | object | Updated environment variable |
| ↳ `key` | string | Variable name |
| ↳ `scopes` | array | Scopes |
| ↳ `values` | array | Per-context values |
| ↳ `id` | string | Value ID |
| ↳ `context` | string | Context name |
| ↳ `contextParameter` | string | Branch name for branch-deploy context |
| ↳ `value` | string | Variable value |
| ↳ `isSecret` | boolean | Whether the value is secret |
| ↳ `updatedAt` | string | Last update timestamp |

### `netlify_delete_env_var`

Delete an environment variable from an account, optionally scoped to a site

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | Netlify Personal Access Token |
| `accountId` | string | Yes | Account ID or slug that owns the variable |
| `siteId` | string | No | Optional site ID to scope deletion to a specific site |
| `key` | string | Yes | Variable name to delete |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `deleted` | boolean | Whether the environment variable was deleted |


1 change: 1 addition & 0 deletions apps/docs/content/docs/en/triggers/meta.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -33,6 +33,7 @@
"linear",
"microsoft-teams",
"monday",
"netlify",
"notion",
"outlook",
"resend",
Expand Down
Loading
Loading