Development — entry 059 of 98

Netlify

Verified Jul 2026

The Netlify API manages sites, deploys, builds, DNS, and forms through a single REST host (`api.netlify.com`) using OAuth2 or personal access tokens, with a full OpenAPI/Swagger reference published alongside the guides. Netlify moved to credit-based pricing in September 2025: a free tier covers 300 monthly credits, with paid Personal, Pro, and Enterprise plans scaling credits and features above that.

hostingdeploymentjamstackdevops

Visit netlify.com ↗Read the docs ↗Pricing ↗Status ↗More Development

AuthenticationOAuthRequires an OAuth flow; expect app registration.

HTTPSSupportedTraffic is encrypted in transit.

CORSEnabledCallable directly from browser JavaScript.

PricingFreemiumA usable free tier exists, with paid plans for more volume.

FormatsJSONResponses can be requested as JSON.

GreatAPIs Score

Score74out of 100

Authentication8/25OAuth flow required

Pricing17/20Freemium tier available

Docs20/20Machine-readable spec file bundled

Formats9/15Single response format

Freshness20/20Verified within 6 months

Embed this badge

<a href="https://greatapis.com/api/netlify/"><img src="https://greatapis.com/badge/netlify.svg" alt="Scored 74 on greatapis.com"></a>

Auth quickstart

Register an app / run the OAuth flow to obtain a bearer token.
Send it as an Authorization headerAuthorization: Bearer <token>

Stored keyNo key stored

Your key is stored only in this browser (localStorage) and sent directly to the API — never to greatapis.

Endpoints

Servers

https://api.netlify.com/api/v1

Auth

netlifyAuth

ticket2

POST/oauth/tickets

Parameters

Name	In	Required	Type
`client_id`	query	yes	string

Request body

application/json

Responses

Status	Description	Schema
`201`	Created	—
`401`	OAuth application not found	—
`422`	Validation error	—
`default`	error	—

GET/oauth/tickets/{ticket_id}

Parameters

Name	In	Required	Type
`ticket_id`	path	yes	string

Responses

Status	Description	Schema
`200`	ok	—
`default`	error	—

accessToken1

POST/oauth/tickets/{ticket_id}/exchange

Parameters

Name	In	Required	Type
`ticket_id`	path	yes	string

Responses

Status	Description	Schema
`201`	ok	—
`default`	error	—

user1

GET/user

Responses

Status	Description	Schema
`200`	OK	—
`default`	error	—

accountMembership5

GET/accounts

Parameters

Name	In	Required	Type
`minimal`	query	no	boolean

Responses

Status	Description	Schema
`200`	OK	—
`default`	error	—

POST/accounts

Request body

application/json (required)

Responses

Status	Description	Schema
`201`	Created	—
`default`	error	—

GET/accounts/{account_id}

Parameters

Name	In	Required	Type
`account_id`	path	yes	string

Responses

Status	Description	Schema
`200`	OK	—
`default`	error	—

PUT/accounts/{account_id}

Parameters

Name	In	Required	Type
`account_id`	path	yes	string

Request body

application/json

Responses

Status	Description	Schema
`200`	OK	—
`default`	error	—

DELETE/accounts/{account_id}

Parameters

Name	In	Required	Type
`account_id`	path	yes	string

Responses

Status	Description	Schema
`204`	Not Content	—
`default`	error	—

member5

GET/{account_slug}/members

Parameters

Name	In	Required	Type
`account_slug`	path	yes	string

Responses

Status	Description	Schema
`200`	OK	—
`default`	error	—

POST/{account_slug}/members

Parameters

Name	In	Required	Type
`account_slug`	path	yes	string

Request body

application/json (required)

Responses

Status	Description	Schema
`200`	OK	—
`default`	error	—

GET/{account_slug}/members/{member_id}

Parameters

Name	In	Required	Type
`account_slug`	path	yes	string
`member_id`	path	yes	string

Responses

Status	Description	Schema
`200`	OK	—
`default`	error	—

PUT/{account_slug}/members/{member_id}

Parameters

Name	In	Required	Type
`account_slug`	path	yes	string
`member_id`	path	yes	string

Request body

application/json (required)

Responses

Status	Description	Schema
`200`	OK	—
`default`	error	—

DELETE/{account_slug}/members/{member_id}

Parameters

Name	In	Required	Type
`account_slug`	path	yes	string
`member_id`	path	yes	string

Responses

Status	Description	Schema
`204`	Not Content	—
`default`	error	—

accountType1

GET/accounts/types

Responses

Status	Description	Schema
`200`	OK	—
`default`	error	—

paymentMethod1

GET/billing/payment_methods

Responses

Status	Description	Schema
`200`	OK	—
`default`	error	—

auditLog1

GET/accounts/{account_id}/audit

Parameters

Name	In	Required	Type
`account_id`	path	yes	string
`query`	query	no	string
`log_type`	query	no	string
`page`	query	no	integer
`per_page`	query	no	integer

Responses

Status	Description	Schema
`200`	OK	—
`default`	error	—

site10

GET/sites

Parameters

Name	In	Required	Type
`name`	query	no	string
`filter`	query	no	string
`page`	query	no	integer
`per_page`	query	no	integer

Responses

Status	Description	Schema
`200`	OK	—
`default`	error	—

POST/sites

Parameters

Name	In	Required	Type
`configure_dns`	query	no	boolean

Request body

application/json (required)

Responses

Status	Description	Schema
`201`	Created	—
`default`	error	—

GET/sites/{site_id}

Parameters

Name	In	Required	Type
`site_id`	path	yes	string
`feature_flags`	query	no	string

Responses

Status	Description	Schema
`200`	OK	—
`default`	error	—

PATCH/sites/{site_id}

Parameters

Name	In	Required	Type
`site_id`	path	yes	string

Request body

application/json (required)

Responses

Status	Description	Schema
`200`	OK	—
`default`	error	—

DELETE/sites/{site_id}

Parameters

Name	In	Required	Type
`site_id`	path	yes	string

Responses

Status	Description	Schema
`204`	Deleted	—
`default`	error	—

PUT/sites/{site_id}/disable

Parameters

Name	In	Required	Type
`site_id`	path	yes	string
`reason`	query	yes	string

Responses

Status	Description	Schema
`204`	No content	—
`default`	error	—

PUT/sites/{site_id}/enable

Parameters

Name	In	Required	Type
`site_id`	path	yes	string

Responses

Status	Description	Schema
`204`	No content	—
`422`	Cannot enable this site	—
`default`	error	—

PUT/sites/{site_id}/unlink_repo

Parameters

Name	In	Required	Type
`site_id`	path	yes	string

Responses

Status	Description	Schema
`200`	OK	—
`404`	Site not found	—

GET/{account_slug}/sites

Parameters

Name	In	Required	Type
`name`	query	no	string
`account_slug`	path	yes	string
`page`	query	no	integer
`per_page`	query	no	integer

Responses

Status	Description	Schema
`200`	OK	—
`default`	error	—

POST/{account_slug}/sites

Parameters

Name	In	Required	Type
`configure_dns`	query	no	boolean
`account_slug`	path	yes	string

Request body

application/json

Responses

Status	Description	Schema
`201`	Created	—
`default`	error	—

environmentVariables8

GET/accounts/{account_id}/env

Parameters

Name	In	Required	Type
`account_id`	path	yes	string
`context_name`	query	no	string
`scope`	query	no	string
`site_id`	query	no	string

Responses

Status	Description	Schema
`200`	OK	—
`default`	error	—

POST/accounts/{account_id}/env

Parameters

Name	In	Required	Type
`account_id`	path	yes	string
`site_id`	query	no	string

Request body

application/json

Responses

Status	Description	Schema
`201`	OK	—
`default`	error	—

GET/accounts/{account_id}/env/{key}

Parameters

Name	In	Required	Type
`account_id`	path	yes	string
`key`	path	yes	string
`site_id`	query	no	string

Responses

Status	Description	Schema
`200`	OK	—
`default`	error	—

PUT/accounts/{account_id}/env/{key}

Parameters

Name	In	Required	Type
`account_id`	path	yes	string
`key`	path	yes	string
`site_id`	query	no	string

Request body

application/json

Responses

Status	Description	Schema
`200`	OK	—
`default`	error	—

PATCH/accounts/{account_id}/env/{key}

Parameters

Name	In	Required	Type
`account_id`	path	yes	string
`key`	path	yes	string
`site_id`	query	no	string

Request body

application/json

Responses

Status	Description	Schema
`201`	Created (success)	—
`default`	error	—

DELETE/accounts/{account_id}/env/{key}

Parameters

Name	In	Required	Type
`account_id`	path	yes	string
`key`	path	yes	string
`site_id`	query	no	string

Responses

Status	Description	Schema
`204`	No Content (success)	—
`default`	error	—

DELETE/accounts/{account_id}/env/{key}/value/{id}

Parameters

Name	In	Required	Type
`account_id`	path	yes	string
`id`	path	yes	string
`key`	path	yes	string
`site_id`	query	no	string

Responses

Status	Description	Schema
`204`	No Content (success)	—
`default`	error	—

GET/api/v1/sites/{site_id}/env

Parameters

Name	In	Required	Type
`context_name`	query	no	string
`scope`	query	no	string
`site_id`	path	yes	string

Responses

Status	Description	Schema
`200`	OK	—
`default`	error	—

file3

PUT/deploys/{deploy_id}/files/{path}

Parameters

Name	In	Required	Type
`deploy_id`	path	yes	string
`path`	path	yes	string
`size`	query	no	integer

Request body

application/json (required)

Responses

Status	Description	Schema
`200`	OK	—
`default`	error	—

GET/sites/{site_id}/files

Parameters

Name	In	Required	Type
`site_id`	path	yes	string

Responses

Status	Description	Schema
`200`	OK	—
`default`	error	—

GET/sites/{site_id}/files/{file_path}

Parameters

Name	In	Required	Type
`site_id`	path	yes	string
`file_path`	path	yes	string

Responses

Status	Description	Schema
`200`	OK	—
`default`	error	—

metadata2

GET/sites/{site_id}/metadata

Parameters

Name	In	Required	Type
`site_id`	path	yes	string

Responses

Status	Description	Schema
`200`	OK	—
`default`	error	—

PUT/sites/{site_id}/metadata

Parameters

Name	In	Required	Type
`site_id`	path	yes	string

Request body

application/json (required)

Responses

Status	Description	Schema
`204`	No content	—
`default`	error	—

snippet5

GET/sites/{site_id}/snippets

Parameters

Name	In	Required	Type
`site_id`	path	yes	string

Responses

Status	Description	Schema
`200`	OK	—
`default`	error	—

POST/sites/{site_id}/snippets

Parameters

Name	In	Required	Type
`site_id`	path	yes	string

Request body

application/json (required)

Responses

Status	Description	Schema
`201`	OK	—
`default`	error	—

GET/sites/{site_id}/snippets/{snippet_id}

Parameters

Name	In	Required	Type
`site_id`	path	yes	string
`snippet_id`	path	yes	string

Responses

Status	Description	Schema
`200`	OK	—
`default`	error	—

PUT/sites/{site_id}/snippets/{snippet_id}

Parameters

Name	In	Required	Type
`site_id`	path	yes	string
`snippet_id`	path	yes	string

Request body

application/json (required)

Responses

Status	Description	Schema
`204`	No content	—
`default`	error	—

DELETE/sites/{site_id}/snippets/{snippet_id}

Parameters

Name	In	Required	Type
`site_id`	path	yes	string
`snippet_id`	path	yes	string

Responses

Status	Description	Schema
`204`	No content	—
`default`	error	—

purge1

POST/purge

Request body

application/json (required)

Responses

Status	Description	Schema
`202`	OK	—
`400`	Invalid request parameters	—
`404`	Site not found	—

dnsZone11

GET/dns_zones

Parameters

Name	In	Required	Type
`account_slug`	query	no	string

Responses

Status	Description	Schema
`200`	get all DNS zones the user has access to	—
`default`	error	—

POST/dns_zones

Request body

application/json (required)

Responses

Status	Description	Schema
`201`	Created	—
`default`	error	—

GET/dns_zones/{zone_id}

Parameters

Name	In	Required	Type
`zone_id`	path	yes	string

Responses

Status	Description	Schema
`200`	get a single DNS zone	—
`default`	error	—

DELETE/dns_zones/{zone_id}

Parameters

Name	In	Required	Type
`zone_id`	path	yes	string

Responses

Status	Description	Schema
`204`	delete a single DNS zone	—
`default`	error	—

GET/dns_zones/{zone_id}/dns_records

Parameters

Name	In	Required	Type
`zone_id`	path	yes	string

Responses

Status	Description	Schema
`200`	get all DNS records for a single DNS zone	—
`default`	error	—

POST/dns_zones/{zone_id}/dns_records

Parameters

Name	In	Required	Type
`zone_id`	path	yes	string

Request body

application/json (required)

Responses

Status	Description	Schema
`201`	Created	—
`default`	error	—

GET/dns_zones/{zone_id}/dns_records/{dns_record_id}

Parameters

Name	In	Required	Type
`zone_id`	path	yes	string
`dns_record_id`	path	yes	string

Responses

Status	Description	Schema
`200`	get a single DNS record	—
`default`	error	—

DELETE/dns_zones/{zone_id}/dns_records/{dns_record_id}

Parameters

Name	In	Required	Type
`zone_id`	path	yes	string
`dns_record_id`	path	yes	string

Responses

Status	Description	Schema
`204`	record deleted	—
`default`	error	—

PUT/dns_zones/{zone_id}/transfer

Parameters

Name	In	Required	Type
`zone_id`	path	yes	string
`account_id`	query	yes	string
`transfer_account_id`	query	yes	string
`transfer_user_id`	query	yes	string

Responses

Status	Description	Schema
`200`	transfer a DNS zone to another account	—
`default`	error	—

GET/sites/{site_id}/dns

Parameters

Name	In	Required	Type
`site_id`	path	yes	string

Responses

Status	Description	Schema
`200`	OK	—
`default`	error	—

PUT/sites/{site_id}/dns

Parameters

Name	In	Required	Type
`site_id`	path	yes	string

Responses

Status	Description	Schema
`200`	OK	—
`default`	error	—

sniCertificate3

GET/sites/{site_id}/ssl

Parameters

Name	In	Required	Type
`site_id`	path	yes	string

Responses

Status	Description	Schema
`200`	OK	—
`default`	error	—

POST/sites/{site_id}/ssl

Parameters

Name	In	Required	Type
`site_id`	path	yes	string
`certificate`	query	no	string
`key`	query	no	string
`ca_certificates`	query	no	string

Responses

Status	Description	Schema
`200`	OK	—
`422`	Unprocessable Entity. Returns errors such as: "certificate parameter is required when updating an existing certificate" (when updating without params), "No custom domain configured", or "bad dns for custom domain"	—
`default`	error	—

GET/sites/{site_id}/ssl/certificates

Parameters

Name	In	Required	Type
`site_id`	path	yes	string
`domain`	query	yes	string

Responses

Status	Description	Schema
`200`	Array of SNI Certificates	—
`404`	Not Found	—
`422`	Unprocessable Entity	—

deploy13

GET/deploys/{deploy_id}

Parameters

Name	In	Required	Type
`deploy_id`	path	yes	string

Responses

Status	Description	Schema
`200`	OK	—
`default`	error	—

DELETE/deploys/{deploy_id}

Parameters

Name	In	Required	Type
`deploy_id`	path	yes	string

Responses

Status	Description	Schema
`204`	No content	—
`default`	error	—

POST/deploys/{deploy_id}/cancel

Parameters

Name	In	Required	Type
`deploy_id`	path	yes	string

Responses

Status	Description	Schema
`201`	Cancelled	—
`default`	error	—

POST/deploys/{deploy_id}/lock

Parameters

Name	In	Required	Type
`deploy_id`	path	yes	string

Responses

Status	Description	Schema
`200`	OK	—
`default`	error	—

POST/deploys/{deploy_id}/unlock

Parameters

Name	In	Required	Type
`deploy_id`	path	yes	string

Responses

Status	Description	Schema
`200`	OK	—
`default`	error	—

PATCH/deploys/{deploy_id}/validations_report

Parameters

Name	In	Required	Type
`deploy_id`	path	yes	string

Request body

application/json (required)

Responses

Status	Description	Schema
`200`	OK	—

GET/sites/{site_id}/deploys

Parameters

Name	In	Required	Type
`site_id`	path	yes	string
`deploy-previews`	query	no	boolean
`production`	query	no	boolean
`state`	query	no	string
`branch`	query	no	string
`latest-published`	query	no	boolean
`page`	query	no	integer
`per_page`	query	no	integer

Responses

Status	Description	Schema
`200`	OK	—
`default`	error	—

POST/sites/{site_id}/deploys

Parameters

Name	In	Required	Type
`site_id`	path	yes	string
`deploy-previews`	query	no	boolean
`production`	query	no	boolean
`state`	query	no	string
`branch`	query	no	string
`latest-published`	query	no	boolean
`title`	query	no	string

Request body

application/json (required)

Responses

Status	Description	Schema
`200`	OK	—
`default`	error	—

GET/sites/{site_id}/deploys/{deploy_id}

Parameters

Name	In	Required	Type
`site_id`	path	yes	string
`deploy_id`	path	yes	string

Responses

Status	Description	Schema
`200`	OK	—
`default`	error	—

PUT/sites/{site_id}/deploys/{deploy_id}

Parameters

Name	In	Required	Type
`site_id`	path	yes	string
`deploy_id`	path	yes	string
`commit_ref`	query	no	string

Request body

application/json (required)

Responses

Status	Description	Schema
`200`	OK	—
`default`	error	—

DELETE/sites/{site_id}/deploys/{deploy_id}

Parameters

Name	In	Required	Type
`deploy_id`	path	yes	string
`site_id`	path	yes	string

Responses

Status	Description	Schema
`204`	No content	—
`default`	error	—

POST/sites/{site_id}/deploys/{deploy_id}/restore

Parameters

Name	In	Required	Type
`site_id`	path	yes	string
`deploy_id`	path	yes	string

Responses

Status	Description	Schema
`201`	Created	—
`default`	error	—

PUT/sites/{site_id}/rollback

Parameters

Name	In	Required	Type
`site_id`	path	yes	string

Responses

Status	Description	Schema
`204`	No content	—
`default`	error	—

deployedBranch1

GET/sites/{site_id}/deployed-branches

Parameters

Name	In	Required	Type
`site_id`	path	yes	string

Responses

Status	Description	Schema
`200`	OK	—
`default`	error	—

deployKey4

GET/deploy_keys

Responses

Status	Description	Schema
`200`	OK	—
`default`	error	—

POST/deploy_keys

Responses

Status	Description	Schema
`201`	Created	—
`default`	error	—

GET/deploy_keys/{key_id}

Parameters

Name	In	Required	Type
`key_id`	path	yes	string

Responses

Status	Description	Schema
`200`	OK	—
`default`	error	—

DELETE/deploy_keys/{key_id}

Parameters

Name	In	Required	Type
`key_id`	path	yes	string

Responses

Status	Description	Schema
`204`	Not Content	—
`default`	error	—

build5

GET/builds/{build_id}

Parameters

Name	In	Required	Type
`build_id`	path	yes	string

Responses

Status	Description	Schema
`200`	OK	—
`default`	error	—

POST/builds/{build_id}/start

Parameters

Name	In	Required	Type
`build_id`	path	yes	string
`buildbot_version`	query	no	string
`build_version`	query	no	string
`task_id`	query	no	string

Responses

Status	Description	Schema
`204`	No content	—
`default`	error	—

GET/sites/{site_id}/builds

Parameters

Name	In	Required	Type
`site_id`	path	yes	string
`page`	query	no	integer
`per_page`	query	no	integer

Responses

Status	Description	Schema
`200`	OK	—
`default`	error	—

POST/sites/{site_id}/builds

Parameters

Name	In	Required	Type
`site_id`	path	yes	string
`branch`	query	no	string
`clear_cache`	query	no	boolean
`image`	query	no	string
`template_id`	query	no	string
`title`	query	no	string

Responses

Status	Description	Schema
`200`	OK	—
`400`	Bad Request	—
`404`	Not Found	—
`422`	Unprocessable Entity	—
`default`	error	—

GET/{account_id}/builds/status

Parameters

Name	In	Required	Type
`account_id`	path	yes	string

Responses

Status	Description	Schema
`200`	OK	—
`default`	error	—

buildLogMsg1

POST/builds/{build_id}/log

Parameters

Name	In	Required	Type
`build_id`	path	yes	string

Request body

application/json (required)

Responses

Status	Description	Schema
`204`	No content	—
`default`	error	—

hook6

GET/hooks

Parameters

Name	In	Required	Type
`site_id`	query	yes	string

Responses

Status	Description	Schema
`200`	OK	—
`default`	error	—

POST/hooks

Parameters

Name	In	Required	Type
`site_id`	query	yes	string

Request body

application/json (required)

Responses

Status	Description	Schema
`201`	OK	—
`default`	error	—

GET/hooks/{hook_id}

Parameters

Name	In	Required	Type
`hook_id`	path	yes	string

Responses

Status	Description	Schema
`200`	OK	—
`default`	error	—

PUT/hooks/{hook_id}

Parameters

Name	In	Required	Type
`hook_id`	path	yes	string

Request body

application/json (required)

Responses

Status	Description	Schema
`200`	OK	—
`default`	error	—

DELETE/hooks/{hook_id}

Parameters

Name	In	Required	Type
`hook_id`	path	yes	string

Responses

Status	Description	Schema
`204`	No content	—

POST/hooks/{hook_id}/enable

Parameters

Name	In	Required	Type
`hook_id`	path	yes	string

Responses

Status	Description	Schema
`200`	OK	—
`default`	error	—

hookType1

GET/hooks/types

Responses

Status	Description	Schema
`200`	OK	—
`default`	error	—

buildHook5

GET/sites/{site_id}/build_hooks

Parameters

Name	In	Required	Type
`site_id`	path	yes	string

Responses

Status	Description	Schema
`200`	OK	—
`default`	error	—

POST/sites/{site_id}/build_hooks

Parameters

Name	In	Required	Type
`site_id`	path	yes	string

Request body

application/json (required)

Responses

Status	Description	Schema
`201`	Created	—
`default`	error	—

GET/sites/{site_id}/build_hooks/{id}

Parameters

Name	In	Required	Type
`site_id`	path	yes	string
`id`	path	yes	string

Responses

Status	Description	Schema
`200`	OK	—
`default`	error	—

PUT/sites/{site_id}/build_hooks/{id}

Parameters

Name	In	Required	Type
`site_id`	path	yes	string
`id`	path	yes	string

Request body

application/json (required)

Responses

Status	Description	Schema
`204`	No content	—
`default`	error	—

DELETE/sites/{site_id}/build_hooks/{id}

Parameters

Name	In	Required	Type
`site_id`	path	yes	string
`id`	path	yes	string

Responses

Status	Description	Schema
`204`	No content	—
`default`	error	—

service3

GET/services/

Parameters

Name	In	Required	Type
`search`	query	no	string

Responses

Status	Description	Schema
`200`	services	—
`default`	error	—

GET/services/{addonName}

Parameters

Name	In	Required	Type
`addonName`	path	yes	string

Responses

Status	Description	Schema
`200`	services	—
`default`	error	—

GET/services/{addonName}/manifest

Parameters

Name	In	Required	Type
`addonName`	path	yes	string

Responses

Status	Description	Schema
`201`	retrieving from provider	—
`default`	error	—

serviceInstance5

GET/sites/{site_id}/service-instances

Parameters

Name	In	Required	Type
`site_id`	path	yes	string

Responses

Status	Description	Schema
`200`	OK	—
`default`	error	—

POST/sites/{site_id}/services/{addon}/instances

Parameters

Name	In	Required	Type
`site_id`	path	yes	string
`addon`	path	yes	string

Request body

application/json (required)

Responses

Status	Description	Schema
`201`	Created	—
`default`	error	—

GET/sites/{site_id}/services/{addon}/instances/{instance_id}

Parameters

Name	In	Required	Type
`site_id`	path	yes	string
`addon`	path	yes	string
`instance_id`	path	yes	string

Responses

Status	Description	Schema
`200`	OK	—
`default`	error	—

PUT/sites/{site_id}/services/{addon}/instances/{instance_id}

Parameters

Name	In	Required	Type
`site_id`	path	yes	string
`addon`	path	yes	string
`instance_id`	path	yes	string

Request body

application/json (required)

Responses

Status	Description	Schema
`204`	No Content	—
`default`	error	—

DELETE/sites/{site_id}/services/{addon}/instances/{instance_id}

Parameters

Name	In	Required	Type
`site_id`	path	yes	string
`addon`	path	yes	string
`instance_id`	path	yes	string

Responses

Status	Description	Schema
`204`	Deleted	—
`default`	error	—

function2

PUT/deploys/{deploy_id}/functions/{name}

Parameters

Name	In	Required	Type
`deploy_id`	path	yes	string
`name`	path	yes	string
`runtime`	query	no	string
`invocation_mode`	query	no	string
`timeout`	query	no	integer
`size`	query	no	integer
`X-Nf-Retry-Count`	header	no	integer

Request body

application/json (required)

Responses

Status	Description	Schema
`200`	OK	—
`default`	error	—

GET/sites/{site_id}/functions

Parameters

Name	In	Required	Type
`site_id`	path	yes	string
`filter`	query	no	string

Responses

Status	Description	Schema
`200`	OK	—
`default`	error	—

form2

GET/sites/{site_id}/forms

Parameters

Name	In	Required	Type
`site_id`	path	yes	string

Responses

Status	Description	Schema
`200`	OK	—
`default`	error	—

DELETE/sites/{site_id}/forms/{form_id}

Parameters

Name	In	Required	Type
`site_id`	path	yes	string
`form_id`	path	yes	string

Responses

Status	Description	Schema
`204`	Deleted	—
`default`	error	—

submission4

GET/forms/{form_id}/submissions

Parameters

Name	In	Required	Type
`form_id`	path	yes	string
`page`	query	no	integer
`per_page`	query	no	integer

Responses

Status	Description	Schema
`200`	OK	—
`default`	error	—

GET/sites/{site_id}/submissions

Parameters

Name	In	Required	Type
`site_id`	path	yes	string
`page`	query	no	integer
`per_page`	query	no	integer

Responses

Status	Description	Schema
`200`	OK	—
`default`	error	—

GET/submissions/{submission_id}

Parameters

Name	In	Required	Type
`submission_id`	path	yes	string
`query`	query	no	string
`page`	query	no	integer
`per_page`	query	no	integer

Responses

Status	Description	Schema
`200`	OK	—
`default`	error	—

DELETE/submissions/{submission_id}

Parameters

Name	In	Required	Type
`submission_id`	path	yes	string

Responses

Status	Description	Schema
`204`	Deleted	—
`default`	error	—

splitTest6

GET/sites/{site_id}/traffic_splits

Parameters

Name	In	Required	Type
`site_id`	path	yes	string

Responses

Status	Description	Schema
`200`	split_tests	—
`default`	error	—

POST/sites/{site_id}/traffic_splits

Parameters

Name	In	Required	Type
`site_id`	path	yes	string

Request body

application/json (required)

Responses

Status	Description	Schema
`201`	Created	—
`default`	error	—

GET/sites/{site_id}/traffic_splits/{split_test_id}

Parameters

Name	In	Required	Type
`site_id`	path	yes	string
`split_test_id`	path	yes	string

Responses

Status	Description	Schema
`200`	split_test	—
`default`	error	—

PUT/sites/{site_id}/traffic_splits/{split_test_id}

Parameters

Name	In	Required	Type
`site_id`	path	yes	string
`split_test_id`	path	yes	string

Request body

application/json (required)

Responses

Status	Description	Schema
`201`	Created	—
`default`	error	—

POST/sites/{site_id}/traffic_splits/{split_test_id}/publish

Parameters

Name	In	Required	Type
`site_id`	path	yes	string
`split_test_id`	path	yes	string

Responses

Status	Description	Schema
`204`	enable	—
`default`	error	—

POST/sites/{site_id}/traffic_splits/{split_test_id}/unpublish

Parameters

Name	In	Required	Type
`site_id`	path	yes	string
`split_test_id`	path	yes	string

Responses

Status	Description	Schema
`204`	disabled	—
`default`	error	—

asset5

GET/sites/{site_id}/assets

Parameters

Name	In	Required	Type
`site_id`	path	yes	string

Responses

Status	Description	Schema
`200`	OK	—
`default`	error	—

POST/sites/{site_id}/assets

Parameters

Name	In	Required	Type
`site_id`	path	yes	string
`name`	query	yes	string
`size`	query	yes	integer
`content_type`	query	yes	string
`visibility`	query	no	string

Responses

Status	Description	Schema
`201`	Created	—
`default`	error	—

GET/sites/{site_id}/assets/{asset_id}

Parameters

Name	In	Required	Type
`site_id`	path	yes	string
`asset_id`	path	yes	string

Responses

Status	Description	Schema
`200`	OK	—
`default`	error	—

PUT/sites/{site_id}/assets/{asset_id}

Parameters

Name	In	Required	Type
`site_id`	path	yes	string
`asset_id`	path	yes	string
`state`	query	yes	string

Responses

Status	Description	Schema
`200`	Updated	—
`default`	error	—

DELETE/sites/{site_id}/assets/{asset_id}

Parameters

Name	In	Required	Type
`site_id`	path	yes	string
`asset_id`	path	yes	string

Responses

Status	Description	Schema
`204`	Deleted	—
`default`	error	—

assetPublicSignature1

GET/sites/{site_id}/assets/{asset_id}/public_signature

Parameters

Name	In	Required	Type
`site_id`	path	yes	string
`asset_id`	path	yes	string

Responses

Status	Description	Schema
`200`	OK	—
`default`	error	—

devServer6

GET/sites/{site_id}/dev_servers

Parameters

Name	In	Required	Type
`site_id`	path	yes	string
`page`	query	no	integer
`per_page`	query	no	integer

Responses

Status	Description	Schema
`200`	OK	—
`default`	error	—

POST/sites/{site_id}/dev_servers

Parameters

Name	In	Required	Type
`site_id`	path	yes	string
`branch`	query	no	string

Responses

Status	Description	Schema
`200`	OK	—
`default`	error	—

DELETE/sites/{site_id}/dev_servers

Parameters

Name	In	Required	Type
`site_id`	path	yes	string
`branch`	query	no	string

Responses

Status	Description	Schema
`202`	OK	—
`default`	error	—

GET/sites/{site_id}/dev_servers/{dev_server_id}

Parameters

Name	In	Required	Type
`site_id`	path	yes	string
`dev_server_id`	path	yes	string

Responses

Status	Description	Schema
`200`	OK	—

POST/sites/{site_id}/dev_servers/{dev_server_id}/activity

Parameters

Name	In	Required	Type
`site_id`	path	yes	string
`dev_server_id`	path	yes	string

Responses

Status	Description	Schema
`200`	OK	—

POST/sites/{site_id}/dev_servers/{dev_server_id}/state

Parameters

Name	In	Required	Type
`site_id`	path	yes	string
`dev_server_id`	path	yes	string

Request body

application/json (required)

Responses

Status	Description	Schema
`200`	OK	—
`409`	Conflict	—

devServerHook5

GET/sites/{site_id}/dev_server_hooks

Parameters

Name	In	Required	Type
`site_id`	path	yes	string

Responses

Status	Description	Schema
`200`	OK	—
`default`	error	—

POST/sites/{site_id}/dev_server_hooks

Parameters

Name	In	Required	Type
`site_id`	path	yes	string

Request body

application/json (required)

Responses

Status	Description	Schema
`201`	Created	—
`default`	error	—

GET/sites/{site_id}/dev_server_hooks/{id}

Parameters

Name	In	Required	Type
`site_id`	path	yes	string
`id`	path	yes	string

Responses

Status	Description	Schema
`200`	OK	—
`default`	error	—

PUT/sites/{site_id}/dev_server_hooks/{id}

Parameters

Name	In	Required	Type
`site_id`	path	yes	string
`id`	path	yes	string

Request body

application/json (required)

Responses

Status	Description	Schema
`204`	No content	—
`default`	error	—

DELETE/sites/{site_id}/dev_server_hooks/{id}

Parameters

Name	In	Required	Type
`site_id`	path	yes	string
`id`	path	yes	string

Responses

Status	Description	Schema
`204`	No content	—
`default`	error	—

database19

GET/sites/{site_id}/database

Parameters

Name	In	Required	Type
`site_id`	path	yes	string
`role`	query	no	string

Responses

Status	Description	Schema
`200`	OK	—
`default`	error	—

POST/sites/{site_id}/database

Parameters

Name	In	Required	Type
`site_id`	path	yes	string

Request body

application/json

Responses

Status	Description	Schema
`200`	Database already exists	—
`201`	Created	—
`default`	error	—

DELETE/sites/{site_id}/database

Parameters

Name	In	Required	Type
`site_id`	path	yes	string

Responses

Status	Description	Schema
`204`	Deleted	—
`default`	error	—

POST/sites/{site_id}/database/branch

Parameters

Name	In	Required	Type
`site_id`	path	yes	string

Request body

application/json (required)

Responses

Status	Description	Schema
`200`	Branch already exists	—
`201`	Created	—
`default`	error	—

GET/sites/{site_id}/database/branch/{branch_id}

Parameters

Name	In	Required	Type
`site_id`	path	yes	string
`branch_id`	path	yes	string
`role`	query	no	string

Responses

Status	Description	Schema
`200`	OK	—
`404`	Branch not found	—
`default`	error	—

DELETE/sites/{site_id}/database/branch/{branch_id}

Parameters

Name	In	Required	Type
`site_id`	path	yes	string
`branch_id`	path	yes	string

Responses

Status	Description	Schema
`204`	Deleted	—
`default`	error	—

PUT/sites/{site_id}/database/branch/{branch_id}/compute/settings

Parameters

Name	In	Required	Type
`site_id`	path	yes	string
`branch_id`	path	yes	string

Request body

application/json (required)

Responses

Status	Description	Schema
`200`	OK	—
`403`	Compute customization requires a Pro or higher plan	—
`default`	error	—

POST/sites/{site_id}/database/branch/{branch_id}/reset

Parameters

Name	In	Required	Type
`site_id`	path	yes	string
`branch_id`	path	yes	string
`force`	query	no	boolean
`role`	query	no	string

Request body

application/json

Responses

Status	Description	Schema
`200`	OK	—
`400`	Invalid request — for example, the target is the production branch or the source branch is the same as the target.	—
`404`	Database or branch not found	—
`default`	error	—

GET/sites/{site_id}/database/branches

Parameters

Name	In	Required	Type
`site_id`	path	yes	string

Responses

Status	Description	Schema
`200`	OK	—
`default`	error	—

GET/sites/{site_id}/database/compute/settings

Parameters

Name	In	Required	Type
`site_id`	path	yes	string

Responses

Status	Description	Schema
`200`	OK	—
`403`	Compute customization requires a Pro or higher plan	—
`default`	error	—

PUT/sites/{site_id}/database/compute/settings

Parameters

Name	In	Required	Type
`site_id`	path	yes	string

Request body

application/json (required)

Responses

Status	Description	Schema
`200`	OK	—
`403`	Compute customization requires a Pro or higher plan	—
`default`	error	—

DELETE/sites/{site_id}/database/compute/settings

Parameters

Name	In	Required	Type
`site_id`	path	yes	string

Responses

Status	Description	Schema
`204`	Cleared	—
`403`	Compute customization requires a Pro or higher plan	—
`default`	error	—

GET/sites/{site_id}/database/migrations

Parameters

Name	In	Required	Type
`site_id`	path	yes	string
`branch`	query	no	string

Responses

Status	Description	Schema
`200`	OK	—
`404`	Database or branch not found	—
`423`	Database is disabled	—
`default`	error	—

POST/sites/{site_id}/database/migrations/{deploy_id}

Parameters

Name	In	Required	Type
`site_id`	path	yes	string
`deploy_id`	path	yes	string

Request body

application/json

Responses

Status	Description	Schema
`200`	OK	—
`409`	Migration conflict - migration modified or removed after being applied	—
`422`	Migration validation failed	—
`default`	error	—

GET/sites/{site_id}/database/migrations/{name}

Parameters

Name	In	Required	Type
`site_id`	path	yes	string
`name`	path	yes	string
`branch`	query	no	string

Responses

Status	Description	Schema
`200`	OK	—
`404`	Migration, database, or branch not found	—
`423`	Database is disabled	—
`default`	error	—

POST/sites/{site_id}/database/snapshot

Parameters

Name	In	Required	Type
`site_id`	path	yes	string

Request body

application/json

Responses

Status	Description	Schema
`201`	Created	—
`default`	error	—

DELETE/sites/{site_id}/database/snapshot/{snapshot_id}

Parameters

Name	In	Required	Type
`site_id`	path	yes	string
`snapshot_id`	path	yes	string

Responses

Status	Description	Schema
`204`	Deleted	—
`default`	error	—

POST/sites/{site_id}/database/snapshot/{snapshot_id}/restore

Parameters

Name	In	Required	Type
`site_id`	path	yes	string
`snapshot_id`	path	yes	string

Request body

application/json

Responses

Status	Description	Schema
`200`	OK	—
`default`	error	—

GET/sites/{site_id}/database/snapshots

Parameters

Name	In	Required	Type
`site_id`	path	yes	string

Responses

Status	Description	Schema
`200`	OK	—
`default`	error	—

agentRunner9

GET/agent_runners

Parameters

Name	In	Required	Type
`account_id`	query	yes	string
`site_id`	query	yes	string
`page`	query	no	integer
`per_page`	query	no	integer
`state`	query	no	string
`title`	query	no	string
`branch`	query	no	string
`result_branch`	query	no	string
`from`	query	no	integer
`to`	query	no	integer

Responses

Status	Description	Schema
`200`	OK	—
`default`	error	—

POST/agent_runners

Parameters

Name	In	Required	Type
`site_id`	query	yes	string
`deploy_id`	query	no	string
`branch`	query	no	string
`prompt`	query	no	string
`agent`	query	no	string
`model`	query	no	string
`parent_agent_runner_id`	query	no	string
`dev_server_image`	query	no	string
`file_keys`	query	no	array

Responses

Status	Description	Schema
`200`	OK	—
`404`	Not Found	—
`422`	Unprocessable Entity	—
`default`	error	—

POST/agent_runners/upload_url

Parameters

Name	In	Required	Type
`account_id`	query	yes	string
`filename`	query	yes	string
`content_type`	query	yes	string

Responses

Status	Description	Schema
`200`	OK	—
`400`	Bad Request	—
`422`	Unprocessable Entity	—
`default`	error	—

GET/agent_runners/{agent_runner_id}

Parameters

Name	In	Required	Type
`agent_runner_id`	path	yes	string

Responses

Status	Description	Schema
`200`	OK	—
`default`	error	—

PATCH/agent_runners/{agent_runner_id}

Parameters

Name	In	Required	Type
`agent_runner_id`	path	yes	string

Responses

Status	Description	Schema
`200`	OK	—
`default`	error	—

DELETE/agent_runners/{agent_runner_id}

Parameters

Name	In	Required	Type
`agent_runner_id`	path	yes	string

Responses

Status	Description	Schema
`202`	Accepted	—
`default`	error	—

POST/agent_runners/{agent_runner_id}/archive

Parameters

Name	In	Required	Type
`agent_runner_id`	path	yes	string

Responses

Status	Description	Schema
`202`	Accepted	—
`404`	Not Found	—
`422`	Unprocessable Entity	—
`default`	error	—

POST/agent_runners/{agent_runner_id}/commit

Parameters

Name	In	Required	Type
`agent_runner_id`	path	yes	string
`target_branch`	query	yes	string

Responses

Status	Description	Schema
`200`	OK	—
`400`	Bad Request	—
`409`	Conflict	—
`422`	Unprocessable Entity	—
`default`	error	—

POST/agent_runners/{agent_runner_id}/pull_request

Parameters

Name	In	Required	Type
`agent_runner_id`	path	yes	string

Responses

Status	Description	Schema
`200`	OK	—
`400`	Bad Request	—
`409`	Conflict	—
`422`	Unprocessable Entity	—
`default`	error	—

agentRunnerHook5

GET/sites/{site_id}/agent_runner_hooks

Parameters

Name	In	Required	Type
`site_id`	path	yes	string

Responses

Status	Description	Schema
`200`	OK	—
`default`	error	—

POST/sites/{site_id}/agent_runner_hooks

Parameters

Name	In	Required	Type
`site_id`	path	yes	string

Request body

application/json (required)

Responses

Status	Description	Schema
`201`	Created	—
`default`	error	—

GET/sites/{site_id}/agent_runner_hooks/{id}

Parameters

Name	In	Required	Type
`site_id`	path	yes	string
`id`	path	yes	string

Responses

Status	Description	Schema
`200`	OK	—
`default`	error	—

PUT/sites/{site_id}/agent_runner_hooks/{id}

Parameters

Name	In	Required	Type
`site_id`	path	yes	string
`id`	path	yes	string

Request body

application/json (required)

Responses

Status	Description	Schema
`204`	No content	—
`default`	error	—

DELETE/sites/{site_id}/agent_runner_hooks/{id}

Parameters

Name	In	Required	Type
`site_id`	path	yes	string
`id`	path	yes	string

Responses

Status	Description	Schema
`204`	No content	—
`default`	error	—

agentRunnerSession5

GET/agent_runners/{agent_runner_id}/sessions

Parameters

Name	In	Required	Type
`agent_runner_id`	path	yes	string
`page`	query	no	integer
`per_page`	query	no	integer
`state`	query	no	string
`from`	query	no	integer
`to`	query	no	integer
`order_by`	query	no	string

Responses

Status	Description	Schema
`200`	OK	—
`default`	error	—

POST/agent_runners/{agent_runner_id}/sessions

Parameters

Name	In	Required	Type
`agent_runner_id`	path	yes	string
`prompt`	query	no	string
`agent`	query	no	string
`model`	query	no	string
`file_keys`	query	no	array

Responses

Status	Description	Schema
`200`	OK	—
`404`	Not Found	—
`422`	Unprocessable Entity	—
`default`	error	—

GET/agent_runners/{agent_runner_id}/sessions/{agent_runner_session_id}

Parameters

Name	In	Required	Type
`agent_runner_id`	path	yes	string
`agent_runner_session_id`	path	yes	string

Responses

Status	Description	Schema
`200`	OK	—
`default`	error	—

PATCH/agent_runners/{agent_runner_id}/sessions/{agent_runner_session_id}

Parameters

Name	In	Required	Type
`agent_runner_id`	path	yes	string
`agent_runner_session_id`	path	yes	string
`is_published`	query	no	boolean

Responses

Status	Description	Schema
`200`	OK	—
`default`	error	—

DELETE/agent_runners/{agent_runner_id}/sessions/{agent_runner_session_id}

Parameters

Name	In	Required	Type
`agent_runner_id`	path	yes	string
`agent_runner_session_id`	path	yes	string

Responses

Status	Description	Schema
`202`	Accepted	—
`default`	error	—

aiGateway3

GET/accounts/{account_id}/ai-gateway/token

Parameters

Name	In	Required	Type
`account_id`	path	yes	string

Responses

Status	Description	Schema
`200`	AI Gateway token for the account	—
`404`	AI Gateway not available for this account	—
`default`	error	—

GET/ai-gateway/providers

Responses

Status	Description	Schema
`200`	The mapping of providers and supported models	—
`default`	error	—

GET/sites/{site_id}/ai-gateway/token

Parameters

Name	In	Required	Type
`site_id`	path	yes	string

Responses

Status	Description	Schema
`200`	AI Gateway token for the site	—
`404`	AI Gateway not available for this site	—
`default`	error	—

edgeFunction1

PUT/deploys/{deploy_id}/edge_functions/{code_sha}

Parameters

Name	In	Required	Type
`deploy_id`	path	yes	string
`code_sha`	path	yes	string
`X-Nf-Retry-Count`	header	no	integer

Request body

application/json (required)

Responses

Status	Description	Schema
`200`	OK	—
`default`	error	—

x-internal3

POST/deploys/{deploy_id}/plugin_runs

Parameters

Name	In	Required	Type
`deploy_id`	path	yes	string

Request body

application/json

Responses

Status	Description	Schema
`201`	CREATED	—
`default`	error	—

GET/sites/{site_id}/plugin_runs/latest

Parameters

Name	In	Required	Type
`site_id`	path	yes	string
`packages`	query	yes	array
`state`	query	no	string

Responses

Status	Description	Schema
`200`	OK	—
`default`	error	—

PUT/sites/{site_id}/plugins/{package}

Parameters

Name	In	Required	Type
`site_id`	path	yes	string
`package`	path	yes	string

Request body

application/json

Responses

Status	Description	Schema
`200`	OK	—
`default`	error	—

Try it

Operation

API key

Developer reference

Base URLhttps://api.netlify.com/api/v1

Rate limit

Netlify's API guide documents a flat 500 requests per minute for most endpoints, with deploy operations held to a stricter 3 deploys per minute and 100 deploys per day. Every response carries X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset headers so a client can check its current standing; the docs point clients needing more headroom to contact Netlify support rather than publishing a paid-tier override.

Key endpoints

GET/sites
GET/sites/{site_id}
POST/sites
GET/sites/{site_id}/deploys
POST/sites/{site_id}/deploys

SDKs

JavaScript ↗Go ↗

Changelog

Spec version2.57.1

Tracked paths116

No change recorded yet.

Tracking since Sep 2026. See every tracked change ↗ ·Subscribe with RSS ↗

Featured in

2 collections

Spec-backed APIs CORS-ready browser APIs

GreatAPIs Score

Embed this badge

Auth quickstart

Endpoints

Try it

Developer reference

Changelog

Featured in

People comparing Netlify also look at…

Kroki

QR code

Statically

Wandbox

APIs.guru

Beeceptor