netlify

name

netlify

description

Netlify is a frontend-first cloud platform that lets developers seamlessly build, deploy, preview, and scale modern web applications using Git-based workflows, serverless functions, edge caching, and a global CDN—empowering teams to ship fast, secure, and high-performance sites at scale. Read and write Netlify data through One: sites, deploys, agentrunners, hooks, trafficsplits, accounts and more, 147 actions with real parameter documentation. Use whenever the user asks to look something up in Netlify, create or update a record there, or build code against the Netlify API.

Netlify through One

Netlify is a frontend-first cloud platform that lets developers seamlessly build, deploy, preview, and scale modern web applications using Git-based workflows, serverless functions, edge caching, and a global CDN—empowering teams to ship fast, secure, and high-performance sites at scale.

One exposes Netlify through four MCP tools. The table below carries real action ids from One's knowledge base, so for a common operation you can skip search and go straight to reading the action's parameters.

How to run an action

1. Find the action in the table below, or call search_one_platform_actions with platform netlify if it is not listed.
2. Call get_one_action_knowledge with the action id. Do this every time, including for actions in this table. The table gives you the id, not the parameters.
3. Call execute_one_action with parameters copied from that knowledge.

Never guess a parameter name, a body field, or an enum value. The knowledge has the real schema, and a guessed field is either a 400 or a silent write of the wrong thing.

Before you start

Call list_one_integrations once and confirm Netlify is connected. If it is missing, the user has not connected it: say so and point them at https://app.withone.ai rather than reaching for raw HTTP.

Each connection carries an access field. If it reports {"policy": "methods", "methods": ["GET"]} the agent is read-only here, so plan a read-only answer instead of attempting a write that will be refused.

Before a write

Creates, updates, deletes and sends land on a real Netlify account and cannot be recalled. State the action and the specific target in one line before the first write in a task, and let the user stop you. Reads need no confirmation.

Actions

Sites

Action	Method	Path	Action id
Get a Site	GET	/sites/{{siteId}}	conn_mod_def::GJ5BP3MVSVU::cPHqsYEDTNCklvPq6dSOGg
Get a Site’s Metadata	GET	/sites/{{siteId}}/metadata	conn_mod_def::GJ5BPMhEr_w::VJYypWfqQbyocUquDBowvQ
List an Account’s Sites	GET	/{{accountSlug}}/sites	conn_mod_def::GJ5BP4U4r20::-TzZoanlQZe9PHZi00RULQ
List Sites	GET	/api/v1/sites	conn_mod_def::GJ5BP3pIYwA::sqd9N8qzRMGEmGLiLpihQg
Configure DNS for a Site	PUT	/sites/{{siteId}}/dns	conn_mod_def::GJ5BOPS3W5s::NTMdJ8OwSmqicMqvdKO2Ow
Create a Site	POST	/api/v1/sites	conn_mod_def::GJ5BPtjXdnc::PGQCpw4CSsyX842UHit26Q
Create a Site in a Team (Account)	POST	/{{accountSlug}}/sites	conn_mod_def::GJ5BPuh05iU::pjgiz81eSDiRv9-oJ-ZCGw
Delete a Site	DELETE	/sites/{{siteId}}	conn_mod_def::GJ5BPviJMK8::avmM_QygRau0rwZ4qY8cMw
Disable a Site	PUT	/sites/{{siteId}}/disable	conn_mod_def::GJ5BPtKxVxY::K9LAHER6R5CRLd9Sai1xLw
Enable a Site	PUT	/sites/{{siteId}}/enable	conn_mod_def::GJ5BP6YS5lQ::xT9JZYXaTWS4ShOY43eAjA
Roll Back a Site’s Deploy	PUT	/sites/{{siteId}}/rollback	conn_mod_def::GJ5BNZXSnxg::qu8MoaigRQSi9phXDYtGqQ
Unlink a Site’s Repository	PUT	/sites/{{siteId}}/unlink_repo	conn_mod_def::GJ5BP24FYPI::p8z0pnphTjqemvW8aRd0_Q

2 more Sites actions are available through search.

Deploys

Action	Method	Path	Action id
Get a Deploy	GET	/deploys/{{deployId}}	conn_mod_def::GJ5BNHj0f6U::1neMKLL4SYWcUf1z4n7Oug
Get a Site Deploy	GET	/sites/{{siteId}}/deploys/{{deployId}}	conn_mod_def::GJ5BNH9AY5g::Xulk3DVFT8y7RAVHbdPaYQ
List a Site’s Deploys	GET	/sites/{{siteId}}/deploys	conn_mod_def::GJ5BNhBR864::LQxDsUUZTpCw4g-A0puhng
Cancel a Site Deploy	POST	/deploys/{{deployId}}/cancel	conn_mod_def::GJ5BM7gBa78::2lDXWxoLSAO_VENjKkVP0A
Create a Site Deploy	POST	/sites/{{siteId}}/deploys	conn_mod_def::GJ5BNKCPGL0::BleJube2SSi0hNuBEglgVQ
Delete a Deploy	DELETE	/deploys/{{deployId}}	conn_mod_def::GJ5BNHU-Ft0::cH7TSlbZTXSd9nJUnwCaIw
Delete a Site Deploy	DELETE	/sites/{{siteId}}/deploys/{{deployId}}	conn_mod_def::GJ5BNSE2_DE::8E5FFCPpQrCRcD-7I9OV3Q
Lock a Deploy	POST	/deploys/{{deployId}}/lock	conn_mod_def::GJ5BNbTuKW4::jDcmmfhCSZWaJI6A9GhSxw
Restore a Site Deploy	POST	/sites/{{siteId}}/deploys/{{deployId}}/restore	conn_mod_def::GJ5BNZRyilE::xaNbWnXxTxKiWLQpNqzxvA
Unlock a Deploy	POST	/deploys/{{deployId}}/unlock	conn_mod_def::GJ5BNaB6Sdw::C8YrxmPQTlONK64_dlL8mg
Update a Site’s Deploy	PUT	/sites/{{siteId}}/deploys/{{deployId}}	conn_mod_def::GJ5BNq94u40::u6VYXPTeRg-Yi1Jefwi6Yw

AgentRunners

Action	Method	Path	Action id
Get an Agent Runner	GET	/agent_runners/{{agentRunnerId}}	conn_mod_def::GJ5BL45z_co::4A1n-GvBRQyvpwRO0C9vUg
List Agent Runners	GET	/agent_runners	conn_mod_def::GJ5BL-u-JCM::5FsDTREHTiyl9tWEgOmgjA
Archive an Agent Runner	POST	/agent_runners/{{agentRunnerId}}/archive	conn_mod_def::GJ5BLqy5vx8::UatZv6ZFQhePCku0Imb2IQ
Create an Agent Runner	POST	/api/v1/agent_runners	conn_mod_def::GJ5BLuHS_ag::7ksCd2PySwCaV5LRej-m5w
Delete an Agent Runner	DELETE	/agent_runners/{{agentRunnerId}}	conn_mod_def::GJ5BLq0mFXA::Rdo8ajEjRheumNsyjbrBwQ
Update an Agent Runner	PATCH	/agent_runners/{{agentRunnerId}}	conn_mod_def::GJ5BL5dsW2I::94ZnQMn5TeqIjleaNTXf5A

Hooks

Action	Method	Path	Action id
Get a Hook	GET	/hooks/{{hookId}}	conn_mod_def::GJ5BPE_Sa5w::QDwdqN4IR6OeMs5lTNLFTQ
List a Site’s Hooks	GET	/hooks	conn_mod_def::GJ5BPFnG6eQ::vHFDWs-HREqlfU_mJ6fptQ
Create a Hook for a Site	POST	/hooks	conn_mod_def::GJ5BO9q5Tkc::qULS1xsATvi3QHBUkD2urg
Delete a Hook	DELETE	/hooks/{{hookId}}	conn_mod_def::GJ5BO8EiBFo::-VwmSnYdQDqtElGtDuHXBQ
Enable a Hook	POST	/hooks/{{hookId}}/enable	conn_mod_def::GJ5BO8-0WBw::ys3Gs5X1Tju4NMDoodryRw
Update a Hook	PUT	/hooks/{{hookId}}	conn_mod_def::GJ5BPFLrCmM::z8bFYYqMQEaC8MJcEQc9mQ

TrafficSplits

Action	Method	Path	Action id
Get a Site’s Traffic Split Test	GET	/sites/{{siteId}}/traffic_splits/{{splitTestId}}	conn_mod_def::GJ5BQVCJB3Q::zFqCZoPmRTe-0IYlq1Hcjg
List a Site’s Traffic Split Tests	GET	/sites/{{siteId}}/traffic_splits	conn_mod_def::GJ5BQU5XXNo::a1z9y4cKRCiRRAAuk55TXg
Create a Site Traffic Split Test	POST	/sites/{{siteId}}/traffic_splits	conn_mod_def::GJ5BQMlkel4::jvHeHqOCTCi3JX27Bja06A
Disable a Site’s Split Test (Unpublish Traffic Split)	POST	/sites/{{siteId}}/traffic_splits/{{splitTestId}}/unpublish	conn_mod_def::GJ5BQaqQ17E::TN0qCyaZSQSlzyTz2-B-Uw
Enable a Site’s Traffic Split Test (Publish)	POST	/sites/{{siteId}}/traffic_splits/{{splitTestId}}/publish	conn_mod_def::GJ5BQUgqKxQ::7ukQfEQzTP6gKr2ISBQl-g
Update a Site’s Traffic Split Test	PUT	/sites/{{siteId}}/traffic_splits/{{splitTestId}}	conn_mod_def::GJ5BQUntYgc::cKEPWTnvSN6l4ZAzru3KDQ

Accounts

Action	Method	Path	Action id
Get an Account	GET	/accounts/{{accountId}}	conn_mod_def::GJ5BLiajL4g::dNr87XXYQ321zmbAJQyTeA
List Accounts for the Authenticated User	GET	/accounts	conn_mod_def::GJ5BLjACo9w::OTWsClazRmqGBD3u9dH9Ow
Cancel an Account	DELETE	/accounts/{{accountId}}	conn_mod_def::GJ5BLiLk7yI::6KjoeLjnTQmQC2tP7l7CyQ
Create Account	POST	/api/v1/accounts	conn_mod_def::GJ5BLiS-958::IMJRZkFXRJCJycin10zaAw
Update an Account	PUT	/accounts/{{accountId}}	conn_mod_def::GJ5BLquMdGk::udWNOsOgSGaRfCISlJLQ4g

AgentRunnerSessions

Action	Method	Path	Action id
Get an Agent Runner Session	GET	/agent_runners/{{agentRunnerId}}/sessions/{{agentRunnerSessionId}}	conn_mod_def::GJ5BMGhm5XA::Kj6kVLWyTwqWaUr-my6qqg
List an Agent Runner’s Sessions	GET	/agent_runners/{{agentRunnerId}}/sessions	conn_mod_def::GJ5BMIO4v_Y::nbdlubJqSkOD0S2NAAvk1A
Create an Agent Runner Session	POST	/agent_runners/{{agentRunnerId}}/sessions	conn_mod_def::GJ5BL9Gc57g::1s3_tFStQnSX8--ca9ofrw
Delete an Agent Runner Session	DELETE	/agent_runners/{{agentRunnerId}}/sessions/{{agentRunnerSessionId}}	conn_mod_def::GJ5BL5Nb460::GowRcikUQNqzksg7lT79dw
Update an Agent Runner Session	PATCH	/agent_runners/{{agentRunnerId}}/sessions/{{agentRunnerSessionId}}	conn_mod_def::GJ5BMKtMaL0::q-sCeiTVT1Wv21KO-lAz5A

SiteAssets

Action	Method	Path	Action id
Get a Site Asset's Info	GET	/sites/{{siteId}}/assets/{{assetId}}	conn_mod_def::GJ5BMSOq1eI::7x1YV4ZCScy9gWogpbKXUg
Get a Site Asset’s Public Signature	GET	/sites/{{siteId}}/assets/{{assetId}}/public_signature	conn_mod_def::GJ5BMlOnoy4::pJbhVd2cT4CmV88_yJFMGA
Create a Site Asset	POST	/sites/{{siteId}}/assets	conn_mod_def::GJ5BMS1WLDQ::rSBLqafSStmqrxlMCOHrqw
Delete a Site Asset	DELETE	/sites/{{siteId}}/assets/{{assetId}}	conn_mod_def::GJ5BMdmxTjA::c0L6AFqDSyeYMOdY9MbZiw
Update a Site Asset	PUT	/sites/{{siteId}}/assets/{{assetId}}	conn_mod_def::GJ5BMoN3Hvg::HanKpQgPQv68d8apwwZgPA

BuildHooks

Action	Method	Path	Action id
Get a Site’s Build Hook	GET	/sites/{{siteId}}/build_hooks/{{id}}	conn_mod_def::GJ5BNASfidU::vUYztyuBS_u6un51xhsKCQ
List a Site’s Build Hooks	GET	/sites/{{siteId}}/build_hooks	conn_mod_def::GJ5BM7G9PS0::0jUT_SQwQLqUBcNyBRVivg
Create a Site Build Hook	POST	/sites/{{siteId}}/build_hooks	conn_mod_def::GJ5BMz487UE::o_tbgWd6RMKuXFWP2agnww
Delete a Site Build Hook	DELETE	/sites/{{siteId}}/build_hooks/{{id}}	conn_mod_def::GJ5BMyo_-5k::64Mf9uDDR-GYrmPygoqcgw
Update a Site’s Build Hook	PUT	/sites/{{siteId}}/build_hooks/{{id}}	conn_mod_def::GJ5BM7Xwczs::qKqv6Lg8QA-y12J0kM1jBA

DevServers

Action	Method	Path	Action id
Get a Site’s Dev Server	GET	/sites/{{siteId}}/dev_servers/{{devServerId}}	conn_mod_def::GJ5BN32bmjA::bJCJtwCiRyGIYso21Jk-Wg
List a Site’s Dev Servers	GET	/sites/{{siteId}}/dev_servers	conn_mod_def::GJ5BN7O6nng::twQtZFtbTXuRZpoRmiWkjA
Create a Site Dev Server	POST	/sites/{{siteId}}/dev_servers	conn_mod_def::GJ5BN4NuDl0::KeLtGE_kTr6thGTv-42H6w
Delete a Site’s Dev Servers	DELETE	/sites/{{siteId}}/dev_servers	conn_mod_def::GJ5BN8Ck8DI::mEg3aHqqSqekw-08YqOyyg
Update a Site Dev Server’s State	POST	/sites/{{siteId}}/dev_servers/{{devServerId}}/state	conn_mod_def::GJ5BOF89PSw::3EQLChusSKqBrZkOPeNG1A

DevServerHooks

Action	Method	Path	Action id
Get a Site’s Dev Server Hook	GET	/sites/{{siteId}}/dev_server_hooks/{{id}}	conn_mod_def::GJ5BOEmO3rU::5QLaOpP3RIaqfDMkqO8vcw
List a Site’s Dev Server Hooks	GET	/sites/{{siteId}}/dev_server_hooks	conn_mod_def::GJ5BOFd6R9c::8QHF3U8nS-2-tcwYniRItg
Create a Site Dev Server Hook	POST	/sites/{{siteId}}/dev_server_hooks	conn_mod_def::GJ5BOGJoPZA::xX0tZ6oISseD_o8254_CTA
Delete a Site’s Dev Server Hook	DELETE	/sites/{{siteId}}/dev_server_hooks/{{id}}	conn_mod_def::GJ5BOGww7j0::ABloXb8FRzupxccexoVy3A
Update a Site’s Dev Server Hook	PUT	/sites/{{siteId}}/dev_server_hooks/{{id}}	conn_mod_def::GJ5BOOZiDPY::B1uXVkFxRHKE41ezj8p17w

DnsZones

Action	Method	Path	Action id
Get a DNS Zone	GET	/dns_zones/{{zoneId}}	conn_mod_def::GJ5BOb0bpEE::Sh4V_MEXQ3anQpEP_YQJ-g
List DNS Zones	GET	/dns_zones	conn_mod_def::GJ5BOW4QqZw::oQQ8ZvqoQZSYESsF0q1BYA
Create a DNS Zone	POST	/dns_zones	conn_mod_def::GJ5BOOH2-sI::H1C3zQX0TvGNao8uSn9f1A
Delete a DNS Zone	DELETE	/dns_zones/{{zoneId}}	conn_mod_def::GJ5BOW90TCI::-X5w3pfxQe6zd7z3HzxE_g
Transfer a DNS Zone to Another Account or User	PUT	/dns_zones/{{zoneId}}/transfer	conn_mod_def::GJ5BOklttOk::MY-jMyEeQs2ida3pQeobeA

Builds

Action	Method	Path	Action id
Get a Site Build	GET	/builds/{{buildId}}	conn_mod_def::GJ5BMvbxIZk::wxE5og6FT5Sob990i_8gIg
List a Site’s Builds	GET	/sites/{{siteId}}/builds	conn_mod_def::GJ5BMyrQ19E::P0FBHSj9Tq2cFN5le0p5jg
Notify a Build's Start	POST	/builds/{{buildId}}/start	conn_mod_def::GJ5BMwY0AZM::yV5JvGTeSDSpjGp6oOdSzw
Run a Site Build	POST	/sites/{{siteId}}/builds	conn_mod_def::GJ5BMmwM68c::IxAx0DFtR3uWo9KBAL3etw

DeployKeys

Action	Method	Path	Action id
Get a Deploy Key	GET	/deploy_keys/{{keyId}}	conn_mod_def::GJ5BNwPbw0Q::F8Q9_-RBRvqHTuAuqr2Xfg
List Deploy Keys	GET	/deploy_keys	conn_mod_def::GJ5BN5kBGWU::ofABgZGIS3qIQMUwnagrfQ
Create a Deploy Key	POST	/api/v1/deploy_keys	conn_mod_def::GJ5BNuFFC5c::6GHR6Y7zTN2DNxhC0ycc1w
Delete a Deploy Key	DELETE	/deploy_keys/{{keyId}}	conn_mod_def::GJ5BNo-j8Cw::u0UX1c8OTwOPVfTQDtnp_w

DnsRecords

Action	Method	Path	Action id
Get an Individual DNS Record in a DNS Zone	GET	/dns_zones/{{zoneId}}/dns_records/{{dnsRecordId}}	conn_mod_def::GJ5BOkO_JXw::jNXpg2CzRvWSeQenRWHxEA
List a DNS Zone’s DNS Records	GET	/dns_zones/{{zoneId}}/dns_records	conn_mod_def::GJ5BOXjpNco::TBgHeTpwTtSL_bx5ipS7QQ
Create a DNS Record in a DNS Zone	POST	/dns_zones/{{zoneId}}/dns_records	conn_mod_def::GJ5BOQASC4A::znzONZvzRmKb2wyQXBKTgQ
Delete a DNS Record in a DNS Zone	DELETE	/dns_zones/{{zoneId}}/dns_records/{{dnsRecordId}}	conn_mod_def::GJ5BOOJ8e28::WoVFsrLQTJim6sC5Hqewsw

AccountEnvironmentVariables

Action	Method	Path	Action id
Get an Account Environment Variable	GET	/accounts/{{accountId}}/env/{{key}}	conn_mod_def::GJ5BOtaD-zw::BFkEu-guR9qT7Dec6ROcWQ
List an Account’s Environment Variables	GET	/accounts/{{accountId}}/env	conn_mod_def::GJ5BOsfhqAw::mp3pqIfYQFG-mowGTDPtsg

2 more AccountEnvironmentVariables actions are available through search.

This lists 90 of 147 actions. For anything not here, call search_one_platform_actions with platform netlify. The full catalog is at https://www.withone.ai/knowledge/netlify.

When a call fails

The error comes from Netlify, not from One. A 400 or 422 means your parameters do not match the schema, so re-read the knowledge and fix the field. A 401 or 403 means the connection needs re-authorizing, which no retry will fix. A 404 means the id is not on this account. A 429 means slow down. Never retry a write more than once: the first attempt may have landed.

Full catalog: https://www.withone.ai/knowledge/netlify

Integration knowledge by One (withone.ai), licensed under One-Knowledge-1.0. Attribution must be preserved in derivative works.