Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Netlify Deploy API

The Deploy API from Netlify — 8 operation(s) for deploy.

Netlify Deploy API is one of 35 APIs that Netlify publishes on the APIs.io network, described by a machine-readable OpenAPI specification and an AsyncAPI event-driven specification.

Tagged areas include Deploy. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an AsyncAPI specification, and a getting-started guide.

This API exposes 12 operations across 8 paths, and defines 10 schemas. It is described by OpenAPI 3.0.1, at version 2.33.1.

Requests are made against a single base URL, https://api.netlify.com/api/v1.

12 operations 8 paths 10 schemas 2 DELETE3 GET5 POST2 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.1
API Version
2.33.1
Base URL
https://api.netlify.com/api/v1/
Authentication
OAuth 2.0
Terms of Service
Resource Areas
1

Authentication & Security 1

Netlify Deploy API declares 1 security scheme for authenticating requests. It supports OAuth 2.0 (netlifyAuth) using the implicit flow. By default, every request must be authenticated.

Paths & Operations 12

Across 8 paths, the API surfaces 12 operations — 2 DELETE, 3 GET, 5 POST, 2 PUT. Each is listed below with its method, path, parameters, and response codes.

Deploy 12
GET
/sites/{site_id}/deploys
listSiteDeploys 8 params → 200default
POST
/sites/{site_id}/deploys
createSiteDeploy 7 params body → 200default
GET
/sites/{site_id}/deploys/{deploy_id}
getSiteDeploy 2 params → 200default
PUT
/sites/{site_id}/deploys/{deploy_id}
updateSiteDeploy 2 params body → 200default
DELETE
/sites/{site_id}/deploys/{deploy_id}
deleteSiteDeploy 2 params → 204default
POST
/deploys/{deploy_id}/cancel
cancelSiteDeploy 1 param → 201default
POST
/sites/{site_id}/deploys/{deploy_id}/restore
restoreSiteDeploy 2 params → 201default
PUT
/sites/{site_id}/rollback
rollbackSiteDeploy 1 param → 204default
GET
/deploys/{deploy_id}
getDeploy 1 param → 200default
DELETE
/deploys/{deploy_id}
deleteDeploy 1 param → 204default
POST
/deploys/{deploy_id}/lock
lockDeploy 1 param → 200default
POST
/deploys/{deploy_id}/unlock
unlockDeploy 1 param → 200default

Schemas 10

The contract defines 10 schemas that model the data the API accepts and returns. The most detailed are deploy (30 properties), deployFiles (9 properties), functionConfig (7 properties), functionRoute (5 properties). Each schema is shown below with its type and property counts.

excludedFunctionRoute
object
3 properties
functionRoute
object
5 properties
deploy
object
30 properties
trafficRulesRateLimitConfig
object
3 properties
functionSchedule
object
2 properties
trafficRulesAggregateConfig
object
1 property
deployFiles
object
9 properties
error
object
2 properties 1 required
trafficRulesConfig
object
1 property
functionConfig
object
7 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

netlify-deploy-api-openapi.yml Raw ↑

Other APIs Netlify publishes across the network.

Netlify accessToken API
Netlify accountMembership API
Netlify accountType API
Netlify Asset API
Netlify assetPublicSignature API
Netlify auditLog API
Netlify Build API
Netlify buildHook API
Netlify buildLogMsg API
Netlify deployedBranch API
Netlify deployKey API
Netlify devServer API