{ "swagger": "2.0", "info": { "version": "2.37.0", "title": "Netlify's API documentation", "description": "Netlify is a hosting service for the programmable web. It understands your documents and provides an API to handle atomic deploys of websites, manage form submissions, inject JavaScript snippets, and much more. This is a REST-style API that uses JSON for serialization and OAuth 2 for authentication.\n\nThis document is an OpenAPI reference for the Netlify API that you can explore. For more detailed instructions for common uses, please visit the [online documentation](https://www.netlify.com/docs/api/). Visit our Community forum to join the conversation about [understanding and using Netlify's API](https://community.netlify.com/t/common-issue-understanding-and-using-netlifys-api/160).\n\nAdditionally, we have two API clients for your convenience:\n- [Go Client](https://github.com/netlify/open-api#go-client)\n- [JS Client](https://github.com/netlify/build/tree/main/packages/js-client)", "termsOfService": "https://www.netlify.com/legal/terms-of-use/", "x-logo": { "url": "netlify-logo.png", "href": "https://www.netlify.com/docs/", "altText": "Netlify" } }, "externalDocs": { "url": "https://www.netlify.com/docs/api/", "description": "Online documentation" }, "securityDefinitions": { "netlifyAuth": { "type": "oauth2", "flow": "implicit", "authorizationUrl": "https://app.netlify.com/authorize" } }, "security": [ { "netlifyAuth": [] } ], "consumes": [ "application/json" ], "produces": [ "application/json" ], "schemes": [ "https" ], "responses": { "error": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } }, "host": "api.netlify.com", "basePath": "/api/v1", "paths": { "/sites": { "get": { "operationId": "listSites", "tags": [ "site" ], "parameters": [ { "name": "name", "in": "query", "type": "string" }, { "name": "filter", "in": "query", "type": "string", "enum": [ "all", "owner", "guest" ] }, { "type": "integer", "format": "int32", "name": "page", "required": false, "in": "query" }, { "type": "integer", "format": "int32", "name": "per_page", "required": false, "in": "query" } ], "responses": { "200": { "description": "OK", "schema": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "state": { "type": "string" }, "plan": { "type": "string" }, "name": { "type": "string" }, "custom_domain": { "type": "string" }, "domain_aliases": { "type": "array", "items": { "type": "string" } }, "branch_deploy_custom_domain": { "type": "string" }, "deploy_preview_custom_domain": { "type": "string" }, "password": { "type": "string" }, "notification_email": { "type": "string" }, "url": { "type": "string" }, "ssl_url": { "type": "string" }, "admin_url": { "type": "string" }, "screenshot_url": { "type": "string" }, "created_at": { "type": "string", "format": "dateTime" }, "updated_at": { "type": "string", "format": "dateTime" }, "user_id": { "type": "string" }, "session_id": { "type": "string" }, "ssl": { "type": "boolean" }, "force_ssl": { "type": "boolean" }, "managed_dns": { "type": "boolean" }, "deploy_url": { "type": "string" }, "published_deploy": { "type": "object", "properties": { "id": { "type": "string" }, "site_id": { "type": "string" }, "user_id": { "type": "string" }, "build_id": { "type": "string" }, "state": { "type": "string" }, "name": { "type": "string" }, "url": { "type": "string" }, "ssl_url": { "type": "string" }, "admin_url": { "type": "string" }, "deploy_url": { "type": "string" }, "deploy_ssl_url": { "type": "string" }, "screenshot_url": { "type": "string" }, "review_id": { "type": "number" }, "draft": { "type": "boolean" }, "required": { "type": "array", "items": { "type": "string" } }, "required_functions": { "type": "array", "items": { "type": "string" } }, "error_message": { "type": "string" }, "branch": { "type": "string" }, "commit_ref": { "type": "string" }, "commit_url": { "type": "string" }, "skipped": { "type": "boolean" }, "created_at": { "type": "string", "format": "dateTime" }, "updated_at": { "type": "string", "format": "dateTime" }, "published_at": { "type": "string", "format": "dateTime" }, "title": { "type": "string" }, "context": { "type": "string" }, "locked": { "type": "boolean" }, "review_url": { "type": "string" }, "framework": { "type": "string" }, "function_schedules": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "cron": { "type": "string" } } } } } }, "account_id": { "type": "string" }, "account_name": { "type": "string" }, "account_slug": { "type": "string" }, "git_provider": { "type": "string" }, "deploy_hook": { "type": "string" }, "capabilities": { "type": "object", "additionalProperties": { "type": "object" } }, "processing_settings": { "type": "object", "properties": { "html": { "type": "object", "properties": { "pretty_urls": { "type": "boolean" } } } } }, "build_settings": { "type": "object", "properties": { "id": { "type": "integer" }, "provider": { "type": "string" }, "deploy_key_id": { "type": "string" }, "repo_path": { "type": "string" }, "repo_branch": { "type": "string" }, "dir": { "type": "string" }, "functions_dir": { "type": "string" }, "cmd": { "type": "string" }, "allowed_branches": { "type": "array", "items": { "type": "string" } }, "public_repo": { "type": "boolean" }, "private_logs": { "type": "boolean" }, "repo_url": { "type": "string" }, "env": { "type": "object", "additionalProperties": { "type": "string" } }, "installation_id": { "type": "integer" }, "stop_builds": { "type": "boolean" } } }, "id_domain": { "type": "string" }, "default_hooks_data": { "type": "object", "properties": { "access_token": { "type": "string" } } }, "build_image": { "type": "string" }, "prerender": { "type": "string" }, "functions_region": { "type": "string" } } } } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } }, "description": "**Note:** Environment variable keys and values have moved from `build_settings.env` and `repo.env` to a new endpoint. Please use [getEnvVars](#tag/environmentVariables/operation/getEnvVars) to retrieve site environment variables." }, "post": { "operationId": "createSite", "tags": [ "site" ], "consumes": [ "application/json" ], "parameters": [ { "name": "site", "in": "body", "schema": { "allOf": [ { "type": "object", "properties": { "id": { "type": "string" }, "state": { "type": "string" }, "plan": { "type": "string" }, "name": { "type": "string" }, "custom_domain": { "type": "string" }, "domain_aliases": { "type": "array", "items": { "type": "string" } }, "branch_deploy_custom_domain": { "type": "string" }, "deploy_preview_custom_domain": { "type": "string" }, "password": { "type": "string" }, "notification_email": { "type": "string" }, "url": { "type": "string" }, "ssl_url": { "type": "string" }, "admin_url": { "type": "string" }, "screenshot_url": { "type": "string" }, "created_at": { "type": "string", "format": "dateTime" }, "updated_at": { "type": "string", "format": "dateTime" }, "user_id": { "type": "string" }, "session_id": { "type": "string" }, "ssl": { "type": "boolean" }, "force_ssl": { "type": "boolean" }, "managed_dns": { "type": "boolean" }, "deploy_url": { "type": "string" }, "published_deploy": { "type": "object", "properties": { "id": { "type": "string" }, "site_id": { "type": "string" }, "user_id": { "type": "string" }, "build_id": { "type": "string" }, "state": { "type": "string" }, "name": { "type": "string" }, "url": { "type": "string" }, "ssl_url": { "type": "string" }, "admin_url": { "type": "string" }, "deploy_url": { "type": "string" }, "deploy_ssl_url": { "type": "string" }, "screenshot_url": { "type": "string" }, "review_id": { "type": "number" }, "draft": { "type": "boolean" }, "required": { "type": "array", "items": { "type": "string" } }, "required_functions": { "type": "array", "items": { "type": "string" } }, "error_message": { "type": "string" }, "branch": { "type": "string" }, "commit_ref": { "type": "string" }, "commit_url": { "type": "string" }, "skipped": { "type": "boolean" }, "created_at": { "type": "string", "format": "dateTime" }, "updated_at": { "type": "string", "format": "dateTime" }, "published_at": { "type": "string", "format": "dateTime" }, "title": { "type": "string" }, "context": { "type": "string" }, "locked": { "type": "boolean" }, "review_url": { "type": "string" }, "framework": { "type": "string" }, "function_schedules": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "cron": { "type": "string" } } } } } }, "account_id": { "type": "string" }, "account_name": { "type": "string" }, "account_slug": { "type": "string" }, "git_provider": { "type": "string" }, "deploy_hook": { "type": "string" }, "capabilities": { "type": "object", "additionalProperties": { "type": "object" } }, "processing_settings": { "type": "object", "properties": { "html": { "type": "object", "properties": { "pretty_urls": { "type": "boolean" } } } } }, "build_settings": { "type": "object", "properties": { "id": { "type": "integer" }, "provider": { "type": "string" }, "deploy_key_id": { "type": "string" }, "repo_path": { "type": "string" }, "repo_branch": { "type": "string" }, "dir": { "type": "string" }, "functions_dir": { "type": "string" }, "cmd": { "type": "string" }, "allowed_branches": { "type": "array", "items": { "type": "string" } }, "public_repo": { "type": "boolean" }, "private_logs": { "type": "boolean" }, "repo_url": { "type": "string" }, "env": { "type": "object", "additionalProperties": { "type": "string" } }, "installation_id": { "type": "integer" }, "stop_builds": { "type": "boolean" } } }, "id_domain": { "type": "string" }, "default_hooks_data": { "type": "object", "properties": { "access_token": { "type": "string" } } }, "build_image": { "type": "string" }, "prerender": { "type": "string" }, "functions_region": { "type": "string" } } }, { "properties": { "repo": { "type": "object", "properties": { "id": { "type": "integer" }, "provider": { "type": "string" }, "deploy_key_id": { "type": "string" }, "repo_path": { "type": "string" }, "repo_branch": { "type": "string" }, "dir": { "type": "string" }, "functions_dir": { "type": "string" }, "cmd": { "type": "string" }, "allowed_branches": { "type": "array", "items": { "type": "string" } }, "public_repo": { "type": "boolean" }, "private_logs": { "type": "boolean" }, "repo_url": { "type": "string" }, "env": { "type": "object", "additionalProperties": { "type": "string" } }, "installation_id": { "type": "integer" }, "stop_builds": { "type": "boolean" } } } } } ] }, "required": true }, { "name": "configure_dns", "type": "boolean", "in": "query" } ], "responses": { "201": { "description": "Created", "schema": { "type": "object", "properties": { "id": { "type": "string" }, "state": { "type": "string" }, "plan": { "type": "string" }, "name": { "type": "string" }, "custom_domain": { "type": "string" }, "domain_aliases": { "type": "array", "items": { "type": "string" } }, "branch_deploy_custom_domain": { "type": "string" }, "deploy_preview_custom_domain": { "type": "string" }, "password": { "type": "string" }, "notification_email": { "type": "string" }, "url": { "type": "string" }, "ssl_url": { "type": "string" }, "admin_url": { "type": "string" }, "screenshot_url": { "type": "string" }, "created_at": { "type": "string", "format": "dateTime" }, "updated_at": { "type": "string", "format": "dateTime" }, "user_id": { "type": "string" }, "session_id": { "type": "string" }, "ssl": { "type": "boolean" }, "force_ssl": { "type": "boolean" }, "managed_dns": { "type": "boolean" }, "deploy_url": { "type": "string" }, "published_deploy": { "type": "object", "properties": { "id": { "type": "string" }, "site_id": { "type": "string" }, "user_id": { "type": "string" }, "build_id": { "type": "string" }, "state": { "type": "string" }, "name": { "type": "string" }, "url": { "type": "string" }, "ssl_url": { "type": "string" }, "admin_url": { "type": "string" }, "deploy_url": { "type": "string" }, "deploy_ssl_url": { "type": "string" }, "screenshot_url": { "type": "string" }, "review_id": { "type": "number" }, "draft": { "type": "boolean" }, "required": { "type": "array", "items": { "type": "string" } }, "required_functions": { "type": "array", "items": { "type": "string" } }, "error_message": { "type": "string" }, "branch": { "type": "string" }, "commit_ref": { "type": "string" }, "commit_url": { "type": "string" }, "skipped": { "type": "boolean" }, "created_at": { "type": "string", "format": "dateTime" }, "updated_at": { "type": "string", "format": "dateTime" }, "published_at": { "type": "string", "format": "dateTime" }, "title": { "type": "string" }, "context": { "type": "string" }, "locked": { "type": "boolean" }, "review_url": { "type": "string" }, "framework": { "type": "string" }, "function_schedules": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "cron": { "type": "string" } } } } } }, "account_id": { "type": "string" }, "account_name": { "type": "string" }, "account_slug": { "type": "string" }, "git_provider": { "type": "string" }, "deploy_hook": { "type": "string" }, "capabilities": { "type": "object", "additionalProperties": { "type": "object" } }, "processing_settings": { "type": "object", "properties": { "html": { "type": "object", "properties": { "pretty_urls": { "type": "boolean" } } } } }, "build_settings": { "type": "object", "properties": { "id": { "type": "integer" }, "provider": { "type": "string" }, "deploy_key_id": { "type": "string" }, "repo_path": { "type": "string" }, "repo_branch": { "type": "string" }, "dir": { "type": "string" }, "functions_dir": { "type": "string" }, "cmd": { "type": "string" }, "allowed_branches": { "type": "array", "items": { "type": "string" } }, "public_repo": { "type": "boolean" }, "private_logs": { "type": "boolean" }, "repo_url": { "type": "string" }, "env": { "type": "object", "additionalProperties": { "type": "string" } }, "installation_id": { "type": "integer" }, "stop_builds": { "type": "boolean" } } }, "id_domain": { "type": "string" }, "default_hooks_data": { "type": "object", "properties": { "access_token": { "type": "string" } } }, "build_image": { "type": "string" }, "prerender": { "type": "string" }, "functions_region": { "type": "string" } } } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } }, "description": "**Note:** Environment variable keys and values have moved from `build_settings.env` and `repo.env` to a new endpoint. Please use [createEnvVars](#tag/environmentVariables/operation/createEnvVars) to create environment variables for a site." } }, "/sites/{site_id}": { "parameters": [ { "name": "site_id", "type": "string", "in": "path", "required": true } ], "get": { "operationId": "getSite", "tags": [ "site" ], "parameters": [ { "name": "feature_flags", "x-internal": true, "type": "string", "in": "query" } ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "properties": { "id": { "type": "string" }, "state": { "type": "string" }, "plan": { "type": "string" }, "name": { "type": "string" }, "custom_domain": { "type": "string" }, "domain_aliases": { "type": "array", "items": { "type": "string" } }, "branch_deploy_custom_domain": { "type": "string" }, "deploy_preview_custom_domain": { "type": "string" }, "password": { "type": "string" }, "notification_email": { "type": "string" }, "url": { "type": "string" }, "ssl_url": { "type": "string" }, "admin_url": { "type": "string" }, "screenshot_url": { "type": "string" }, "created_at": { "type": "string", "format": "dateTime" }, "updated_at": { "type": "string", "format": "dateTime" }, "user_id": { "type": "string" }, "session_id": { "type": "string" }, "ssl": { "type": "boolean" }, "force_ssl": { "type": "boolean" }, "managed_dns": { "type": "boolean" }, "deploy_url": { "type": "string" }, "published_deploy": { "type": "object", "properties": { "id": { "type": "string" }, "site_id": { "type": "string" }, "user_id": { "type": "string" }, "build_id": { "type": "string" }, "state": { "type": "string" }, "name": { "type": "string" }, "url": { "type": "string" }, "ssl_url": { "type": "string" }, "admin_url": { "type": "string" }, "deploy_url": { "type": "string" }, "deploy_ssl_url": { "type": "string" }, "screenshot_url": { "type": "string" }, "review_id": { "type": "number" }, "draft": { "type": "boolean" }, "required": { "type": "array", "items": { "type": "string" } }, "required_functions": { "type": "array", "items": { "type": "string" } }, "error_message": { "type": "string" }, "branch": { "type": "string" }, "commit_ref": { "type": "string" }, "commit_url": { "type": "string" }, "skipped": { "type": "boolean" }, "created_at": { "type": "string", "format": "dateTime" }, "updated_at": { "type": "string", "format": "dateTime" }, "published_at": { "type": "string", "format": "dateTime" }, "title": { "type": "string" }, "context": { "type": "string" }, "locked": { "type": "boolean" }, "review_url": { "type": "string" }, "framework": { "type": "string" }, "function_schedules": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "cron": { "type": "string" } } } } } }, "account_id": { "type": "string" }, "account_name": { "type": "string" }, "account_slug": { "type": "string" }, "git_provider": { "type": "string" }, "deploy_hook": { "type": "string" }, "capabilities": { "type": "object", "additionalProperties": { "type": "object" } }, "processing_settings": { "type": "object", "properties": { "html": { "type": "object", "properties": { "pretty_urls": { "type": "boolean" } } } } }, "build_settings": { "type": "object", "properties": { "id": { "type": "integer" }, "provider": { "type": "string" }, "deploy_key_id": { "type": "string" }, "repo_path": { "type": "string" }, "repo_branch": { "type": "string" }, "dir": { "type": "string" }, "functions_dir": { "type": "string" }, "cmd": { "type": "string" }, "allowed_branches": { "type": "array", "items": { "type": "string" } }, "public_repo": { "type": "boolean" }, "private_logs": { "type": "boolean" }, "repo_url": { "type": "string" }, "env": { "type": "object", "additionalProperties": { "type": "string" } }, "installation_id": { "type": "integer" }, "stop_builds": { "type": "boolean" } } }, "id_domain": { "type": "string" }, "default_hooks_data": { "type": "object", "properties": { "access_token": { "type": "string" } } }, "build_image": { "type": "string" }, "prerender": { "type": "string" }, "functions_region": { "type": "string" } } } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } }, "description": "**Note:** Environment variable keys and values have moved from `build_settings.env` and `repo.env` to a new endpoint. Please use [getEnvVars](#tag/environmentVariables/operation/getEnvVars) to retrieve site environment variables." }, "patch": { "operationId": "updateSite", "tags": [ "site" ], "consumes": [ "application/json" ], "parameters": [ { "name": "site", "in": "body", "schema": { "allOf": [ { "type": "object", "properties": { "id": { "type": "string" }, "state": { "type": "string" }, "plan": { "type": "string" }, "name": { "type": "string" }, "custom_domain": { "type": "string" }, "domain_aliases": { "type": "array", "items": { "type": "string" } }, "branch_deploy_custom_domain": { "type": "string" }, "deploy_preview_custom_domain": { "type": "string" }, "password": { "type": "string" }, "notification_email": { "type": "string" }, "url": { "type": "string" }, "ssl_url": { "type": "string" }, "admin_url": { "type": "string" }, "screenshot_url": { "type": "string" }, "created_at": { "type": "string", "format": "dateTime" }, "updated_at": { "type": "string", "format": "dateTime" }, "user_id": { "type": "string" }, "session_id": { "type": "string" }, "ssl": { "type": "boolean" }, "force_ssl": { "type": "boolean" }, "managed_dns": { "type": "boolean" }, "deploy_url": { "type": "string" }, "published_deploy": { "type": "object", "properties": { "id": { "type": "string" }, "site_id": { "type": "string" }, "user_id": { "type": "string" }, "build_id": { "type": "string" }, "state": { "type": "string" }, "name": { "type": "string" }, "url": { "type": "string" }, "ssl_url": { "type": "string" }, "admin_url": { "type": "string" }, "deploy_url": { "type": "string" }, "deploy_ssl_url": { "type": "string" }, "screenshot_url": { "type": "string" }, "review_id": { "type": "number" }, "draft": { "type": "boolean" }, "required": { "type": "array", "items": { "type": "string" } }, "required_functions": { "type": "array", "items": { "type": "string" } }, "error_message": { "type": "string" }, "branch": { "type": "string" }, "commit_ref": { "type": "string" }, "commit_url": { "type": "string" }, "skipped": { "type": "boolean" }, "created_at": { "type": "string", "format": "dateTime" }, "updated_at": { "type": "string", "format": "dateTime" }, "published_at": { "type": "string", "format": "dateTime" }, "title": { "type": "string" }, "context": { "type": "string" }, "locked": { "type": "boolean" }, "review_url": { "type": "string" }, "framework": { "type": "string" }, "function_schedules": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "cron": { "type": "string" } } } } } }, "account_id": { "type": "string" }, "account_name": { "type": "string" }, "account_slug": { "type": "string" }, "git_provider": { "type": "string" }, "deploy_hook": { "type": "string" }, "capabilities": { "type": "object", "additionalProperties": { "type": "object" } }, "processing_settings": { "type": "object", "properties": { "html": { "type": "object", "properties": { "pretty_urls": { "type": "boolean" } } } } }, "build_settings": { "type": "object", "properties": { "id": { "type": "integer" }, "provider": { "type": "string" }, "deploy_key_id": { "type": "string" }, "repo_path": { "type": "string" }, "repo_branch": { "type": "string" }, "dir": { "type": "string" }, "functions_dir": { "type": "string" }, "cmd": { "type": "string" }, "allowed_branches": { "type": "array", "items": { "type": "string" } }, "public_repo": { "type": "boolean" }, "private_logs": { "type": "boolean" }, "repo_url": { "type": "string" }, "env": { "type": "object", "additionalProperties": { "type": "string" } }, "installation_id": { "type": "integer" }, "stop_builds": { "type": "boolean" } } }, "id_domain": { "type": "string" }, "default_hooks_data": { "type": "object", "properties": { "access_token": { "type": "string" } } }, "build_image": { "type": "string" }, "prerender": { "type": "string" }, "functions_region": { "type": "string" } } }, { "properties": { "repo": { "type": "object", "properties": { "id": { "type": "integer" }, "provider": { "type": "string" }, "deploy_key_id": { "type": "string" }, "repo_path": { "type": "string" }, "repo_branch": { "type": "string" }, "dir": { "type": "string" }, "functions_dir": { "type": "string" }, "cmd": { "type": "string" }, "allowed_branches": { "type": "array", "items": { "type": "string" } }, "public_repo": { "type": "boolean" }, "private_logs": { "type": "boolean" }, "repo_url": { "type": "string" }, "env": { "type": "object", "additionalProperties": { "type": "string" } }, "installation_id": { "type": "integer" }, "stop_builds": { "type": "boolean" } } } } } ] }, "required": true } ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "properties": { "id": { "type": "string" }, "state": { "type": "string" }, "plan": { "type": "string" }, "name": { "type": "string" }, "custom_domain": { "type": "string" }, "domain_aliases": { "type": "array", "items": { "type": "string" } }, "branch_deploy_custom_domain": { "type": "string" }, "deploy_preview_custom_domain": { "type": "string" }, "password": { "type": "string" }, "notification_email": { "type": "string" }, "url": { "type": "string" }, "ssl_url": { "type": "string" }, "admin_url": { "type": "string" }, "screenshot_url": { "type": "string" }, "created_at": { "type": "string", "format": "dateTime" }, "updated_at": { "type": "string", "format": "dateTime" }, "user_id": { "type": "string" }, "session_id": { "type": "string" }, "ssl": { "type": "boolean" }, "force_ssl": { "type": "boolean" }, "managed_dns": { "type": "boolean" }, "deploy_url": { "type": "string" }, "published_deploy": { "type": "object", "properties": { "id": { "type": "string" }, "site_id": { "type": "string" }, "user_id": { "type": "string" }, "build_id": { "type": "string" }, "state": { "type": "string" }, "name": { "type": "string" }, "url": { "type": "string" }, "ssl_url": { "type": "string" }, "admin_url": { "type": "string" }, "deploy_url": { "type": "string" }, "deploy_ssl_url": { "type": "string" }, "screenshot_url": { "type": "string" }, "review_id": { "type": "number" }, "draft": { "type": "boolean" }, "required": { "type": "array", "items": { "type": "string" } }, "required_functions": { "type": "array", "items": { "type": "string" } }, "error_message": { "type": "string" }, "branch": { "type": "string" }, "commit_ref": { "type": "string" }, "commit_url": { "type": "string" }, "skipped": { "type": "boolean" }, "created_at": { "type": "string", "format": "dateTime" }, "updated_at": { "type": "string", "format": "dateTime" }, "published_at": { "type": "string", "format": "dateTime" }, "title": { "type": "string" }, "context": { "type": "string" }, "locked": { "type": "boolean" }, "review_url": { "type": "string" }, "framework": { "type": "string" }, "function_schedules": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "cron": { "type": "string" } } } } } }, "account_id": { "type": "string" }, "account_name": { "type": "string" }, "account_slug": { "type": "string" }, "git_provider": { "type": "string" }, "deploy_hook": { "type": "string" }, "capabilities": { "type": "object", "additionalProperties": { "type": "object" } }, "processing_settings": { "type": "object", "properties": { "html": { "type": "object", "properties": { "pretty_urls": { "type": "boolean" } } } } }, "build_settings": { "type": "object", "properties": { "id": { "type": "integer" }, "provider": { "type": "string" }, "deploy_key_id": { "type": "string" }, "repo_path": { "type": "string" }, "repo_branch": { "type": "string" }, "dir": { "type": "string" }, "functions_dir": { "type": "string" }, "cmd": { "type": "string" }, "allowed_branches": { "type": "array", "items": { "type": "string" } }, "public_repo": { "type": "boolean" }, "private_logs": { "type": "boolean" }, "repo_url": { "type": "string" }, "env": { "type": "object", "additionalProperties": { "type": "string" } }, "installation_id": { "type": "integer" }, "stop_builds": { "type": "boolean" } } }, "id_domain": { "type": "string" }, "default_hooks_data": { "type": "object", "properties": { "access_token": { "type": "string" } } }, "build_image": { "type": "string" }, "prerender": { "type": "string" }, "functions_region": { "type": "string" } } } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } }, "description": "**Note:** Environment variable keys and values have moved from `build_settings.env` and `repo.env` to a new endpoint. Please use [updateEnvVar](#tag/environmentVariables/operation/updateEnvVar) to update a site's environment variables." }, "delete": { "operationId": "deleteSite", "tags": [ "site" ], "responses": { "204": { "description": "Deleted" }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } } }, "/sites/{site_id}/ssl": { "post": { "operationId": "provisionSiteTLSCertificate", "tags": [ "sniCertificate" ], "parameters": [ { "name": "site_id", "type": "string", "in": "path", "required": true }, { "name": "certificate", "type": "string", "in": "query" }, { "name": "key", "type": "string", "in": "query" }, { "name": "ca_certificates", "type": "string", "in": "query" } ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "properties": { "state": { "type": "string" }, "domains": { "type": "array", "items": { "type": "string" } }, "created_at": { "type": "string", "format": "dateTime" }, "updated_at": { "type": "string", "format": "dateTime" }, "expires_at": { "type": "string", "format": "dateTime" } } } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } }, "get": { "operationId": "showSiteTLSCertificate", "tags": [ "sniCertificate" ], "parameters": [ { "name": "site_id", "type": "string", "in": "path", "required": true } ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "properties": { "state": { "type": "string" }, "domains": { "type": "array", "items": { "type": "string" } }, "created_at": { "type": "string", "format": "dateTime" }, "updated_at": { "type": "string", "format": "dateTime" }, "expires_at": { "type": "string", "format": "dateTime" } } } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } } }, "/sites/{site_id}/ssl/certificates": { "get": { "operationId": "getAllCertificates", "tags": [ "sniCertificate" ], "parameters": [ { "name": "site_id", "type": "string", "in": "path", "required": true }, { "name": "domain", "type": "string", "in": "query", "required": true } ], "responses": { "200": { "description": "Array of SNI Certificates", "schema": { "type": "array", "items": { "type": "object", "properties": { "state": { "type": "string" }, "domains": { "type": "array", "items": { "type": "string" } }, "created_at": { "type": "string", "format": "dateTime" }, "updated_at": { "type": "string", "format": "dateTime" }, "expires_at": { "type": "string", "format": "dateTime" } } } } }, "404": { "description": "Not Found" }, "422": { "description": "Unprocessable Entity" } } } }, "/accounts/{account_id}/env": { "get": { "tags": [ "environmentVariables" ], "operationId": "getEnvVars", "parameters": [ { "name": "account_id", "description": "Scope response to account_id", "type": "string", "required": true, "in": "path" }, { "name": "context_name", "description": "Filter by deploy context", "type": "string", "enum": [ "all", "dev", "branch-deploy", "deploy-preview", "production" ], "required": false, "in": "query" }, { "name": "scope", "description": "Filter by scope", "type": "string", "enum": [ "builds", "functions", "runtime", "post-processing" ], "required": false, "in": "query" }, { "name": "site_id", "description": "If specified, only return environment variables set on this site", "type": "string", "required": false, "in": "query" } ], "responses": { "200": { "description": "OK", "schema": { "type": "array", "items": { "type": "object", "properties": { "key": { "type": "string", "description": "The environment variable key, like ALGOLIA_ID (case-sensitive)", "x-faker": "commerce.productName" }, "scopes": { "type": "array", "items": { "type": "string", "enum": [ "builds", "functions", "runtime", "post-processing" ] }, "description": "The scopes that this environment variable is set to" }, "values": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "description": "The environment variable value's universally unique ID", "x-faker": "datatype.uuid" }, "value": { "type": "string", "description": "The environment variable's unencrypted value", "x-faker": "internet.password" }, "context": { "type": "string", "enum": [ "all", "dev", "branch-deploy", "deploy-preview", "production", "branch" ], "description": "The deploy context in which this value will be used. `dev` refers to local development when running `netlify dev`." }, "context_parameter": { "type": "string", "description": "An additional parameter for custom branches. Currently, this is used for specifying a branch name when `context=branch`." } }, "description": "Environment variable value model definition" }, "description": "An array of Value objects containing values and metadata", "x-faker": "internet.password" }, "is_secret": { "type": "boolean", "description": "Secret values are only readable by code running on Netlify's systems. With secrets, only the local development context values are readable from the UI, API, and CLI. By default, environment variable values are not secret." }, "updated_at": { "type": "string", "format": "date-time", "description": "The timestamp of when the value was last updated", "x-faker": "date.past" }, "updated_by": { "type": "object", "properties": { "id": { "type": "string", "description": "The user's unique identifier", "x-faker": "datatype.number" }, "full_name": { "type": "string", "description": "The user's full name (first and last)", "x-faker": "name.findName" }, "email": { "type": "string", "description": "The user's email address", "x-faker": "internet.email" }, "avatar_url": { "type": "string", "description": "A URL pointing to the user's avatar", "x-faker": "internet.avatar" } } } }, "description": "Environment variable model definition" } } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } }, "description": "Returns all environment variables for an account or site. An account corresponds to a team in the Netlify UI." }, "post": { "tags": [ "environmentVariables" ], "operationId": "createEnvVars", "description": "Creates new environment variables. Granular scopes are available on Pro plans and above.", "parameters": [ { "in": "body", "name": "env_vars", "schema": { "type": "array", "items": { "type": "object", "properties": { "key": { "type": "string", "description": "The existing or new name of the key, if you wish to rename it (case-sensitive)" }, "scopes": { "description": "The scopes that this environment variable is set to (Pro plans and above)", "type": "array", "items": { "type": "string", "enum": [ "builds", "functions", "runtime", "post-processing" ] } }, "values": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "description": "The environment variable value's universally unique ID", "x-faker": "datatype.uuid" }, "value": { "type": "string", "description": "The environment variable's unencrypted value", "x-faker": "internet.password" }, "context": { "type": "string", "enum": [ "all", "dev", "branch-deploy", "deploy-preview", "production", "branch" ], "description": "The deploy context in which this value will be used. `dev` refers to local development when running `netlify dev`." }, "context_parameter": { "type": "string", "description": "An additional parameter for custom branches. Currently, this is used for specifying a branch name when `context=branch`." } }, "description": "Environment variable value model definition" } }, "is_secret": { "type": "boolean", "description": "Secret values are only readable by code running on Netlify's systems. With secrets, only the local development context values are readable from the UI, API, and CLI. By default, environment variable values are not secret." } } } } }, { "name": "account_id", "description": "Scope response to account_id", "type": "string", "required": true, "in": "path" }, { "name": "site_id", "description": "If provided, create an environment variable on the site level, not the account level", "type": "string", "required": false, "in": "query" } ], "responses": { "201": { "description": "OK", "schema": { "type": "array", "items": { "type": "object", "properties": { "key": { "type": "string", "description": "The environment variable key, like ALGOLIA_ID (case-sensitive)", "x-faker": "commerce.productName" }, "scopes": { "type": "array", "items": { "type": "string", "enum": [ "builds", "functions", "runtime", "post-processing" ] }, "description": "The scopes that this environment variable is set to" }, "values": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "description": "The environment variable value's universally unique ID", "x-faker": "datatype.uuid" }, "value": { "type": "string", "description": "The environment variable's unencrypted value", "x-faker": "internet.password" }, "context": { "type": "string", "enum": [ "all", "dev", "branch-deploy", "deploy-preview", "production", "branch" ], "description": "The deploy context in which this value will be used. `dev` refers to local development when running `netlify dev`." }, "context_parameter": { "type": "string", "description": "An additional parameter for custom branches. Currently, this is used for specifying a branch name when `context=branch`." } }, "description": "Environment variable value model definition" }, "description": "An array of Value objects containing values and metadata", "x-faker": "internet.password" }, "is_secret": { "type": "boolean", "description": "Secret values are only readable by code running on Netlify's systems. With secrets, only the local development context values are readable from the UI, API, and CLI. By default, environment variable values are not secret." }, "updated_at": { "type": "string", "format": "date-time", "description": "The timestamp of when the value was last updated", "x-faker": "date.past" }, "updated_by": { "type": "object", "properties": { "id": { "type": "string", "description": "The user's unique identifier", "x-faker": "datatype.number" }, "full_name": { "type": "string", "description": "The user's full name (first and last)", "x-faker": "name.findName" }, "email": { "type": "string", "description": "The user's email address", "x-faker": "internet.email" }, "avatar_url": { "type": "string", "description": "A URL pointing to the user's avatar", "x-faker": "internet.avatar" } } } }, "description": "Environment variable model definition" } } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } } }, "/api/v1/sites/{site_id}/env": { "get": { "tags": [ "environmentVariables" ], "operationId": "getSiteEnvVars", "parameters": [ { "name": "context_name", "description": "Filter by deploy context", "required": false, "in": "query", "type": "string", "enum": [ "all", "dev", "branch-deploy", "deploy-preview", "production" ] }, { "name": "scope", "description": "Filter by scope", "required": false, "in": "query", "type": "string", "enum": [ "builds", "functions", "runtime", "post_processing" ] }, { "name": "site_id", "description": "Scope response to site_id", "required": true, "type": "string", "in": "path" } ], "responses": { "200": { "description": "OK", "schema": { "type": "array", "items": { "type": "object", "properties": { "key": { "type": "string", "description": "The environment variable key, like ALGOLIA_ID (case-sensitive)", "x-faker": "commerce.productName" }, "scopes": { "type": "array", "items": { "type": "string", "enum": [ "builds", "functions", "runtime", "post-processing" ] }, "description": "The scopes that this environment variable is set to" }, "values": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "description": "The environment variable value's universally unique ID", "x-faker": "datatype.uuid" }, "value": { "type": "string", "description": "The environment variable's unencrypted value", "x-faker": "internet.password" }, "context": { "type": "string", "enum": [ "all", "dev", "branch-deploy", "deploy-preview", "production", "branch" ], "description": "The deploy context in which this value will be used. `dev` refers to local development when running `netlify dev`." }, "context_parameter": { "type": "string", "description": "An additional parameter for custom branches. Currently, this is used for specifying a branch name when `context=branch`." } }, "description": "Environment variable value model definition" }, "description": "An array of Value objects containing values and metadata", "x-faker": "internet.password" }, "is_secret": { "type": "boolean", "description": "Secret values are only readable by code running on Netlify's systems. With secrets, only the local development context values are readable from the UI, API, and CLI. By default, environment variable values are not secret." }, "updated_at": { "type": "string", "format": "date-time", "description": "The timestamp of when the value was last updated", "x-faker": "date.past" }, "updated_by": { "type": "object", "properties": { "id": { "type": "string", "description": "The user's unique identifier", "x-faker": "datatype.number" }, "full_name": { "type": "string", "description": "The user's full name (first and last)", "x-faker": "name.findName" }, "email": { "type": "string", "description": "The user's email address", "x-faker": "internet.email" }, "avatar_url": { "type": "string", "description": "A URL pointing to the user's avatar", "x-faker": "internet.avatar" } } } }, "description": "Environment variable model definition" } } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } }, "description": "Returns all environment variables for a site. This convenience method behaves the same as `getEnvVars` but doesn't require an `account_id` as input." } }, "/accounts/{account_id}/env/{key}": { "get": { "tags": [ "environmentVariables" ], "operationId": "getEnvVar", "parameters": [ { "name": "account_id", "description": "Scope response to account_id", "type": "string", "required": true, "in": "path" }, { "name": "key", "description": "The environment variable key (case-sensitive)", "type": "string", "required": true, "in": "path" }, { "name": "site_id", "description": "If provided, return the environment variable for a specific site (no merging is performed)", "type": "string", "required": false, "in": "query" } ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "properties": { "key": { "type": "string", "description": "The environment variable key, like ALGOLIA_ID (case-sensitive)", "x-faker": "commerce.productName" }, "scopes": { "type": "array", "items": { "type": "string", "enum": [ "builds", "functions", "runtime", "post-processing" ] }, "description": "The scopes that this environment variable is set to" }, "values": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "description": "The environment variable value's universally unique ID", "x-faker": "datatype.uuid" }, "value": { "type": "string", "description": "The environment variable's unencrypted value", "x-faker": "internet.password" }, "context": { "type": "string", "enum": [ "all", "dev", "branch-deploy", "deploy-preview", "production", "branch" ], "description": "The deploy context in which this value will be used. `dev` refers to local development when running `netlify dev`." }, "context_parameter": { "type": "string", "description": "An additional parameter for custom branches. Currently, this is used for specifying a branch name when `context=branch`." } }, "description": "Environment variable value model definition" }, "description": "An array of Value objects containing values and metadata", "x-faker": "internet.password" }, "is_secret": { "type": "boolean", "description": "Secret values are only readable by code running on Netlify's systems. With secrets, only the local development context values are readable from the UI, API, and CLI. By default, environment variable values are not secret." }, "updated_at": { "type": "string", "format": "date-time", "description": "The timestamp of when the value was last updated", "x-faker": "date.past" }, "updated_by": { "type": "object", "properties": { "id": { "type": "string", "description": "The user's unique identifier", "x-faker": "datatype.number" }, "full_name": { "type": "string", "description": "The user's full name (first and last)", "x-faker": "name.findName" }, "email": { "type": "string", "description": "The user's email address", "x-faker": "internet.email" }, "avatar_url": { "type": "string", "description": "A URL pointing to the user's avatar", "x-faker": "internet.avatar" } } } }, "description": "Environment variable model definition" } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } }, "description": "Returns an individual environment variable." }, "put": { "tags": [ "environmentVariables" ], "operationId": "updateEnvVar", "description": "Updates an existing environment variable and all of its values. Existing values will be replaced by values provided.", "parameters": [ { "name": "account_id", "description": "Scope response to account_id", "type": "string", "required": true, "in": "path" }, { "name": "key", "description": "The existing environment variable key name (case-sensitive)", "type": "string", "required": true, "in": "path" }, { "in": "body", "name": "env_var", "schema": { "type": "object", "properties": { "key": { "type": "string", "description": "The existing or new name of the key, if you wish to rename it (case-sensitive)" }, "scopes": { "description": "The scopes that this environment variable is set to (Pro plans and above)", "type": "array", "items": { "type": "string", "enum": [ "builds", "functions", "runtime", "post-processing" ] } }, "values": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "description": "The environment variable value's universally unique ID", "x-faker": "datatype.uuid" }, "value": { "type": "string", "description": "The environment variable's unencrypted value", "x-faker": "internet.password" }, "context": { "type": "string", "enum": [ "all", "dev", "branch-deploy", "deploy-preview", "production", "branch" ], "description": "The deploy context in which this value will be used. `dev` refers to local development when running `netlify dev`." }, "context_parameter": { "type": "string", "description": "An additional parameter for custom branches. Currently, this is used for specifying a branch name when `context=branch`." } }, "description": "Environment variable value model definition" } }, "is_secret": { "type": "boolean", "description": "Secret values are only readable by code running on Netlify's systems. With secrets, only the local development context values are readable from the UI, API, and CLI. By default, environment variable values are not secret." } } } }, { "name": "site_id", "description": "If provided, update an environment variable set on this site", "type": "string", "required": false, "in": "query" } ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "properties": { "key": { "type": "string", "description": "The environment variable key, like ALGOLIA_ID (case-sensitive)", "x-faker": "commerce.productName" }, "scopes": { "type": "array", "items": { "type": "string", "enum": [ "builds", "functions", "runtime", "post-processing" ] }, "description": "The scopes that this environment variable is set to" }, "values": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "description": "The environment variable value's universally unique ID", "x-faker": "datatype.uuid" }, "value": { "type": "string", "description": "The environment variable's unencrypted value", "x-faker": "internet.password" }, "context": { "type": "string", "enum": [ "all", "dev", "branch-deploy", "deploy-preview", "production", "branch" ], "description": "The deploy context in which this value will be used. `dev` refers to local development when running `netlify dev`." }, "context_parameter": { "type": "string", "description": "An additional parameter for custom branches. Currently, this is used for specifying a branch name when `context=branch`." } }, "description": "Environment variable value model definition" }, "description": "An array of Value objects containing values and metadata", "x-faker": "internet.password" }, "is_secret": { "type": "boolean", "description": "Secret values are only readable by code running on Netlify's systems. With secrets, only the local development context values are readable from the UI, API, and CLI. By default, environment variable values are not secret." }, "updated_at": { "type": "string", "format": "date-time", "description": "The timestamp of when the value was last updated", "x-faker": "date.past" }, "updated_by": { "type": "object", "properties": { "id": { "type": "string", "description": "The user's unique identifier", "x-faker": "datatype.number" }, "full_name": { "type": "string", "description": "The user's full name (first and last)", "x-faker": "name.findName" }, "email": { "type": "string", "description": "The user's email address", "x-faker": "internet.email" }, "avatar_url": { "type": "string", "description": "A URL pointing to the user's avatar", "x-faker": "internet.avatar" } } } }, "description": "Environment variable model definition" } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } }, "patch": { "tags": [ "environmentVariables" ], "operationId": "setEnvVarValue", "description": "Updates or creates a new value for an existing environment variable.", "parameters": [ { "name": "account_id", "description": "Scope response to account_id", "required": true, "type": "string", "in": "path" }, { "name": "key", "description": "The existing environment variable key name (case-sensitive)", "required": true, "type": "string", "in": "path" }, { "name": "site_id", "description": "If provided, update an environment variable set on this site", "in": "query", "type": "string" }, { "in": "body", "name": "env_var", "schema": { "type": "object", "properties": { "context": { "description": "The deploy context in which this value will be used. `dev` refers to local development when running `netlify dev`. `branch` must be provided with a value in `context_parameter`.", "type": "string", "enum": [ "all", "dev", "branch-deploy", "deploy-preview", "production", "branch" ] }, "context_parameter": { "description": "An additional parameter for custom branches. Currently, this is used for providing a branch name when `context=branch`.", "type": "string" }, "value": { "description": "The environment variable's unencrypted value", "type": "string" } } } } ], "responses": { "201": { "description": "Created (success)", "schema": { "type": "object", "properties": { "key": { "type": "string", "description": "The environment variable key, like ALGOLIA_ID (case-sensitive)", "x-faker": "commerce.productName" }, "scopes": { "type": "array", "items": { "type": "string", "enum": [ "builds", "functions", "runtime", "post-processing" ] }, "description": "The scopes that this environment variable is set to" }, "values": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "description": "The environment variable value's universally unique ID", "x-faker": "datatype.uuid" }, "value": { "type": "string", "description": "The environment variable's unencrypted value", "x-faker": "internet.password" }, "context": { "type": "string", "enum": [ "all", "dev", "branch-deploy", "deploy-preview", "production", "branch" ], "description": "The deploy context in which this value will be used. `dev` refers to local development when running `netlify dev`." }, "context_parameter": { "type": "string", "description": "An additional parameter for custom branches. Currently, this is used for specifying a branch name when `context=branch`." } }, "description": "Environment variable value model definition" }, "description": "An array of Value objects containing values and metadata", "x-faker": "internet.password" }, "is_secret": { "type": "boolean", "description": "Secret values are only readable by code running on Netlify's systems. With secrets, only the local development context values are readable from the UI, API, and CLI. By default, environment variable values are not secret." }, "updated_at": { "type": "string", "format": "date-time", "description": "The timestamp of when the value was last updated", "x-faker": "date.past" }, "updated_by": { "type": "object", "properties": { "id": { "type": "string", "description": "The user's unique identifier", "x-faker": "datatype.number" }, "full_name": { "type": "string", "description": "The user's full name (first and last)", "x-faker": "name.findName" }, "email": { "type": "string", "description": "The user's email address", "x-faker": "internet.email" }, "avatar_url": { "type": "string", "description": "A URL pointing to the user's avatar", "x-faker": "internet.avatar" } } } }, "description": "Environment variable model definition" } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } }, "delete": { "tags": [ "environmentVariables" ], "operationId": "deleteEnvVar", "parameters": [ { "name": "account_id", "description": "Scope response to account_id", "type": "string", "required": true, "in": "path" }, { "name": "key", "description": "The environment variable key (case-sensitive)", "type": "string", "required": true, "in": "path" }, { "name": "site_id", "description": "If provided, delete the environment variable from this site", "type": "string", "required": false, "in": "query" } ], "responses": { "204": { "description": "No Content (success)" }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } }, "description": "Deletes an environment variable" } }, "/accounts/{account_id}/env/{key}/value/{id}": { "delete": { "tags": [ "environmentVariables" ], "operationId": "deleteEnvVarValue", "parameters": [ { "name": "account_id", "description": "Scope response to account_id", "required": true, "in": "path", "type": "string" }, { "name": "id", "description": "The environment variable value's ID", "type": "string", "required": true, "in": "path" }, { "name": "key", "description": "The environment variable key name (case-sensitive)", "type": "string", "required": true, "in": "path" }, { "name": "site_id", "description": "If provided, delete the value from an environment variable on this site", "type": "string", "required": false, "in": "query" } ], "responses": { "204": { "description": "No Content (success)" }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } }, "description": "Deletes a specific environment variable value." } }, "/sites/{site_id}/functions": { "get": { "operationId": "searchSiteFunctions", "tags": [ "function" ], "parameters": [ { "name": "site_id", "type": "string", "in": "path", "required": true }, { "name": "filter", "type": "string", "in": "query", "required": false } ], "responses": { "200": { "description": "OK", "schema": { "type": "array", "items": { "type": "object", "properties": { "branch": { "type": "string" }, "created_at": { "type": "string", "format": "dateTime" }, "functions": { "type": "array", "items": { "type": "object" } }, "id": { "type": "string" }, "log_type": { "type": "string" }, "provider": { "type": "string" } } } } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } } }, "/sites/{site_id}/forms": { "get": { "operationId": "listSiteForms", "tags": [ "form" ], "parameters": [ { "name": "site_id", "type": "string", "in": "path", "required": true } ], "responses": { "200": { "description": "OK", "schema": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "site_id": { "type": "string" }, "name": { "type": "string" }, "paths": { "type": "array", "items": { "type": "string" } }, "submission_count": { "type": "integer", "format": "int32" }, "fields": { "type": "array", "items": { "type": "object" } }, "created_at": { "type": "string", "format": "dateTime" } } } } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } } }, "/sites/{site_id}/forms/{form_id}": { "delete": { "operationId": "deleteSiteForm", "tags": [ "form" ], "parameters": [ { "name": "site_id", "type": "string", "in": "path", "required": true }, { "name": "form_id", "type": "string", "in": "path", "required": true } ], "responses": { "204": { "description": "Deleted" }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } } }, "/sites/{site_id}/submissions": { "get": { "operationId": "listSiteSubmissions", "tags": [ "submission" ], "parameters": [ { "name": "site_id", "type": "string", "in": "path", "required": true }, { "type": "integer", "format": "int32", "name": "page", "required": false, "in": "query" }, { "type": "integer", "format": "int32", "name": "per_page", "required": false, "in": "query" } ], "responses": { "200": { "description": "OK", "schema": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "number": { "type": "integer", "format": "int32" }, "email": { "type": "string" }, "name": { "type": "string" }, "first_name": { "type": "string" }, "last_name": { "type": "string" }, "company": { "type": "string" }, "summary": { "type": "string" }, "body": { "type": "string" }, "data": { "type": "object" }, "created_at": { "type": "string", "format": "dateTime" }, "site_url": { "type": "string" } } } } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } } }, "/sites/{site_id}/files": { "get": { "operationId": "listSiteFiles", "tags": [ "file" ], "parameters": [ { "name": "site_id", "type": "string", "in": "path", "required": true } ], "responses": { "200": { "description": "OK", "schema": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "path": { "type": "string" }, "sha": { "type": "string" }, "mime_type": { "type": "string" }, "size": { "type": "integer", "format": "int64" } } } } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } } }, "/sites/{site_id}/assets": { "parameters": [ { "name": "site_id", "type": "string", "in": "path", "required": true } ], "get": { "operationId": "listSiteAssets", "tags": [ "asset" ], "responses": { "200": { "description": "OK", "schema": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "site_id": { "type": "string" }, "creator_id": { "type": "string" }, "name": { "type": "string" }, "state": { "type": "string" }, "content_type": { "type": "string" }, "url": { "type": "string" }, "key": { "type": "string" }, "visibility": { "type": "string" }, "size": { "type": "integer", "format": "int64" }, "created_at": { "type": "string", "format": "dateTime" }, "updated_at": { "type": "string", "format": "dateTime" } } } } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } }, "post": { "operationId": "createSiteAsset", "tags": [ "asset" ], "parameters": [ { "name": "name", "type": "string", "in": "query", "required": true }, { "name": "size", "type": "integer", "format": "int64", "in": "query", "required": true }, { "name": "content_type", "type": "string", "in": "query", "required": true }, { "name": "visibility", "type": "string", "in": "query" } ], "responses": { "201": { "description": "Created", "schema": { "type": "object", "properties": { "form": { "type": "object", "properties": { "url": { "type": "string" }, "fields": { "type": "object", "additionalProperties": { "type": "string" } } } }, "asset": { "type": "object", "properties": { "id": { "type": "string" }, "site_id": { "type": "string" }, "creator_id": { "type": "string" }, "name": { "type": "string" }, "state": { "type": "string" }, "content_type": { "type": "string" }, "url": { "type": "string" }, "key": { "type": "string" }, "visibility": { "type": "string" }, "size": { "type": "integer", "format": "int64" }, "created_at": { "type": "string", "format": "dateTime" }, "updated_at": { "type": "string", "format": "dateTime" } } } } } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } } }, "/sites/{site_id}/assets/{asset_id}": { "parameters": [ { "name": "site_id", "type": "string", "in": "path", "required": true }, { "name": "asset_id", "type": "string", "in": "path", "required": true } ], "get": { "operationId": "getSiteAssetInfo", "tags": [ "asset" ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "properties": { "id": { "type": "string" }, "site_id": { "type": "string" }, "creator_id": { "type": "string" }, "name": { "type": "string" }, "state": { "type": "string" }, "content_type": { "type": "string" }, "url": { "type": "string" }, "key": { "type": "string" }, "visibility": { "type": "string" }, "size": { "type": "integer", "format": "int64" }, "created_at": { "type": "string", "format": "dateTime" }, "updated_at": { "type": "string", "format": "dateTime" } } } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } }, "put": { "operationId": "updateSiteAsset", "tags": [ "asset" ], "parameters": [ { "name": "state", "type": "string", "in": "query", "required": true } ], "responses": { "200": { "description": "Updated", "schema": { "type": "object", "properties": { "id": { "type": "string" }, "site_id": { "type": "string" }, "creator_id": { "type": "string" }, "name": { "type": "string" }, "state": { "type": "string" }, "content_type": { "type": "string" }, "url": { "type": "string" }, "key": { "type": "string" }, "visibility": { "type": "string" }, "size": { "type": "integer", "format": "int64" }, "created_at": { "type": "string", "format": "dateTime" }, "updated_at": { "type": "string", "format": "dateTime" } } } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } }, "delete": { "operationId": "deleteSiteAsset", "tags": [ "asset" ], "responses": { "204": { "description": "Deleted" }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } } }, "/sites/{site_id}/assets/{asset_id}/public_signature": { "parameters": [ { "name": "site_id", "type": "string", "in": "path", "required": true }, { "name": "asset_id", "type": "string", "in": "path", "required": true } ], "get": { "operationId": "getSiteAssetPublicSignature", "tags": [ "assetPublicSignature" ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "properties": { "url": { "type": "string" } } } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } } }, "/sites/{site_id}/files/{file_path}": { "get": { "operationId": "getSiteFileByPathName", "tags": [ "file" ], "parameters": [ { "name": "site_id", "type": "string", "in": "path", "required": true }, { "name": "file_path", "type": "string", "in": "path", "required": true } ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "properties": { "id": { "type": "string" }, "path": { "type": "string" }, "sha": { "type": "string" }, "mime_type": { "type": "string" }, "size": { "type": "integer", "format": "int64" } } } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } } }, "/purge": { "post": { "operationId": "purgeCache", "description": "Purges cached content from Netlify's CDN. Supports purging by Cache-Tag.", "tags": [ "purge" ], "consumes": [ "application/json" ], "parameters": [ { "name": "payload", "in": "body", "schema": { "type": "object", "properties": { "site_id": { "type": "string" }, "site_slug": { "type": "string" }, "cache_tags": { "type": "array", "items": { "type": "string" } } } }, "required": true } ], "responses": { "202": { "description": "OK" }, "400": { "description": "Invalid request parameters" }, "404": { "description": "Site not found" } } } }, "/sites/{site_id}/snippets": { "parameters": [ { "name": "site_id", "type": "string", "in": "path", "required": true } ], "get": { "operationId": "listSiteSnippets", "tags": [ "snippet" ], "responses": { "200": { "description": "OK", "schema": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer", "format": "int32" }, "site_id": { "type": "string" }, "title": { "type": "string" }, "general": { "type": "string" }, "general_position": { "type": "string" }, "goal": { "type": "string" }, "goal_position": { "type": "string" } } } } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } }, "post": { "operationId": "createSiteSnippet", "tags": [ "snippet" ], "consumes": [ "application/json" ], "parameters": [ { "name": "snippet", "in": "body", "schema": { "type": "object", "properties": { "id": { "type": "integer", "format": "int32" }, "site_id": { "type": "string" }, "title": { "type": "string" }, "general": { "type": "string" }, "general_position": { "type": "string" }, "goal": { "type": "string" }, "goal_position": { "type": "string" } } }, "required": true } ], "responses": { "201": { "description": "OK", "schema": { "type": "object", "properties": { "id": { "type": "integer", "format": "int32" }, "site_id": { "type": "string" }, "title": { "type": "string" }, "general": { "type": "string" }, "general_position": { "type": "string" }, "goal": { "type": "string" }, "goal_position": { "type": "string" } } } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } } }, "/sites/{site_id}/snippets/{snippet_id}": { "parameters": [ { "name": "site_id", "type": "string", "in": "path", "required": true }, { "name": "snippet_id", "type": "string", "in": "path", "required": true } ], "get": { "operationId": "getSiteSnippet", "tags": [ "snippet" ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "properties": { "id": { "type": "integer", "format": "int32" }, "site_id": { "type": "string" }, "title": { "type": "string" }, "general": { "type": "string" }, "general_position": { "type": "string" }, "goal": { "type": "string" }, "goal_position": { "type": "string" } } } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } }, "put": { "operationId": "updateSiteSnippet", "tags": [ "snippet" ], "consumes": [ "application/json" ], "parameters": [ { "name": "snippet", "in": "body", "schema": { "type": "object", "properties": { "id": { "type": "integer", "format": "int32" }, "site_id": { "type": "string" }, "title": { "type": "string" }, "general": { "type": "string" }, "general_position": { "type": "string" }, "goal": { "type": "string" }, "goal_position": { "type": "string" } } }, "required": true } ], "responses": { "204": { "description": "No content" }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } }, "delete": { "operationId": "deleteSiteSnippet", "tags": [ "snippet" ], "responses": { "204": { "description": "No content" }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } } }, "/sites/{site_id}/metadata": { "parameters": [ { "name": "site_id", "type": "string", "in": "path", "required": true } ], "get": { "operationId": "getSiteMetadata", "tags": [ "metadata" ], "responses": { "200": { "description": "OK", "schema": { "type": "object" } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } }, "put": { "operationId": "updateSiteMetadata", "tags": [ "metadata" ], "parameters": [ { "name": "metadata", "in": "body", "schema": { "type": "object" }, "required": true } ], "responses": { "204": { "description": "No content" }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } } }, "/sites/{site_id}/build_hooks": { "parameters": [ { "name": "site_id", "type": "string", "in": "path", "required": true } ], "get": { "operationId": "listSiteBuildHooks", "tags": [ "buildHook" ], "responses": { "200": { "description": "OK", "schema": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "title": { "type": "string" }, "branch": { "type": "string" }, "url": { "type": "string" }, "site_id": { "type": "string" }, "created_at": { "type": "string", "format": "dateTime" } } } } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } }, "post": { "operationId": "createSiteBuildHook", "tags": [ "buildHook" ], "consumes": [ "application/json" ], "parameters": [ { "name": "buildHook", "in": "body", "schema": { "type": "object", "properties": { "title": { "type": "string" }, "branch": { "type": "string" } } }, "required": true } ], "responses": { "201": { "description": "Created", "schema": { "type": "object", "properties": { "id": { "type": "string" }, "title": { "type": "string" }, "branch": { "type": "string" }, "url": { "type": "string" }, "site_id": { "type": "string" }, "created_at": { "type": "string", "format": "dateTime" } } } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } } }, "/sites/{site_id}/build_hooks/{id}": { "parameters": [ { "name": "site_id", "type": "string", "in": "path", "required": true }, { "name": "id", "type": "string", "in": "path", "required": true } ], "get": { "operationId": "getSiteBuildHook", "tags": [ "buildHook" ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "properties": { "id": { "type": "string" }, "title": { "type": "string" }, "branch": { "type": "string" }, "url": { "type": "string" }, "site_id": { "type": "string" }, "created_at": { "type": "string", "format": "dateTime" } } } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } }, "put": { "operationId": "updateSiteBuildHook", "tags": [ "buildHook" ], "consumes": [ "application/json" ], "parameters": [ { "name": "buildHook", "in": "body", "schema": { "type": "object", "properties": { "title": { "type": "string" }, "branch": { "type": "string" } } }, "required": true } ], "responses": { "204": { "description": "No content" }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } }, "delete": { "operationId": "deleteSiteBuildHook", "tags": [ "buildHook" ], "responses": { "204": { "description": "No content" }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } } }, "/sites/{site_id}/deploys": { "parameters": [ { "name": "site_id", "type": "string", "in": "path", "required": true }, { "name": "deploy-previews", "type": "boolean", "in": "query" }, { "name": "production", "type": "boolean", "in": "query" }, { "name": "state", "type": "string", "enum": [ "new", "pending_review", "accepted", "rejected", "enqueued", "building", "uploading", "uploaded", "preparing", "prepared", "processing", "processed", "ready", "error", "retrying" ], "in": "query" }, { "name": "branch", "type": "string", "in": "query" }, { "name": "latest-published", "type": "boolean", "in": "query" } ], "get": { "operationId": "listSiteDeploys", "tags": [ "deploy" ], "parameters": [ { "type": "integer", "format": "int32", "name": "page", "required": false, "in": "query" }, { "type": "integer", "format": "int32", "name": "per_page", "required": false, "in": "query" } ], "responses": { "200": { "description": "OK", "schema": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "site_id": { "type": "string" }, "user_id": { "type": "string" }, "build_id": { "type": "string" }, "state": { "type": "string" }, "name": { "type": "string" }, "url": { "type": "string" }, "ssl_url": { "type": "string" }, "admin_url": { "type": "string" }, "deploy_url": { "type": "string" }, "deploy_ssl_url": { "type": "string" }, "screenshot_url": { "type": "string" }, "review_id": { "type": "number" }, "draft": { "type": "boolean" }, "required": { "type": "array", "items": { "type": "string" } }, "required_functions": { "type": "array", "items": { "type": "string" } }, "error_message": { "type": "string" }, "branch": { "type": "string" }, "commit_ref": { "type": "string" }, "commit_url": { "type": "string" }, "skipped": { "type": "boolean" }, "created_at": { "type": "string", "format": "dateTime" }, "updated_at": { "type": "string", "format": "dateTime" }, "published_at": { "type": "string", "format": "dateTime" }, "title": { "type": "string" }, "context": { "type": "string" }, "locked": { "type": "boolean" }, "review_url": { "type": "string" }, "framework": { "type": "string" }, "function_schedules": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "cron": { "type": "string" } } } } } } } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } }, "post": { "operationId": "createSiteDeploy", "tags": [ "deploy" ], "parameters": [ { "name": "title", "type": "string", "in": "query" }, { "name": "deploy", "in": "body", "schema": { "type": "object", "properties": { "files": { "type": "object" }, "draft": { "type": "boolean" }, "async": { "type": "boolean" }, "functions": { "type": "object" }, "function_schedules": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "cron": { "type": "string" } } } }, "functions_config": { "type": "object", "additionalProperties": { "type": "object", "properties": { "display_name": { "type": "string" }, "generator": { "type": "string" }, "build_data": { "type": "object" }, "routes": { "type": "array", "items": { "type": "object", "properties": { "pattern": { "type": "string" }, "literal": { "type": "string" }, "expression": { "type": "string" }, "methods": { "type": "array", "items": { "type": "string", "enum": [ "GET", "POST", "PUT", "PATCH", "DELETE", "OPTIONS" ] } }, "prefer_static": { "type": "boolean" } } } }, "excluded_routes": { "type": "array", "items": { "type": "object", "properties": { "pattern": { "type": "string" }, "literal": { "type": "string" }, "expression": { "type": "string" } } } }, "priority": { "type": "integer" }, "traffic_rules": { "type": "object", "properties": { "action": { "type": "object", "properties": { "type": { "type": "string" }, "config": { "type": "object", "properties": { "to": { "type": "string" }, "rate_limit_config": { "type": "object", "properties": { "algorithm": { "type": "string", "enum": [ "sliding_window" ] }, "window_size": { "type": "integer" }, "window_limit": { "type": "integer" } } }, "aggregate": { "type": "object", "properties": { "keys": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "ip", "domain" ] } } } } } } } } } } } } } } }, "branch": { "type": "string" }, "framework": { "type": "string" }, "framework_version": { "type": "string" } } }, "required": true } ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "properties": { "id": { "type": "string" }, "site_id": { "type": "string" }, "user_id": { "type": "string" }, "build_id": { "type": "string" }, "state": { "type": "string" }, "name": { "type": "string" }, "url": { "type": "string" }, "ssl_url": { "type": "string" }, "admin_url": { "type": "string" }, "deploy_url": { "type": "string" }, "deploy_ssl_url": { "type": "string" }, "screenshot_url": { "type": "string" }, "review_id": { "type": "number" }, "draft": { "type": "boolean" }, "required": { "type": "array", "items": { "type": "string" } }, "required_functions": { "type": "array", "items": { "type": "string" } }, "error_message": { "type": "string" }, "branch": { "type": "string" }, "commit_ref": { "type": "string" }, "commit_url": { "type": "string" }, "skipped": { "type": "boolean" }, "created_at": { "type": "string", "format": "dateTime" }, "updated_at": { "type": "string", "format": "dateTime" }, "published_at": { "type": "string", "format": "dateTime" }, "title": { "type": "string" }, "context": { "type": "string" }, "locked": { "type": "boolean" }, "review_url": { "type": "string" }, "framework": { "type": "string" }, "function_schedules": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "cron": { "type": "string" } } } } } } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } } }, "/sites/{site_id}/deploys/{deploy_id}": { "get": { "operationId": "getSiteDeploy", "tags": [ "deploy" ], "parameters": [ { "name": "site_id", "type": "string", "in": "path", "required": true }, { "name": "deploy_id", "type": "string", "in": "path", "required": true } ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "properties": { "id": { "type": "string" }, "site_id": { "type": "string" }, "user_id": { "type": "string" }, "build_id": { "type": "string" }, "state": { "type": "string" }, "name": { "type": "string" }, "url": { "type": "string" }, "ssl_url": { "type": "string" }, "admin_url": { "type": "string" }, "deploy_url": { "type": "string" }, "deploy_ssl_url": { "type": "string" }, "screenshot_url": { "type": "string" }, "review_id": { "type": "number" }, "draft": { "type": "boolean" }, "required": { "type": "array", "items": { "type": "string" } }, "required_functions": { "type": "array", "items": { "type": "string" } }, "error_message": { "type": "string" }, "branch": { "type": "string" }, "commit_ref": { "type": "string" }, "commit_url": { "type": "string" }, "skipped": { "type": "boolean" }, "created_at": { "type": "string", "format": "dateTime" }, "updated_at": { "type": "string", "format": "dateTime" }, "published_at": { "type": "string", "format": "dateTime" }, "title": { "type": "string" }, "context": { "type": "string" }, "locked": { "type": "boolean" }, "review_url": { "type": "string" }, "framework": { "type": "string" }, "function_schedules": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "cron": { "type": "string" } } } } } } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } }, "put": { "operationId": "updateSiteDeploy", "tags": [ "deploy" ], "parameters": [ { "name": "site_id", "type": "string", "in": "path", "required": true }, { "name": "deploy_id", "type": "string", "in": "path", "required": true }, { "name": "deploy", "in": "body", "schema": { "type": "object", "properties": { "files": { "type": "object" }, "draft": { "type": "boolean" }, "async": { "type": "boolean" }, "functions": { "type": "object" }, "function_schedules": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "cron": { "type": "string" } } } }, "functions_config": { "type": "object", "additionalProperties": { "type": "object", "properties": { "display_name": { "type": "string" }, "generator": { "type": "string" }, "build_data": { "type": "object" }, "routes": { "type": "array", "items": { "type": "object", "properties": { "pattern": { "type": "string" }, "literal": { "type": "string" }, "expression": { "type": "string" }, "methods": { "type": "array", "items": { "type": "string", "enum": [ "GET", "POST", "PUT", "PATCH", "DELETE", "OPTIONS" ] } }, "prefer_static": { "type": "boolean" } } } }, "excluded_routes": { "type": "array", "items": { "type": "object", "properties": { "pattern": { "type": "string" }, "literal": { "type": "string" }, "expression": { "type": "string" } } } }, "priority": { "type": "integer" }, "traffic_rules": { "type": "object", "properties": { "action": { "type": "object", "properties": { "type": { "type": "string" }, "config": { "type": "object", "properties": { "to": { "type": "string" }, "rate_limit_config": { "type": "object", "properties": { "algorithm": { "type": "string", "enum": [ "sliding_window" ] }, "window_size": { "type": "integer" }, "window_limit": { "type": "integer" } } }, "aggregate": { "type": "object", "properties": { "keys": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "ip", "domain" ] } } } } } } } } } } } } } } }, "branch": { "type": "string" }, "framework": { "type": "string" }, "framework_version": { "type": "string" } } }, "required": true } ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "properties": { "id": { "type": "string" }, "site_id": { "type": "string" }, "user_id": { "type": "string" }, "build_id": { "type": "string" }, "state": { "type": "string" }, "name": { "type": "string" }, "url": { "type": "string" }, "ssl_url": { "type": "string" }, "admin_url": { "type": "string" }, "deploy_url": { "type": "string" }, "deploy_ssl_url": { "type": "string" }, "screenshot_url": { "type": "string" }, "review_id": { "type": "number" }, "draft": { "type": "boolean" }, "required": { "type": "array", "items": { "type": "string" } }, "required_functions": { "type": "array", "items": { "type": "string" } }, "error_message": { "type": "string" }, "branch": { "type": "string" }, "commit_ref": { "type": "string" }, "commit_url": { "type": "string" }, "skipped": { "type": "boolean" }, "created_at": { "type": "string", "format": "dateTime" }, "updated_at": { "type": "string", "format": "dateTime" }, "published_at": { "type": "string", "format": "dateTime" }, "title": { "type": "string" }, "context": { "type": "string" }, "locked": { "type": "boolean" }, "review_url": { "type": "string" }, "framework": { "type": "string" }, "function_schedules": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "cron": { "type": "string" } } } } } } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } }, "delete": { "operationId": "deleteSiteDeploy", "tags": [ "deploy" ], "parameters": [ { "name": "deploy_id", "type": "string", "in": "path", "required": true }, { "name": "site_id", "type": "string", "in": "path", "required": true } ], "responses": { "204": { "description": "No content" }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } } }, "/deploys/{deploy_id}/cancel": { "post": { "operationId": "cancelSiteDeploy", "tags": [ "deploy" ], "parameters": [ { "name": "deploy_id", "type": "string", "in": "path", "required": true } ], "responses": { "201": { "description": "Cancelled", "schema": { "type": "object", "properties": { "id": { "type": "string" }, "site_id": { "type": "string" }, "user_id": { "type": "string" }, "build_id": { "type": "string" }, "state": { "type": "string" }, "name": { "type": "string" }, "url": { "type": "string" }, "ssl_url": { "type": "string" }, "admin_url": { "type": "string" }, "deploy_url": { "type": "string" }, "deploy_ssl_url": { "type": "string" }, "screenshot_url": { "type": "string" }, "review_id": { "type": "number" }, "draft": { "type": "boolean" }, "required": { "type": "array", "items": { "type": "string" } }, "required_functions": { "type": "array", "items": { "type": "string" } }, "error_message": { "type": "string" }, "branch": { "type": "string" }, "commit_ref": { "type": "string" }, "commit_url": { "type": "string" }, "skipped": { "type": "boolean" }, "created_at": { "type": "string", "format": "dateTime" }, "updated_at": { "type": "string", "format": "dateTime" }, "published_at": { "type": "string", "format": "dateTime" }, "title": { "type": "string" }, "context": { "type": "string" }, "locked": { "type": "boolean" }, "review_url": { "type": "string" }, "framework": { "type": "string" }, "function_schedules": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "cron": { "type": "string" } } } } } } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } } }, "/sites/{site_id}/deploys/{deploy_id}/restore": { "post": { "operationId": "restoreSiteDeploy", "tags": [ "deploy" ], "parameters": [ { "name": "site_id", "type": "string", "in": "path", "required": true }, { "name": "deploy_id", "type": "string", "in": "path", "required": true } ], "responses": { "201": { "description": "Created", "schema": { "type": "object", "properties": { "id": { "type": "string" }, "site_id": { "type": "string" }, "user_id": { "type": "string" }, "build_id": { "type": "string" }, "state": { "type": "string" }, "name": { "type": "string" }, "url": { "type": "string" }, "ssl_url": { "type": "string" }, "admin_url": { "type": "string" }, "deploy_url": { "type": "string" }, "deploy_ssl_url": { "type": "string" }, "screenshot_url": { "type": "string" }, "review_id": { "type": "number" }, "draft": { "type": "boolean" }, "required": { "type": "array", "items": { "type": "string" } }, "required_functions": { "type": "array", "items": { "type": "string" } }, "error_message": { "type": "string" }, "branch": { "type": "string" }, "commit_ref": { "type": "string" }, "commit_url": { "type": "string" }, "skipped": { "type": "boolean" }, "created_at": { "type": "string", "format": "dateTime" }, "updated_at": { "type": "string", "format": "dateTime" }, "published_at": { "type": "string", "format": "dateTime" }, "title": { "type": "string" }, "context": { "type": "string" }, "locked": { "type": "boolean" }, "review_url": { "type": "string" }, "framework": { "type": "string" }, "function_schedules": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "cron": { "type": "string" } } } } } } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } } }, "/sites/{site_id}/builds": { "parameters": [ { "name": "site_id", "type": "string", "in": "path", "required": true } ], "get": { "operationId": "listSiteBuilds", "tags": [ "build" ], "parameters": [ { "type": "integer", "format": "int32", "name": "page", "required": false, "in": "query" }, { "type": "integer", "format": "int32", "name": "per_page", "required": false, "in": "query" } ], "responses": { "200": { "description": "OK", "schema": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "deploy_id": { "type": "string" }, "sha": { "type": "string" }, "done": { "type": "boolean" }, "error": { "type": "string" }, "created_at": { "type": "string", "format": "dateTime" } } } } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } }, "post": { "operationId": "createSiteBuild", "tags": [ "build" ], "parameters": [ { "name": "build", "in": "body", "schema": { "type": "object", "properties": { "image": { "type": "string" }, "clear_cache": { "type": "boolean" } } }, "required": false } ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "properties": { "id": { "type": "string" }, "deploy_id": { "type": "string" }, "sha": { "type": "string" }, "done": { "type": "boolean" }, "error": { "type": "string" }, "created_at": { "type": "string", "format": "dateTime" } } } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } } }, "/sites/{site_id}/deployed-branches": { "parameters": [ { "name": "site_id", "type": "string", "in": "path", "required": true } ], "get": { "operationId": "listSiteDeployedBranches", "tags": [ "deployedBranch" ], "responses": { "200": { "description": "OK", "schema": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "deploy_id": { "type": "string" }, "name": { "type": "string" }, "slug": { "type": "string" }, "url": { "type": "string" }, "ssl_url": { "type": "string" } } } } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } } }, "/sites/{site_id}/unlink_repo": { "parameters": [ { "name": "site_id", "type": "string", "in": "path", "required": true } ], "put": { "operationId": "unlinkSiteRepo", "tags": [ "site" ], "description": "[Beta] Unlinks the repo from the site.\n\nThis action will also:\n- Delete associated deploy keys\n- Delete outgoing webhooks for the repo\n- Delete the site's build hooks", "responses": { "200": { "description": "OK", "schema": { "type": "object", "properties": { "id": { "type": "string" }, "state": { "type": "string" }, "plan": { "type": "string" }, "name": { "type": "string" }, "custom_domain": { "type": "string" }, "domain_aliases": { "type": "array", "items": { "type": "string" } }, "branch_deploy_custom_domain": { "type": "string" }, "deploy_preview_custom_domain": { "type": "string" }, "password": { "type": "string" }, "notification_email": { "type": "string" }, "url": { "type": "string" }, "ssl_url": { "type": "string" }, "admin_url": { "type": "string" }, "screenshot_url": { "type": "string" }, "created_at": { "type": "string", "format": "dateTime" }, "updated_at": { "type": "string", "format": "dateTime" }, "user_id": { "type": "string" }, "session_id": { "type": "string" }, "ssl": { "type": "boolean" }, "force_ssl": { "type": "boolean" }, "managed_dns": { "type": "boolean" }, "deploy_url": { "type": "string" }, "published_deploy": { "type": "object", "properties": { "id": { "type": "string" }, "site_id": { "type": "string" }, "user_id": { "type": "string" }, "build_id": { "type": "string" }, "state": { "type": "string" }, "name": { "type": "string" }, "url": { "type": "string" }, "ssl_url": { "type": "string" }, "admin_url": { "type": "string" }, "deploy_url": { "type": "string" }, "deploy_ssl_url": { "type": "string" }, "screenshot_url": { "type": "string" }, "review_id": { "type": "number" }, "draft": { "type": "boolean" }, "required": { "type": "array", "items": { "type": "string" } }, "required_functions": { "type": "array", "items": { "type": "string" } }, "error_message": { "type": "string" }, "branch": { "type": "string" }, "commit_ref": { "type": "string" }, "commit_url": { "type": "string" }, "skipped": { "type": "boolean" }, "created_at": { "type": "string", "format": "dateTime" }, "updated_at": { "type": "string", "format": "dateTime" }, "published_at": { "type": "string", "format": "dateTime" }, "title": { "type": "string" }, "context": { "type": "string" }, "locked": { "type": "boolean" }, "review_url": { "type": "string" }, "framework": { "type": "string" }, "function_schedules": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "cron": { "type": "string" } } } } } }, "account_id": { "type": "string" }, "account_name": { "type": "string" }, "account_slug": { "type": "string" }, "git_provider": { "type": "string" }, "deploy_hook": { "type": "string" }, "capabilities": { "type": "object", "additionalProperties": { "type": "object" } }, "processing_settings": { "type": "object", "properties": { "html": { "type": "object", "properties": { "pretty_urls": { "type": "boolean" } } } } }, "build_settings": { "type": "object", "properties": { "id": { "type": "integer" }, "provider": { "type": "string" }, "deploy_key_id": { "type": "string" }, "repo_path": { "type": "string" }, "repo_branch": { "type": "string" }, "dir": { "type": "string" }, "functions_dir": { "type": "string" }, "cmd": { "type": "string" }, "allowed_branches": { "type": "array", "items": { "type": "string" } }, "public_repo": { "type": "boolean" }, "private_logs": { "type": "boolean" }, "repo_url": { "type": "string" }, "env": { "type": "object", "additionalProperties": { "type": "string" } }, "installation_id": { "type": "integer" }, "stop_builds": { "type": "boolean" } } }, "id_domain": { "type": "string" }, "default_hooks_data": { "type": "object", "properties": { "access_token": { "type": "string" } } }, "build_image": { "type": "string" }, "prerender": { "type": "string" }, "functions_region": { "type": "string" } } } }, "404": { "description": "Site not found" } } } }, "/builds/{build_id}": { "parameters": [ { "name": "build_id", "type": "string", "in": "path", "required": true } ], "get": { "operationId": "getSiteBuild", "tags": [ "build" ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "properties": { "id": { "type": "string" }, "deploy_id": { "type": "string" }, "sha": { "type": "string" }, "done": { "type": "boolean" }, "error": { "type": "string" }, "created_at": { "type": "string", "format": "dateTime" } } } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } } }, "/builds/{build_id}/log": { "parameters": [ { "name": "build_id", "type": "string", "in": "path", "required": true }, { "name": "msg", "in": "body", "schema": { "type": "object", "properties": { "message": { "type": "string" }, "error": { "type": "boolean" }, "section": { "type": "string", "enum": [ "initializing", "building", "deploying", "cleanup", "postprocessing" ] } } }, "required": true } ], "post": { "operationId": "updateSiteBuildLog", "tags": [ "buildLogMsg" ], "responses": { "204": { "description": "No content" }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } } }, "/builds/{build_id}/start": { "parameters": [ { "name": "build_id", "type": "string", "in": "path", "required": true }, { "name": "buildbot_version", "type": "string", "in": "query", "required": false }, { "name": "build_version", "type": "string", "in": "query", "required": false } ], "post": { "operationId": "notifyBuildStart", "tags": [ "build" ], "responses": { "204": { "description": "No content" }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } } }, "/{account_id}/builds/status": { "parameters": [ { "name": "account_id", "type": "string", "in": "path", "required": true } ], "get": { "operationId": "getAccountBuildStatus", "tags": [ "build" ], "responses": { "200": { "description": "OK", "schema": { "type": "array", "items": { "type": "object", "properties": { "active": { "type": "integer" }, "pending_concurrency": { "type": "integer" }, "enqueued": { "type": "integer" }, "build_count": { "type": "integer" }, "minutes": { "type": "object", "properties": { "current": { "type": "integer" }, "current_average_sec": { "type": "integer" }, "previous": { "type": "integer" }, "period_start_date": { "type": "string", "format": "dateTime" }, "period_end_date": { "type": "string", "format": "dateTime" }, "last_updated_at": { "type": "string", "format": "dateTime" }, "included_minutes": { "type": "string" }, "included_minutes_with_packs": { "type": "string" } } } } } } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } } }, "/sites/{site_id}/dns": { "parameters": [ { "name": "site_id", "type": "string", "in": "path", "required": true } ], "get": { "operationId": "getDNSForSite", "tags": [ "dnsZone" ], "responses": { "200": { "description": "OK", "schema": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "errors": { "type": "array", "items": { "type": "string" } }, "supported_record_types": { "type": "array", "items": { "type": "string" } }, "user_id": { "type": "string" }, "created_at": { "type": "string", "format": "dateTime" }, "updated_at": { "type": "string", "format": "dateTime" }, "records": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "hostname": { "type": "string" }, "type": { "type": "string" }, "value": { "type": "string" }, "ttl": { "type": "integer", "format": "int64" }, "priority": { "type": "integer", "format": "int64" }, "dns_zone_id": { "type": "string" }, "site_id": { "type": "string" }, "flag": { "type": "integer" }, "tag": { "type": "string" }, "managed": { "type": "boolean" } } } }, "dns_servers": { "type": "array", "items": { "type": "string" } }, "account_id": { "type": "string" }, "site_id": { "type": "string" }, "account_slug": { "type": "string" }, "account_name": { "type": "string" }, "domain": { "type": "string" }, "ipv6_enabled": { "type": "boolean" }, "dedicated": { "type": "boolean" } } } } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } }, "put": { "operationId": "configureDNSForSite", "tags": [ "dnsZone" ], "responses": { "200": { "description": "OK", "schema": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "errors": { "type": "array", "items": { "type": "string" } }, "supported_record_types": { "type": "array", "items": { "type": "string" } }, "user_id": { "type": "string" }, "created_at": { "type": "string", "format": "dateTime" }, "updated_at": { "type": "string", "format": "dateTime" }, "records": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "hostname": { "type": "string" }, "type": { "type": "string" }, "value": { "type": "string" }, "ttl": { "type": "integer", "format": "int64" }, "priority": { "type": "integer", "format": "int64" }, "dns_zone_id": { "type": "string" }, "site_id": { "type": "string" }, "flag": { "type": "integer" }, "tag": { "type": "string" }, "managed": { "type": "boolean" } } } }, "dns_servers": { "type": "array", "items": { "type": "string" } }, "account_id": { "type": "string" }, "site_id": { "type": "string" }, "account_slug": { "type": "string" }, "account_name": { "type": "string" }, "domain": { "type": "string" }, "ipv6_enabled": { "type": "boolean" }, "dedicated": { "type": "boolean" } } } } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } } }, "/sites/{site_id}/rollback": { "parameters": [ { "name": "site_id", "type": "string", "in": "path", "required": true } ], "put": { "operationId": "rollbackSiteDeploy", "tags": [ "deploy" ], "responses": { "204": { "description": "No content" }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } } }, "/deploys/{deploy_id}": { "get": { "operationId": "getDeploy", "tags": [ "deploy" ], "parameters": [ { "name": "deploy_id", "type": "string", "in": "path", "required": true } ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "properties": { "id": { "type": "string" }, "site_id": { "type": "string" }, "user_id": { "type": "string" }, "build_id": { "type": "string" }, "state": { "type": "string" }, "name": { "type": "string" }, "url": { "type": "string" }, "ssl_url": { "type": "string" }, "admin_url": { "type": "string" }, "deploy_url": { "type": "string" }, "deploy_ssl_url": { "type": "string" }, "screenshot_url": { "type": "string" }, "review_id": { "type": "number" }, "draft": { "type": "boolean" }, "required": { "type": "array", "items": { "type": "string" } }, "required_functions": { "type": "array", "items": { "type": "string" } }, "error_message": { "type": "string" }, "branch": { "type": "string" }, "commit_ref": { "type": "string" }, "commit_url": { "type": "string" }, "skipped": { "type": "boolean" }, "created_at": { "type": "string", "format": "dateTime" }, "updated_at": { "type": "string", "format": "dateTime" }, "published_at": { "type": "string", "format": "dateTime" }, "title": { "type": "string" }, "context": { "type": "string" }, "locked": { "type": "boolean" }, "review_url": { "type": "string" }, "framework": { "type": "string" }, "function_schedules": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "cron": { "type": "string" } } } } } } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } }, "delete": { "operationId": "deleteDeploy", "tags": [ "deploy" ], "parameters": [ { "name": "deploy_id", "type": "string", "in": "path", "required": true } ], "responses": { "204": { "description": "No content" }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } } }, "/deploys/{deploy_id}/validations_report": { "patch": { "operationId": "updateDeployValidations", "tags": [ "deploy" ], "description": "Updates the deploy validations report for a deploy.", "x-internal": true, "x-controller": "api/v1/deploys", "x-action": "validations_report", "parameters": [ { "name": "deploy_id", "description": "The ID of the deploy", "type": "string", "in": "path", "required": true }, { "name": "report", "in": "body", "required": true, "schema": { "type": "object", "properties": { "secrets_scan": { "type": "object" } } } } ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "properties": { "id": { "type": "string", "description": "The id of the deploy validations report" }, "deploy_id": { "type": "string", "description": "The id of the deploy" }, "secret_scan_result": { "type": "object", "properties": { "scannedFilesCount": { "type": "integer", "description": "The number of files scanned" }, "secretsScanMatches": { "type": "array", "items": { "type": "string" }, "description": "The list of secrets scan matches" } } } } } } } } }, "/deploys/{deploy_id}/lock": { "post": { "operationId": "lockDeploy", "tags": [ "deploy" ], "parameters": [ { "name": "deploy_id", "type": "string", "in": "path", "required": true } ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "properties": { "id": { "type": "string" }, "site_id": { "type": "string" }, "user_id": { "type": "string" }, "build_id": { "type": "string" }, "state": { "type": "string" }, "name": { "type": "string" }, "url": { "type": "string" }, "ssl_url": { "type": "string" }, "admin_url": { "type": "string" }, "deploy_url": { "type": "string" }, "deploy_ssl_url": { "type": "string" }, "screenshot_url": { "type": "string" }, "review_id": { "type": "number" }, "draft": { "type": "boolean" }, "required": { "type": "array", "items": { "type": "string" } }, "required_functions": { "type": "array", "items": { "type": "string" } }, "error_message": { "type": "string" }, "branch": { "type": "string" }, "commit_ref": { "type": "string" }, "commit_url": { "type": "string" }, "skipped": { "type": "boolean" }, "created_at": { "type": "string", "format": "dateTime" }, "updated_at": { "type": "string", "format": "dateTime" }, "published_at": { "type": "string", "format": "dateTime" }, "title": { "type": "string" }, "context": { "type": "string" }, "locked": { "type": "boolean" }, "review_url": { "type": "string" }, "framework": { "type": "string" }, "function_schedules": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "cron": { "type": "string" } } } } } } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } } }, "/deploys/{deploy_id}/unlock": { "post": { "operationId": "unlockDeploy", "tags": [ "deploy" ], "parameters": [ { "name": "deploy_id", "type": "string", "in": "path", "required": true } ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "properties": { "id": { "type": "string" }, "site_id": { "type": "string" }, "user_id": { "type": "string" }, "build_id": { "type": "string" }, "state": { "type": "string" }, "name": { "type": "string" }, "url": { "type": "string" }, "ssl_url": { "type": "string" }, "admin_url": { "type": "string" }, "deploy_url": { "type": "string" }, "deploy_ssl_url": { "type": "string" }, "screenshot_url": { "type": "string" }, "review_id": { "type": "number" }, "draft": { "type": "boolean" }, "required": { "type": "array", "items": { "type": "string" } }, "required_functions": { "type": "array", "items": { "type": "string" } }, "error_message": { "type": "string" }, "branch": { "type": "string" }, "commit_ref": { "type": "string" }, "commit_url": { "type": "string" }, "skipped": { "type": "boolean" }, "created_at": { "type": "string", "format": "dateTime" }, "updated_at": { "type": "string", "format": "dateTime" }, "published_at": { "type": "string", "format": "dateTime" }, "title": { "type": "string" }, "context": { "type": "string" }, "locked": { "type": "boolean" }, "review_url": { "type": "string" }, "framework": { "type": "string" }, "function_schedules": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "cron": { "type": "string" } } } } } } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } } }, "/deploys/{deploy_id}/files/{path}": { "put": { "operationId": "uploadDeployFile", "tags": [ "file" ], "consumes": [ "application/octet-stream" ], "parameters": [ { "name": "deploy_id", "type": "string", "in": "path", "required": true }, { "name": "path", "type": "string", "in": "path", "required": true }, { "name": "size", "type": "integer", "in": "query" }, { "name": "file_body", "in": "body", "schema": { "type": "string", "format": "binary" }, "required": true } ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "properties": { "id": { "type": "string" }, "path": { "type": "string" }, "sha": { "type": "string" }, "mime_type": { "type": "string" }, "size": { "type": "integer", "format": "int64" } } } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } } }, "/deploys/{deploy_id}/functions/{name}": { "put": { "operationId": "uploadDeployFunction", "tags": [ "function" ], "consumes": [ "application/octet-stream" ], "parameters": [ { "name": "deploy_id", "type": "string", "in": "path", "required": true }, { "name": "name", "type": "string", "in": "path", "required": true }, { "name": "runtime", "type": "string", "in": "query" }, { "name": "invocation_mode", "in": "query", "type": "string" }, { "name": "timeout", "in": "query", "type": "integer" }, { "name": "size", "type": "integer", "in": "query" }, { "name": "file_body", "in": "body", "schema": { "type": "string", "format": "binary" }, "required": true }, { "name": "X-Nf-Retry-Count", "type": "integer", "in": "header" } ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "sha": { "type": "string" } } } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } } }, "/sites/{site_id}/plugins/{package}": { "put": { "x-internal": true, "operationId": "updatePlugin", "tags": [ "x-internal" ], "description": "This is an internal-only endpoint.", "parameters": [ { "name": "site_id", "type": "string", "in": "path", "required": true }, { "name": "package", "type": "string", "in": "path", "required": true }, { "name": "plugin_params", "in": "body", "schema": { "type": "object", "properties": { "pinned_version": { "type": "string" } } } } ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "properties": { "package": { "type": "string" }, "pinned_version": { "type": "string" } } } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } } }, "/sites/{site_id}/plugin_runs/latest": { "get": { "x-internal": true, "operationId": "getLatestPluginRuns", "tags": [ "x-internal" ], "description": "This is an internal-only endpoint.", "parameters": [ { "name": "site_id", "in": "path", "type": "string", "required": true }, { "name": "packages", "in": "query", "type": "array", "items": { "type": "string" }, "required": true }, { "name": "state", "in": "query", "type": "string" } ], "responses": { "200": { "description": "OK", "schema": { "type": "array", "items": { "allOf": [ { "type": "object", "properties": { "package": { "type": "string" }, "version": { "type": "string" }, "state": { "type": "string" }, "reporting_event": { "type": "string" }, "title": { "type": "string" }, "summary": { "type": "string" }, "text": { "type": "string" } } }, { "type": "object", "properties": { "deploy_id": { "type": "string" } } } ] } } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } } }, "/deploys/{deploy_id}/plugin_runs": { "post": { "x-internal": true, "operationId": "createPluginRun", "tags": [ "x-internal" ], "description": "This is an internal-only endpoint.", "parameters": [ { "name": "deploy_id", "type": "string", "in": "path", "required": true }, { "name": "plugin_run", "in": "body", "schema": { "type": "object", "properties": { "package": { "type": "string" }, "version": { "type": "string" }, "state": { "type": "string" }, "reporting_event": { "type": "string" }, "title": { "type": "string" }, "summary": { "type": "string" }, "text": { "type": "string" } } } } ], "responses": { "201": { "description": "CREATED", "schema": { "allOf": [ { "type": "object", "properties": { "package": { "type": "string" }, "version": { "type": "string" }, "state": { "type": "string" }, "reporting_event": { "type": "string" }, "title": { "type": "string" }, "summary": { "type": "string" }, "text": { "type": "string" } } }, { "type": "object", "properties": { "deploy_id": { "type": "string" } } } ] } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } } }, "/forms/{form_id}/submissions": { "get": { "operationId": "listFormSubmissions", "tags": [ "submission" ], "parameters": [ { "name": "form_id", "type": "string", "in": "path", "required": true }, { "type": "integer", "format": "int32", "name": "page", "required": false, "in": "query" }, { "type": "integer", "format": "int32", "name": "per_page", "required": false, "in": "query" } ], "responses": { "200": { "description": "OK", "schema": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "number": { "type": "integer", "format": "int32" }, "email": { "type": "string" }, "name": { "type": "string" }, "first_name": { "type": "string" }, "last_name": { "type": "string" }, "company": { "type": "string" }, "summary": { "type": "string" }, "body": { "type": "string" }, "data": { "type": "object" }, "created_at": { "type": "string", "format": "dateTime" }, "site_url": { "type": "string" } } } } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } } }, "/hooks": { "get": { "operationId": "listHooksBySiteId", "tags": [ "hook" ], "parameters": [ { "name": "site_id", "in": "query", "type": "string", "required": true } ], "responses": { "200": { "description": "OK", "schema": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "site_id": { "type": "string" }, "type": { "type": "string" }, "event": { "type": "string" }, "data": { "type": "object" }, "created_at": { "type": "string", "format": "dateTime" }, "updated_at": { "type": "string", "format": "dateTime" }, "disabled": { "type": "boolean" } } } } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } }, "post": { "operationId": "createHookBySiteId", "tags": [ "hook" ], "consumes": [ "application/json" ], "parameters": [ { "name": "site_id", "type": "string", "in": "query", "required": true }, { "name": "hook", "in": "body", "schema": { "type": "object", "properties": { "id": { "type": "string" }, "site_id": { "type": "string" }, "type": { "type": "string" }, "event": { "type": "string" }, "data": { "type": "object" }, "created_at": { "type": "string", "format": "dateTime" }, "updated_at": { "type": "string", "format": "dateTime" }, "disabled": { "type": "boolean" } } }, "required": true } ], "responses": { "201": { "description": "OK", "schema": { "type": "object", "properties": { "id": { "type": "string" }, "site_id": { "type": "string" }, "type": { "type": "string" }, "event": { "type": "string" }, "data": { "type": "object" }, "created_at": { "type": "string", "format": "dateTime" }, "updated_at": { "type": "string", "format": "dateTime" }, "disabled": { "type": "boolean" } } } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } } }, "/hooks/{hook_id}": { "parameters": [ { "name": "hook_id", "type": "string", "in": "path", "required": true } ], "get": { "operationId": "getHook", "tags": [ "hook" ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "properties": { "id": { "type": "string" }, "site_id": { "type": "string" }, "type": { "type": "string" }, "event": { "type": "string" }, "data": { "type": "object" }, "created_at": { "type": "string", "format": "dateTime" }, "updated_at": { "type": "string", "format": "dateTime" }, "disabled": { "type": "boolean" } } } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } }, "put": { "operationId": "updateHook", "tags": [ "hook" ], "parameters": [ { "name": "hook", "in": "body", "schema": { "type": "object", "properties": { "id": { "type": "string" }, "site_id": { "type": "string" }, "type": { "type": "string" }, "event": { "type": "string" }, "data": { "type": "object" }, "created_at": { "type": "string", "format": "dateTime" }, "updated_at": { "type": "string", "format": "dateTime" }, "disabled": { "type": "boolean" } } }, "required": true } ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "properties": { "id": { "type": "string" }, "site_id": { "type": "string" }, "type": { "type": "string" }, "event": { "type": "string" }, "data": { "type": "object" }, "created_at": { "type": "string", "format": "dateTime" }, "updated_at": { "type": "string", "format": "dateTime" }, "disabled": { "type": "boolean" } } } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } }, "delete": { "operationId": "deleteHook", "tags": [ "hook" ], "responses": { "204": { "description": "No content" } } } }, "/hooks/{hook_id}/enable": { "parameters": [ { "name": "hook_id", "type": "string", "in": "path", "required": true } ], "post": { "operationId": "enableHook", "tags": [ "hook" ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "properties": { "id": { "type": "string" }, "site_id": { "type": "string" }, "type": { "type": "string" }, "event": { "type": "string" }, "data": { "type": "object" }, "created_at": { "type": "string", "format": "dateTime" }, "updated_at": { "type": "string", "format": "dateTime" }, "disabled": { "type": "boolean" } } } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } } }, "/hooks/types": { "get": { "operationId": "listHookTypes", "tags": [ "hookType" ], "responses": { "200": { "description": "OK", "schema": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "events": { "type": "array", "items": { "type": "string" } }, "fields": { "type": "array", "items": { "type": "object" } } } } } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } } }, "/oauth/tickets": { "post": { "operationId": "createTicket", "tags": [ "ticket" ], "parameters": [ { "name": "client_id", "type": "string", "in": "query", "required": true } ], "responses": { "201": { "description": "ok", "schema": { "type": "object", "properties": { "id": { "type": "string" }, "client_id": { "type": "string" }, "authorized": { "type": "boolean" }, "created_at": { "type": "string", "format": "dateTime" } } } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } } }, "/oauth/tickets/{ticket_id}": { "get": { "operationId": "showTicket", "tags": [ "ticket" ], "parameters": [ { "name": "ticket_id", "type": "string", "in": "path", "required": true } ], "responses": { "200": { "description": "ok", "schema": { "type": "object", "properties": { "id": { "type": "string" }, "client_id": { "type": "string" }, "authorized": { "type": "boolean" }, "created_at": { "type": "string", "format": "dateTime" } } } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } } }, "/oauth/tickets/{ticket_id}/exchange": { "post": { "operationId": "exchangeTicket", "tags": [ "accessToken" ], "parameters": [ { "name": "ticket_id", "type": "string", "in": "path", "required": true } ], "responses": { "201": { "description": "ok", "schema": { "type": "object", "properties": { "id": { "type": "string" }, "access_token": { "type": "string" }, "user_id": { "type": "string" }, "user_email": { "type": "string" }, "created_at": { "type": "string", "format": "dateTime" } } } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } } }, "/deploy_keys": { "get": { "operationId": "listDeployKeys", "tags": [ "deployKey" ], "responses": { "200": { "description": "OK", "schema": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "public_key": { "type": "string" }, "created_at": { "type": "string", "format": "dateTime" } } } } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } }, "post": { "operationId": "createDeployKey", "tags": [ "deployKey" ], "consumes": [ "application/json" ], "responses": { "201": { "description": "Created", "schema": { "type": "object", "properties": { "id": { "type": "string" }, "public_key": { "type": "string" }, "created_at": { "type": "string", "format": "dateTime" } } } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } } }, "/deploy_keys/{key_id}": { "parameters": [ { "name": "key_id", "type": "string", "in": "path", "required": true } ], "get": { "operationId": "getDeployKey", "tags": [ "deployKey" ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "properties": { "id": { "type": "string" }, "public_key": { "type": "string" }, "created_at": { "type": "string", "format": "dateTime" } } } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } }, "delete": { "operationId": "deleteDeployKey", "tags": [ "deployKey" ], "responses": { "204": { "description": "Not Content" }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } } }, "/{account_slug}/sites": { "post": { "operationId": "createSiteInTeam", "tags": [ "site" ], "consumes": [ "application/json" ], "parameters": [ { "name": "site", "in": "body", "schema": { "allOf": [ { "type": "object", "properties": { "id": { "type": "string" }, "state": { "type": "string" }, "plan": { "type": "string" }, "name": { "type": "string" }, "custom_domain": { "type": "string" }, "domain_aliases": { "type": "array", "items": { "type": "string" } }, "branch_deploy_custom_domain": { "type": "string" }, "deploy_preview_custom_domain": { "type": "string" }, "password": { "type": "string" }, "notification_email": { "type": "string" }, "url": { "type": "string" }, "ssl_url": { "type": "string" }, "admin_url": { "type": "string" }, "screenshot_url": { "type": "string" }, "created_at": { "type": "string", "format": "dateTime" }, "updated_at": { "type": "string", "format": "dateTime" }, "user_id": { "type": "string" }, "session_id": { "type": "string" }, "ssl": { "type": "boolean" }, "force_ssl": { "type": "boolean" }, "managed_dns": { "type": "boolean" }, "deploy_url": { "type": "string" }, "published_deploy": { "type": "object", "properties": { "id": { "type": "string" }, "site_id": { "type": "string" }, "user_id": { "type": "string" }, "build_id": { "type": "string" }, "state": { "type": "string" }, "name": { "type": "string" }, "url": { "type": "string" }, "ssl_url": { "type": "string" }, "admin_url": { "type": "string" }, "deploy_url": { "type": "string" }, "deploy_ssl_url": { "type": "string" }, "screenshot_url": { "type": "string" }, "review_id": { "type": "number" }, "draft": { "type": "boolean" }, "required": { "type": "array", "items": { "type": "string" } }, "required_functions": { "type": "array", "items": { "type": "string" } }, "error_message": { "type": "string" }, "branch": { "type": "string" }, "commit_ref": { "type": "string" }, "commit_url": { "type": "string" }, "skipped": { "type": "boolean" }, "created_at": { "type": "string", "format": "dateTime" }, "updated_at": { "type": "string", "format": "dateTime" }, "published_at": { "type": "string", "format": "dateTime" }, "title": { "type": "string" }, "context": { "type": "string" }, "locked": { "type": "boolean" }, "review_url": { "type": "string" }, "framework": { "type": "string" }, "function_schedules": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "cron": { "type": "string" } } } } } }, "account_id": { "type": "string" }, "account_name": { "type": "string" }, "account_slug": { "type": "string" }, "git_provider": { "type": "string" }, "deploy_hook": { "type": "string" }, "capabilities": { "type": "object", "additionalProperties": { "type": "object" } }, "processing_settings": { "type": "object", "properties": { "html": { "type": "object", "properties": { "pretty_urls": { "type": "boolean" } } } } }, "build_settings": { "type": "object", "properties": { "id": { "type": "integer" }, "provider": { "type": "string" }, "deploy_key_id": { "type": "string" }, "repo_path": { "type": "string" }, "repo_branch": { "type": "string" }, "dir": { "type": "string" }, "functions_dir": { "type": "string" }, "cmd": { "type": "string" }, "allowed_branches": { "type": "array", "items": { "type": "string" } }, "public_repo": { "type": "boolean" }, "private_logs": { "type": "boolean" }, "repo_url": { "type": "string" }, "env": { "type": "object", "additionalProperties": { "type": "string" } }, "installation_id": { "type": "integer" }, "stop_builds": { "type": "boolean" } } }, "id_domain": { "type": "string" }, "default_hooks_data": { "type": "object", "properties": { "access_token": { "type": "string" } } }, "build_image": { "type": "string" }, "prerender": { "type": "string" }, "functions_region": { "type": "string" } } }, { "properties": { "repo": { "type": "object", "properties": { "id": { "type": "integer" }, "provider": { "type": "string" }, "deploy_key_id": { "type": "string" }, "repo_path": { "type": "string" }, "repo_branch": { "type": "string" }, "dir": { "type": "string" }, "functions_dir": { "type": "string" }, "cmd": { "type": "string" }, "allowed_branches": { "type": "array", "items": { "type": "string" } }, "public_repo": { "type": "boolean" }, "private_logs": { "type": "boolean" }, "repo_url": { "type": "string" }, "env": { "type": "object", "additionalProperties": { "type": "string" } }, "installation_id": { "type": "integer" }, "stop_builds": { "type": "boolean" } } } } } ] } }, { "name": "configure_dns", "type": "boolean", "in": "query" }, { "name": "account_slug", "in": "path", "type": "string", "required": true } ], "responses": { "201": { "description": "Created", "schema": { "type": "object", "properties": { "id": { "type": "string" }, "state": { "type": "string" }, "plan": { "type": "string" }, "name": { "type": "string" }, "custom_domain": { "type": "string" }, "domain_aliases": { "type": "array", "items": { "type": "string" } }, "branch_deploy_custom_domain": { "type": "string" }, "deploy_preview_custom_domain": { "type": "string" }, "password": { "type": "string" }, "notification_email": { "type": "string" }, "url": { "type": "string" }, "ssl_url": { "type": "string" }, "admin_url": { "type": "string" }, "screenshot_url": { "type": "string" }, "created_at": { "type": "string", "format": "dateTime" }, "updated_at": { "type": "string", "format": "dateTime" }, "user_id": { "type": "string" }, "session_id": { "type": "string" }, "ssl": { "type": "boolean" }, "force_ssl": { "type": "boolean" }, "managed_dns": { "type": "boolean" }, "deploy_url": { "type": "string" }, "published_deploy": { "type": "object", "properties": { "id": { "type": "string" }, "site_id": { "type": "string" }, "user_id": { "type": "string" }, "build_id": { "type": "string" }, "state": { "type": "string" }, "name": { "type": "string" }, "url": { "type": "string" }, "ssl_url": { "type": "string" }, "admin_url": { "type": "string" }, "deploy_url": { "type": "string" }, "deploy_ssl_url": { "type": "string" }, "screenshot_url": { "type": "string" }, "review_id": { "type": "number" }, "draft": { "type": "boolean" }, "required": { "type": "array", "items": { "type": "string" } }, "required_functions": { "type": "array", "items": { "type": "string" } }, "error_message": { "type": "string" }, "branch": { "type": "string" }, "commit_ref": { "type": "string" }, "commit_url": { "type": "string" }, "skipped": { "type": "boolean" }, "created_at": { "type": "string", "format": "dateTime" }, "updated_at": { "type": "string", "format": "dateTime" }, "published_at": { "type": "string", "format": "dateTime" }, "title": { "type": "string" }, "context": { "type": "string" }, "locked": { "type": "boolean" }, "review_url": { "type": "string" }, "framework": { "type": "string" }, "function_schedules": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "cron": { "type": "string" } } } } } }, "account_id": { "type": "string" }, "account_name": { "type": "string" }, "account_slug": { "type": "string" }, "git_provider": { "type": "string" }, "deploy_hook": { "type": "string" }, "capabilities": { "type": "object", "additionalProperties": { "type": "object" } }, "processing_settings": { "type": "object", "properties": { "html": { "type": "object", "properties": { "pretty_urls": { "type": "boolean" } } } } }, "build_settings": { "type": "object", "properties": { "id": { "type": "integer" }, "provider": { "type": "string" }, "deploy_key_id": { "type": "string" }, "repo_path": { "type": "string" }, "repo_branch": { "type": "string" }, "dir": { "type": "string" }, "functions_dir": { "type": "string" }, "cmd": { "type": "string" }, "allowed_branches": { "type": "array", "items": { "type": "string" } }, "public_repo": { "type": "boolean" }, "private_logs": { "type": "boolean" }, "repo_url": { "type": "string" }, "env": { "type": "object", "additionalProperties": { "type": "string" } }, "installation_id": { "type": "integer" }, "stop_builds": { "type": "boolean" } } }, "id_domain": { "type": "string" }, "default_hooks_data": { "type": "object", "properties": { "access_token": { "type": "string" } } }, "build_image": { "type": "string" }, "prerender": { "type": "string" }, "functions_region": { "type": "string" } } } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } }, "description": "**Note:** Environment variable keys and values have moved from `build_settings.env` and `repo.env` to a new endpoint. Please use [createEnvVars](#tag/environmentVariables/operation/createEnvVars) to create environment variables for a site." }, "get": { "operationId": "listSitesForAccount", "tags": [ "site" ], "parameters": [ { "name": "name", "in": "query", "type": "string" }, { "name": "account_slug", "in": "path", "type": "string", "required": true }, { "type": "integer", "format": "int32", "name": "page", "required": false, "in": "query" }, { "type": "integer", "format": "int32", "name": "per_page", "required": false, "in": "query" } ], "responses": { "200": { "description": "OK", "schema": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "state": { "type": "string" }, "plan": { "type": "string" }, "name": { "type": "string" }, "custom_domain": { "type": "string" }, "domain_aliases": { "type": "array", "items": { "type": "string" } }, "branch_deploy_custom_domain": { "type": "string" }, "deploy_preview_custom_domain": { "type": "string" }, "password": { "type": "string" }, "notification_email": { "type": "string" }, "url": { "type": "string" }, "ssl_url": { "type": "string" }, "admin_url": { "type": "string" }, "screenshot_url": { "type": "string" }, "created_at": { "type": "string", "format": "dateTime" }, "updated_at": { "type": "string", "format": "dateTime" }, "user_id": { "type": "string" }, "session_id": { "type": "string" }, "ssl": { "type": "boolean" }, "force_ssl": { "type": "boolean" }, "managed_dns": { "type": "boolean" }, "deploy_url": { "type": "string" }, "published_deploy": { "type": "object", "properties": { "id": { "type": "string" }, "site_id": { "type": "string" }, "user_id": { "type": "string" }, "build_id": { "type": "string" }, "state": { "type": "string" }, "name": { "type": "string" }, "url": { "type": "string" }, "ssl_url": { "type": "string" }, "admin_url": { "type": "string" }, "deploy_url": { "type": "string" }, "deploy_ssl_url": { "type": "string" }, "screenshot_url": { "type": "string" }, "review_id": { "type": "number" }, "draft": { "type": "boolean" }, "required": { "type": "array", "items": { "type": "string" } }, "required_functions": { "type": "array", "items": { "type": "string" } }, "error_message": { "type": "string" }, "branch": { "type": "string" }, "commit_ref": { "type": "string" }, "commit_url": { "type": "string" }, "skipped": { "type": "boolean" }, "created_at": { "type": "string", "format": "dateTime" }, "updated_at": { "type": "string", "format": "dateTime" }, "published_at": { "type": "string", "format": "dateTime" }, "title": { "type": "string" }, "context": { "type": "string" }, "locked": { "type": "boolean" }, "review_url": { "type": "string" }, "framework": { "type": "string" }, "function_schedules": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "cron": { "type": "string" } } } } } }, "account_id": { "type": "string" }, "account_name": { "type": "string" }, "account_slug": { "type": "string" }, "git_provider": { "type": "string" }, "deploy_hook": { "type": "string" }, "capabilities": { "type": "object", "additionalProperties": { "type": "object" } }, "processing_settings": { "type": "object", "properties": { "html": { "type": "object", "properties": { "pretty_urls": { "type": "boolean" } } } } }, "build_settings": { "type": "object", "properties": { "id": { "type": "integer" }, "provider": { "type": "string" }, "deploy_key_id": { "type": "string" }, "repo_path": { "type": "string" }, "repo_branch": { "type": "string" }, "dir": { "type": "string" }, "functions_dir": { "type": "string" }, "cmd": { "type": "string" }, "allowed_branches": { "type": "array", "items": { "type": "string" } }, "public_repo": { "type": "boolean" }, "private_logs": { "type": "boolean" }, "repo_url": { "type": "string" }, "env": { "type": "object", "additionalProperties": { "type": "string" } }, "installation_id": { "type": "integer" }, "stop_builds": { "type": "boolean" } } }, "id_domain": { "type": "string" }, "default_hooks_data": { "type": "object", "properties": { "access_token": { "type": "string" } } }, "build_image": { "type": "string" }, "prerender": { "type": "string" }, "functions_region": { "type": "string" } } } } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } }, "description": "**Note:** Environment variable keys and values have moved from `build_settings.env` and `repo.env` to a new endpoint. Please use [getEnvVars](#tag/environmentVariables/operation/getEnvVars) to retrieve site environment variables." } }, "/{account_slug}/members": { "parameters": [ { "name": "account_slug", "in": "path", "type": "string", "required": true } ], "get": { "operationId": "listMembersForAccount", "tags": [ "member" ], "responses": { "200": { "description": "OK", "schema": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "full_name": { "type": "string" }, "email": { "type": "string" }, "avatar": { "type": "string" }, "role": { "type": "string" } } } } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } }, "post": { "operationId": "addMemberToAccount", "tags": [ "member" ], "consumes": [ "application/json" ], "parameters": [ { "name": "accountAddMemberSetup", "in": "body", "schema": { "type": "object", "properties": { "role": { "type": "string", "enum": [ "Owner", "Developer", "Billing Admin", "Reviewer" ] }, "email": { "type": "string" } } }, "required": true } ], "responses": { "200": { "description": "OK", "schema": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "full_name": { "type": "string" }, "email": { "type": "string" }, "avatar": { "type": "string" }, "role": { "type": "string" } } } } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } } }, "/{account_slug}/members/{member_id}": { "parameters": [ { "name": "account_slug", "in": "path", "type": "string", "required": true }, { "name": "member_id", "in": "path", "type": "string", "required": true } ], "get": { "operationId": "getAccountMember", "tags": [ "member" ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "properties": { "id": { "type": "string" }, "full_name": { "type": "string" }, "email": { "type": "string" }, "avatar": { "type": "string" }, "role": { "type": "string" } } } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } }, "put": { "operationId": "updateAccountMember", "tags": [ "member" ], "consumes": [ "application/json" ], "parameters": [ { "name": "accountUpdateMemberSetup", "in": "body", "schema": { "type": "object", "properties": { "role": { "type": "string", "enum": [ "Owner", "Developer", "Billing Admin", "Reviewer" ] }, "site_access": { "type": "string", "enum": [ "all", "none", "selected" ] }, "site_ids": { "type": "array", "items": { "type": "string" } } } }, "required": true } ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "properties": { "id": { "type": "string" }, "full_name": { "type": "string" }, "email": { "type": "string" }, "avatar": { "type": "string" }, "role": { "type": "string" } } } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } }, "delete": { "operationId": "removeAccountMember", "tags": [ "member" ], "responses": { "204": { "description": "Not Content" }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } } }, "/billing/payment_methods": { "get": { "operationId": "listPaymentMethodsForUser", "tags": [ "paymentMethod" ], "responses": { "200": { "description": "OK", "schema": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "method_name": { "type": "string" }, "type": { "type": "string" }, "state": { "type": "string" }, "data": { "type": "object", "properties": { "card_type": { "type": "string" }, "last4": { "type": "string" }, "email": { "type": "string" } } }, "created_at": { "type": "string", "format": "dateTime" }, "updated_at": { "type": "string", "format": "dateTime" } } } } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } } }, "/accounts/types": { "get": { "operationId": "listAccountTypesForUser", "tags": [ "accountType" ], "responses": { "200": { "description": "OK", "schema": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "description": { "type": "string" }, "capabilities": { "type": "object" }, "monthly_dollar_price": { "type": "integer" }, "yearly_dollar_price": { "type": "integer" }, "monthly_seats_addon_dollar_price": { "type": "integer" }, "yearly_seats_addon_dollar_price": { "type": "integer" } } } } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } } }, "/accounts": { "get": { "operationId": "listAccountsForUser", "tags": [ "accountMembership" ], "parameters": [ { "name": "minimal", "x-internal": true, "type": "boolean", "in": "query" } ], "responses": { "200": { "description": "OK", "schema": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "slug": { "type": "string" }, "type": { "type": "string" }, "capabilities": { "type": "object", "properties": { "sites": { "type": "object", "properties": { "included": { "type": "integer" }, "used": { "type": "integer" } } }, "collaborators": { "type": "object", "properties": { "included": { "type": "integer" }, "used": { "type": "integer" } } } } }, "billing_name": { "type": "string" }, "billing_email": { "type": "string" }, "billing_details": { "type": "string" }, "billing_period": { "type": "string" }, "payment_method_id": { "type": "string" }, "type_name": { "type": "string" }, "type_id": { "type": "string" }, "owner_ids": { "type": "array", "items": { "type": "string" } }, "roles_allowed": { "type": "array", "items": { "type": "string" } }, "created_at": { "type": "string", "format": "dateTime" }, "updated_at": { "type": "string", "format": "dateTime" } } } } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } }, "post": { "operationId": "createAccount", "tags": [ "accountMembership" ], "parameters": [ { "name": "accountSetup", "in": "body", "schema": { "type": "object", "required": [ "name", "type_id" ], "properties": { "name": { "type": "string" }, "type_id": { "type": "string" }, "payment_method_id": { "type": "string" }, "period": { "type": "string", "enum": [ "monthly", "yearly" ] }, "extra_seats_block": { "type": "integer" } } }, "required": true } ], "responses": { "201": { "description": "Created", "schema": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "slug": { "type": "string" }, "type": { "type": "string" }, "capabilities": { "type": "object", "properties": { "sites": { "type": "object", "properties": { "included": { "type": "integer" }, "used": { "type": "integer" } } }, "collaborators": { "type": "object", "properties": { "included": { "type": "integer" }, "used": { "type": "integer" } } } } }, "billing_name": { "type": "string" }, "billing_email": { "type": "string" }, "billing_details": { "type": "string" }, "billing_period": { "type": "string" }, "payment_method_id": { "type": "string" }, "type_name": { "type": "string" }, "type_id": { "type": "string" }, "owner_ids": { "type": "array", "items": { "type": "string" } }, "roles_allowed": { "type": "array", "items": { "type": "string" } }, "created_at": { "type": "string", "format": "dateTime" }, "updated_at": { "type": "string", "format": "dateTime" } } } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } } }, "/accounts/{account_id}": { "parameters": [ { "name": "account_id", "type": "string", "in": "path", "required": true } ], "get": { "operationId": "getAccount", "tags": [ "accountMembership" ], "responses": { "200": { "description": "OK", "schema": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "slug": { "type": "string" }, "type": { "type": "string" }, "capabilities": { "type": "object", "properties": { "sites": { "type": "object", "properties": { "included": { "type": "integer" }, "used": { "type": "integer" } } }, "collaborators": { "type": "object", "properties": { "included": { "type": "integer" }, "used": { "type": "integer" } } } } }, "billing_name": { "type": "string" }, "billing_email": { "type": "string" }, "billing_details": { "type": "string" }, "billing_period": { "type": "string" }, "payment_method_id": { "type": "string" }, "type_name": { "type": "string" }, "type_id": { "type": "string" }, "owner_ids": { "type": "array", "items": { "type": "string" } }, "roles_allowed": { "type": "array", "items": { "type": "string" } }, "created_at": { "type": "string", "format": "dateTime" }, "updated_at": { "type": "string", "format": "dateTime" } } } } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } }, "put": { "operationId": "updateAccount", "tags": [ "accountMembership" ], "parameters": [ { "name": "accountUpdateSetup", "in": "body", "schema": { "type": "object", "properties": { "name": { "type": "string" }, "slug": { "type": "string" }, "type_id": { "type": "string" }, "extra_seats_block": { "type": "integer" }, "billing_name": { "type": "string" }, "billing_email": { "type": "string" }, "billing_details": { "type": "string" } } } } ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "slug": { "type": "string" }, "type": { "type": "string" }, "capabilities": { "type": "object", "properties": { "sites": { "type": "object", "properties": { "included": { "type": "integer" }, "used": { "type": "integer" } } }, "collaborators": { "type": "object", "properties": { "included": { "type": "integer" }, "used": { "type": "integer" } } } } }, "billing_name": { "type": "string" }, "billing_email": { "type": "string" }, "billing_details": { "type": "string" }, "billing_period": { "type": "string" }, "payment_method_id": { "type": "string" }, "type_name": { "type": "string" }, "type_id": { "type": "string" }, "owner_ids": { "type": "array", "items": { "type": "string" } }, "roles_allowed": { "type": "array", "items": { "type": "string" } }, "created_at": { "type": "string", "format": "dateTime" }, "updated_at": { "type": "string", "format": "dateTime" } } } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } }, "delete": { "operationId": "cancelAccount", "tags": [ "accountMembership" ], "responses": { "204": { "description": "Not Content" }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } } }, "/accounts/{account_id}/audit": { "parameters": [ { "name": "account_id", "type": "string", "in": "path", "required": true } ], "get": { "operationId": "listAccountAuditEvents", "tags": [ "auditLog" ], "parameters": [ { "name": "query", "type": "string", "in": "query" }, { "name": "log_type", "type": "string", "in": "query" }, { "type": "integer", "format": "int32", "name": "page", "required": false, "in": "query" }, { "type": "integer", "format": "int32", "name": "per_page", "required": false, "in": "query" } ], "responses": { "200": { "description": "OK", "schema": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "account_id": { "type": "string" }, "payload": { "type": "object", "properties": { "actor_id": { "type": "string" }, "actor_name": { "type": "string" }, "actor_email": { "type": "string" }, "action": { "type": "string" }, "timestamp": { "type": "string", "format": "dateTime" }, "log_type": { "type": "string" } }, "additionalProperties": { "type": "object" } } } } } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } } }, "/submissions/{submission_id}": { "parameters": [ { "name": "submission_id", "type": "string", "in": "path", "required": true } ], "get": { "operationId": "listFormSubmission", "tags": [ "submission" ], "parameters": [ { "name": "query", "type": "string", "in": "query" }, { "type": "integer", "format": "int32", "name": "page", "required": false, "in": "query" }, { "type": "integer", "format": "int32", "name": "per_page", "required": false, "in": "query" } ], "responses": { "200": { "description": "OK", "schema": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "number": { "type": "integer", "format": "int32" }, "email": { "type": "string" }, "name": { "type": "string" }, "first_name": { "type": "string" }, "last_name": { "type": "string" }, "company": { "type": "string" }, "summary": { "type": "string" }, "body": { "type": "string" }, "data": { "type": "object" }, "created_at": { "type": "string", "format": "dateTime" }, "site_url": { "type": "string" } } } } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } }, "delete": { "operationId": "deleteSubmission", "tags": [ "submission" ], "responses": { "204": { "description": "Deleted" }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } } }, "/sites/{site_id}/service-instances": { "parameters": [ { "name": "site_id", "type": "string", "in": "path", "required": true } ], "get": { "operationId": "listServiceInstancesForSite", "tags": [ "serviceInstance" ], "responses": { "200": { "description": "OK", "schema": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "url": { "type": "string" }, "config": { "type": "object" }, "external_attributes": { "type": "object" }, "service_slug": { "type": "string" }, "service_path": { "type": "string" }, "service_name": { "type": "string" }, "env": { "type": "object" }, "snippets": { "type": "array", "items": { "type": "object" } }, "auth_url": { "type": "string" }, "created_at": { "type": "string", "format": "dateTime" }, "updated_at": { "type": "string", "format": "dateTime" } } } } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } } }, "/sites/{site_id}/services/{addon}/instances": { "parameters": [ { "name": "site_id", "type": "string", "in": "path", "required": true }, { "name": "addon", "type": "string", "in": "path", "required": true } ], "post": { "operationId": "createServiceInstance", "tags": [ "serviceInstance" ], "consumes": [ "application/json" ], "parameters": [ { "name": "config", "in": "body", "required": true, "schema": { "type": "object" } } ], "responses": { "201": { "description": "Created", "schema": { "type": "object", "properties": { "id": { "type": "string" }, "url": { "type": "string" }, "config": { "type": "object" }, "external_attributes": { "type": "object" }, "service_slug": { "type": "string" }, "service_path": { "type": "string" }, "service_name": { "type": "string" }, "env": { "type": "object" }, "snippets": { "type": "array", "items": { "type": "object" } }, "auth_url": { "type": "string" }, "created_at": { "type": "string", "format": "dateTime" }, "updated_at": { "type": "string", "format": "dateTime" } } } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } } }, "/sites/{site_id}/services/{addon}/instances/{instance_id}": { "parameters": [ { "name": "site_id", "type": "string", "in": "path", "required": true }, { "name": "addon", "type": "string", "in": "path", "required": true }, { "name": "instance_id", "type": "string", "in": "path", "required": true } ], "get": { "operationId": "showServiceInstance", "tags": [ "serviceInstance" ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "properties": { "id": { "type": "string" }, "url": { "type": "string" }, "config": { "type": "object" }, "external_attributes": { "type": "object" }, "service_slug": { "type": "string" }, "service_path": { "type": "string" }, "service_name": { "type": "string" }, "env": { "type": "object" }, "snippets": { "type": "array", "items": { "type": "object" } }, "auth_url": { "type": "string" }, "created_at": { "type": "string", "format": "dateTime" }, "updated_at": { "type": "string", "format": "dateTime" } } } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } }, "put": { "operationId": "updateServiceInstance", "tags": [ "serviceInstance" ], "consumes": [ "application/json" ], "parameters": [ { "name": "config", "in": "body", "required": true, "schema": { "type": "object" } } ], "responses": { "204": { "description": "No Content" }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } }, "delete": { "operationId": "deleteServiceInstance", "tags": [ "serviceInstance" ], "responses": { "204": { "description": "Deleted" }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } } }, "/services/": { "parameters": [ { "name": "search", "type": "string", "in": "query" } ], "get": { "operationId": "getServices", "tags": [ "service" ], "responses": { "200": { "description": "services", "schema": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "slug": { "type": "string" }, "service_path": { "type": "string" }, "long_description": { "type": "string" }, "description": { "type": "string" }, "events": { "type": "array", "items": { "type": "object" } }, "tags": { "type": "array", "items": { "type": "string" } }, "icon": { "type": "string" }, "manifest_url": { "type": "string" }, "environments": { "type": "array", "items": { "type": "string" } }, "created_at": { "type": "string", "format": "dateTime" }, "updated_at": { "type": "string", "format": "dateTime" } } } } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } } }, "/services/{addonName}": { "parameters": [ { "name": "addonName", "type": "string", "in": "path", "required": true } ], "get": { "operationId": "showService", "tags": [ "service" ], "responses": { "200": { "description": "services", "schema": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "slug": { "type": "string" }, "service_path": { "type": "string" }, "long_description": { "type": "string" }, "description": { "type": "string" }, "events": { "type": "array", "items": { "type": "object" } }, "tags": { "type": "array", "items": { "type": "string" } }, "icon": { "type": "string" }, "manifest_url": { "type": "string" }, "environments": { "type": "array", "items": { "type": "string" } }, "created_at": { "type": "string", "format": "dateTime" }, "updated_at": { "type": "string", "format": "dateTime" } } } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } } }, "/services/{addonName}/manifest": { "parameters": [ { "name": "addonName", "type": "string", "in": "path", "required": true } ], "get": { "operationId": "showServiceManifest", "tags": [ "service" ], "responses": { "201": { "description": "retrieving from provider", "schema": { "type": "object" } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } } }, "/user": { "get": { "operationId": "getCurrentUser", "tags": [ "user" ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "properties": { "id": { "type": "string" }, "uid": { "type": "string" }, "full_name": { "type": "string" }, "avatar_url": { "type": "string" }, "email": { "type": "string" }, "affiliate_id": { "type": "string" }, "site_count": { "type": "integer", "format": "int64" }, "created_at": { "type": "string", "format": "dateTime" }, "last_login": { "type": "string", "format": "dateTime" }, "login_providers": { "type": "array", "items": { "type": "string" } }, "onboarding_progress": { "type": "object", "properties": { "slides": { "type": "string" } } } } } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } } }, "/sites/{site_id}/traffic_splits": { "parameters": [ { "name": "site_id", "type": "string", "in": "path", "required": true } ], "post": { "operationId": "createSplitTest", "tags": [ "splitTest" ], "consumes": [ "application/json" ], "parameters": [ { "name": "branch_tests", "in": "body", "required": true, "schema": { "type": "object", "properties": { "branch_tests": { "type": "object" } } } } ], "responses": { "201": { "description": "Created", "schema": { "type": "object", "properties": { "id": { "type": "string" }, "site_id": { "type": "string" }, "name": { "type": "string" }, "path": { "type": "string" }, "branches": { "type": "array", "items": { "type": "object" } }, "active": { "type": "boolean" }, "created_at": { "type": "string", "format": "dateTime" }, "updated_at": { "type": "string", "format": "dateTime" }, "unpublished_at": { "type": "string", "format": "dateTime" } } } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } }, "get": { "operationId": "getSplitTests", "tags": [ "splitTest" ], "responses": { "200": { "description": "split_tests", "schema": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "site_id": { "type": "string" }, "name": { "type": "string" }, "path": { "type": "string" }, "branches": { "type": "array", "items": { "type": "object" } }, "active": { "type": "boolean" }, "created_at": { "type": "string", "format": "dateTime" }, "updated_at": { "type": "string", "format": "dateTime" }, "unpublished_at": { "type": "string", "format": "dateTime" } } } } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } } }, "/sites/{site_id}/traffic_splits/{split_test_id}": { "parameters": [ { "name": "site_id", "type": "string", "in": "path", "required": true }, { "name": "split_test_id", "type": "string", "in": "path", "required": true } ], "put": { "operationId": "updateSplitTest", "tags": [ "splitTest" ], "consumes": [ "application/json" ], "parameters": [ { "name": "branch_tests", "in": "body", "required": true, "schema": { "type": "object", "properties": { "branch_tests": { "type": "object" } } } } ], "responses": { "201": { "description": "Created", "schema": { "type": "object", "properties": { "id": { "type": "string" }, "site_id": { "type": "string" }, "name": { "type": "string" }, "path": { "type": "string" }, "branches": { "type": "array", "items": { "type": "object" } }, "active": { "type": "boolean" }, "created_at": { "type": "string", "format": "dateTime" }, "updated_at": { "type": "string", "format": "dateTime" }, "unpublished_at": { "type": "string", "format": "dateTime" } } } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } }, "get": { "operationId": "getSplitTest", "tags": [ "splitTest" ], "responses": { "200": { "description": "split_test", "schema": { "type": "object", "properties": { "id": { "type": "string" }, "site_id": { "type": "string" }, "name": { "type": "string" }, "path": { "type": "string" }, "branches": { "type": "array", "items": { "type": "object" } }, "active": { "type": "boolean" }, "created_at": { "type": "string", "format": "dateTime" }, "updated_at": { "type": "string", "format": "dateTime" }, "unpublished_at": { "type": "string", "format": "dateTime" } } } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } } }, "/sites/{site_id}/traffic_splits/{split_test_id}/publish": { "parameters": [ { "name": "site_id", "type": "string", "in": "path", "required": true }, { "name": "split_test_id", "type": "string", "in": "path", "required": true } ], "post": { "operationId": "enableSplitTest", "tags": [ "splitTest" ], "responses": { "204": { "description": "enable" }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } } }, "/sites/{site_id}/traffic_splits/{split_test_id}/unpublish": { "parameters": [ { "name": "site_id", "type": "string", "in": "path", "required": true }, { "name": "split_test_id", "type": "string", "in": "path", "required": true } ], "post": { "operationId": "disableSplitTest", "tags": [ "splitTest" ], "responses": { "204": { "description": "disabled" }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } } }, "/dns_zones": { "post": { "operationId": "createDnsZone", "tags": [ "dnsZone" ], "consumes": [ "application/json" ], "parameters": [ { "name": "DnsZoneParams", "in": "body", "required": true, "schema": { "type": "object", "properties": { "account_slug": { "type": "string" }, "site_id": { "type": "string" }, "name": { "type": "string" } } } } ], "responses": { "201": { "description": "Created", "schema": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "errors": { "type": "array", "items": { "type": "string" } }, "supported_record_types": { "type": "array", "items": { "type": "string" } }, "user_id": { "type": "string" }, "created_at": { "type": "string", "format": "dateTime" }, "updated_at": { "type": "string", "format": "dateTime" }, "records": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "hostname": { "type": "string" }, "type": { "type": "string" }, "value": { "type": "string" }, "ttl": { "type": "integer", "format": "int64" }, "priority": { "type": "integer", "format": "int64" }, "dns_zone_id": { "type": "string" }, "site_id": { "type": "string" }, "flag": { "type": "integer" }, "tag": { "type": "string" }, "managed": { "type": "boolean" } } } }, "dns_servers": { "type": "array", "items": { "type": "string" } }, "account_id": { "type": "string" }, "site_id": { "type": "string" }, "account_slug": { "type": "string" }, "account_name": { "type": "string" }, "domain": { "type": "string" }, "ipv6_enabled": { "type": "boolean" }, "dedicated": { "type": "boolean" } } } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } }, "get": { "operationId": "getDnsZones", "tags": [ "dnsZone" ], "parameters": [ { "name": "account_slug", "in": "query", "type": "string", "required": false } ], "responses": { "200": { "description": "get all DNS zones the user has access to", "schema": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "errors": { "type": "array", "items": { "type": "string" } }, "supported_record_types": { "type": "array", "items": { "type": "string" } }, "user_id": { "type": "string" }, "created_at": { "type": "string", "format": "dateTime" }, "updated_at": { "type": "string", "format": "dateTime" }, "records": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "hostname": { "type": "string" }, "type": { "type": "string" }, "value": { "type": "string" }, "ttl": { "type": "integer", "format": "int64" }, "priority": { "type": "integer", "format": "int64" }, "dns_zone_id": { "type": "string" }, "site_id": { "type": "string" }, "flag": { "type": "integer" }, "tag": { "type": "string" }, "managed": { "type": "boolean" } } } }, "dns_servers": { "type": "array", "items": { "type": "string" } }, "account_id": { "type": "string" }, "site_id": { "type": "string" }, "account_slug": { "type": "string" }, "account_name": { "type": "string" }, "domain": { "type": "string" }, "ipv6_enabled": { "type": "boolean" }, "dedicated": { "type": "boolean" } } } } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } } }, "/dns_zones/{zone_id}": { "parameters": [ { "name": "zone_id", "type": "string", "in": "path", "required": true } ], "get": { "operationId": "getDnsZone", "tags": [ "dnsZone" ], "responses": { "200": { "description": "get a single DNS zone", "schema": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "errors": { "type": "array", "items": { "type": "string" } }, "supported_record_types": { "type": "array", "items": { "type": "string" } }, "user_id": { "type": "string" }, "created_at": { "type": "string", "format": "dateTime" }, "updated_at": { "type": "string", "format": "dateTime" }, "records": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "hostname": { "type": "string" }, "type": { "type": "string" }, "value": { "type": "string" }, "ttl": { "type": "integer", "format": "int64" }, "priority": { "type": "integer", "format": "int64" }, "dns_zone_id": { "type": "string" }, "site_id": { "type": "string" }, "flag": { "type": "integer" }, "tag": { "type": "string" }, "managed": { "type": "boolean" } } } }, "dns_servers": { "type": "array", "items": { "type": "string" } }, "account_id": { "type": "string" }, "site_id": { "type": "string" }, "account_slug": { "type": "string" }, "account_name": { "type": "string" }, "domain": { "type": "string" }, "ipv6_enabled": { "type": "boolean" }, "dedicated": { "type": "boolean" } } } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } }, "delete": { "operationId": "deleteDnsZone", "tags": [ "dnsZone" ], "responses": { "204": { "description": "delete a single DNS zone" }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } } }, "/dns_zones/{zone_id}/transfer": { "parameters": [ { "name": "zone_id", "type": "string", "in": "path", "required": true }, { "name": "account_id", "type": "string", "in": "query", "description": "the account of the dns zone", "required": true }, { "name": "transfer_account_id", "type": "string", "in": "query", "description": "the account you want to transfer the dns zone to", "required": true }, { "name": "transfer_user_id", "type": "string", "in": "query", "description": "the user you want to transfer the dns zone to", "required": true } ], "put": { "operationId": "transferDnsZone", "tags": [ "dnsZone" ], "responses": { "200": { "description": "transfer a DNS zone to another account", "schema": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "errors": { "type": "array", "items": { "type": "string" } }, "supported_record_types": { "type": "array", "items": { "type": "string" } }, "user_id": { "type": "string" }, "created_at": { "type": "string", "format": "dateTime" }, "updated_at": { "type": "string", "format": "dateTime" }, "records": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "hostname": { "type": "string" }, "type": { "type": "string" }, "value": { "type": "string" }, "ttl": { "type": "integer", "format": "int64" }, "priority": { "type": "integer", "format": "int64" }, "dns_zone_id": { "type": "string" }, "site_id": { "type": "string" }, "flag": { "type": "integer" }, "tag": { "type": "string" }, "managed": { "type": "boolean" } } } }, "dns_servers": { "type": "array", "items": { "type": "string" } }, "account_id": { "type": "string" }, "site_id": { "type": "string" }, "account_slug": { "type": "string" }, "account_name": { "type": "string" }, "domain": { "type": "string" }, "ipv6_enabled": { "type": "boolean" }, "dedicated": { "type": "boolean" } } } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } } }, "/dns_zones/{zone_id}/dns_records": { "parameters": [ { "name": "zone_id", "type": "string", "in": "path", "required": true } ], "get": { "operationId": "getDnsRecords", "tags": [ "dnsZone" ], "responses": { "200": { "description": "get all DNS records for a single DNS zone", "schema": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "hostname": { "type": "string" }, "type": { "type": "string" }, "value": { "type": "string" }, "ttl": { "type": "integer", "format": "int64" }, "priority": { "type": "integer", "format": "int64" }, "dns_zone_id": { "type": "string" }, "site_id": { "type": "string" }, "flag": { "type": "integer" }, "tag": { "type": "string" }, "managed": { "type": "boolean" } } } } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } }, "post": { "operationId": "createDnsRecord", "tags": [ "dnsZone" ], "consumes": [ "application/json" ], "parameters": [ { "name": "dns_record", "in": "body", "required": true, "schema": { "type": "object", "properties": { "type": { "type": "string" }, "hostname": { "type": "string" }, "value": { "type": "string" }, "ttl": { "type": "integer", "format": "int64" }, "priority": { "type": "integer", "format": "int64" }, "weight": { "type": "integer", "format": "int64" }, "port": { "type": "integer", "format": "int64" }, "flag": { "type": "integer", "format": "int64" }, "tag": { "type": "string" } } } } ], "responses": { "201": { "description": "Created", "schema": { "type": "object", "properties": { "id": { "type": "string" }, "hostname": { "type": "string" }, "type": { "type": "string" }, "value": { "type": "string" }, "ttl": { "type": "integer", "format": "int64" }, "priority": { "type": "integer", "format": "int64" }, "dns_zone_id": { "type": "string" }, "site_id": { "type": "string" }, "flag": { "type": "integer" }, "tag": { "type": "string" }, "managed": { "type": "boolean" } } } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } } }, "/dns_zones/{zone_id}/dns_records/{dns_record_id}": { "parameters": [ { "name": "zone_id", "type": "string", "in": "path", "required": true }, { "name": "dns_record_id", "type": "string", "in": "path", "required": true } ], "get": { "operationId": "getIndividualDnsRecord", "tags": [ "dnsZone" ], "responses": { "200": { "description": "get a single DNS record", "schema": { "type": "object", "properties": { "id": { "type": "string" }, "hostname": { "type": "string" }, "type": { "type": "string" }, "value": { "type": "string" }, "ttl": { "type": "integer", "format": "int64" }, "priority": { "type": "integer", "format": "int64" }, "dns_zone_id": { "type": "string" }, "site_id": { "type": "string" }, "flag": { "type": "integer" }, "tag": { "type": "string" }, "managed": { "type": "boolean" } } } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } }, "delete": { "operationId": "deleteDnsRecord", "tags": [ "dnsZone" ], "responses": { "204": { "description": "record deleted" }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } } }, "/sites/{site_id}/dev_servers": { "parameters": [ { "name": "site_id", "type": "string", "in": "path", "required": true } ], "get": { "operationId": "listSiteDevServers", "tags": [ "devServer" ], "parameters": [ { "type": "integer", "format": "int32", "name": "page", "required": false, "in": "query" }, { "type": "integer", "format": "int32", "name": "per_page", "required": false, "in": "query" } ], "responses": { "200": { "description": "OK", "schema": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "site_id": { "type": "string" }, "branch": { "type": "string" }, "url": { "type": "string" }, "state": { "type": "string" }, "created_at": { "type": "string", "format": "dateTime" }, "updated_at": { "type": "string", "format": "dateTime" }, "starting_at": { "type": "string", "format": "dateTime" }, "error_at": { "type": "string", "format": "dateTime" }, "live_at": { "type": "string", "format": "dateTime" }, "done_at": { "type": "string", "format": "dateTime" }, "title": { "type": "string" } } } } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } }, "post": { "operationId": "createSiteDevServer", "tags": [ "devServer" ], "parameters": [ { "name": "branch", "type": "string", "in": "query" } ], "responses": { "200": { "description": "OK", "schema": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "site_id": { "type": "string" }, "branch": { "type": "string" }, "url": { "type": "string" }, "state": { "type": "string" }, "created_at": { "type": "string", "format": "dateTime" }, "updated_at": { "type": "string", "format": "dateTime" }, "starting_at": { "type": "string", "format": "dateTime" }, "error_at": { "type": "string", "format": "dateTime" }, "live_at": { "type": "string", "format": "dateTime" }, "done_at": { "type": "string", "format": "dateTime" }, "title": { "type": "string" } } } } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } }, "delete": { "operationId": "deleteSiteDevServers", "tags": [ "devServer" ], "parameters": [ { "name": "branch", "type": "string", "in": "query" } ], "responses": { "202": { "description": "OK" }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } } }, "/sites/{site_id}/dev_servers/{dev_server_id}": { "parameters": [ { "name": "site_id", "type": "string", "in": "path", "required": true }, { "name": "dev_server_id", "type": "string", "in": "path", "required": true } ], "get": { "operationId": "getSiteDevServer", "tags": [ "devServer" ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "properties": { "id": { "type": "string" }, "site_id": { "type": "string" }, "branch": { "type": "string" }, "url": { "type": "string" }, "state": { "type": "string" }, "created_at": { "type": "string", "format": "dateTime" }, "updated_at": { "type": "string", "format": "dateTime" }, "starting_at": { "type": "string", "format": "dateTime" }, "error_at": { "type": "string", "format": "dateTime" }, "live_at": { "type": "string", "format": "dateTime" }, "done_at": { "type": "string", "format": "dateTime" }, "title": { "type": "string" } } } } } } }, "/sites/{site_id}/dev_servers/{dev_server_id}/activity": { "parameters": [ { "name": "site_id", "type": "string", "in": "path", "required": true }, { "name": "dev_server_id", "type": "string", "in": "path", "required": true } ], "post": { "x-internal": true, "operationId": "markDevServerActivity", "tags": [ "devServer" ], "responses": { "200": { "description": "OK" } } } }, "/sites/{site_id}/dev_server_hooks": { "parameters": [ { "name": "site_id", "type": "string", "in": "path", "required": true } ], "get": { "operationId": "listSiteDevServerHooks", "tags": [ "devServerHook" ], "responses": { "200": { "description": "OK", "schema": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "title": { "type": "string" }, "branch": { "type": "string" }, "url": { "type": "string" }, "site_id": { "type": "string" }, "created_at": { "type": "string", "format": "dateTime" }, "type": { "type": "string", "enum": [ "new_dev_server", "content_refresh" ] } } } } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } }, "post": { "operationId": "createSiteDevServerHook", "tags": [ "devServerHook" ], "consumes": [ "application/json" ], "parameters": [ { "name": "devServerHook", "in": "body", "schema": { "type": "object", "properties": { "title": { "type": "string" }, "branch": { "type": "string" }, "type": { "type": "string", "enum": [ "new_dev_server", "content_refresh" ] } } }, "required": true } ], "responses": { "201": { "description": "Created", "schema": { "type": "object", "properties": { "id": { "type": "string" }, "title": { "type": "string" }, "branch": { "type": "string" }, "url": { "type": "string" }, "site_id": { "type": "string" }, "created_at": { "type": "string", "format": "dateTime" }, "type": { "type": "string", "enum": [ "new_dev_server", "content_refresh" ] } } } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } } }, "/sites/{site_id}/dev_server_hooks/{id}": { "parameters": [ { "name": "site_id", "type": "string", "in": "path", "required": true }, { "name": "id", "type": "string", "in": "path", "required": true } ], "get": { "operationId": "getSiteDevServerHook", "tags": [ "devServerHook" ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "properties": { "id": { "type": "string" }, "title": { "type": "string" }, "branch": { "type": "string" }, "url": { "type": "string" }, "site_id": { "type": "string" }, "created_at": { "type": "string", "format": "dateTime" }, "type": { "type": "string", "enum": [ "new_dev_server", "content_refresh" ] } } } }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } }, "put": { "operationId": "updateSiteDevServerHook", "tags": [ "devServerHook" ], "consumes": [ "application/json" ], "parameters": [ { "name": "devServerHook", "in": "body", "schema": { "type": "object", "properties": { "title": { "type": "string" }, "branch": { "type": "string" }, "type": { "type": "string", "enum": [ "new_dev_server", "content_refresh" ] } } }, "required": true } ], "responses": { "204": { "description": "No content" }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } }, "delete": { "operationId": "deleteSiteDevServerHook", "tags": [ "devServerHook" ], "responses": { "204": { "description": "No content" }, "default": { "description": "error", "schema": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } } } } } } }, "definitions": { "DeployValidationsReport": { "type": "object", "properties": { "id": { "type": "string", "description": "The id of the deploy validations report" }, "deploy_id": { "type": "string", "description": "The id of the deploy" }, "secret_scan_result": { "type": "object", "properties": { "scannedFilesCount": { "type": "integer", "description": "The number of files scanned" }, "secretsScanMatches": { "type": "array", "items": { "type": "string" }, "description": "The list of secrets scan matches" } } } } }, "DeployValidationsReport_SecretScanResult": { "type": "object", "properties": { "scannedFilesCount": { "type": "integer", "description": "The number of files scanned" }, "secretsScanMatches": { "type": "array", "items": { "type": "string" }, "description": "The list of secrets scan matches" } } }, "splitTestSetup": { "type": "object", "properties": { "branch_tests": { "type": "object" } } }, "splitTests": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "site_id": { "type": "string" }, "name": { "type": "string" }, "path": { "type": "string" }, "branches": { "type": "array", "items": { "type": "object" } }, "active": { "type": "boolean" }, "created_at": { "type": "string", "format": "dateTime" }, "updated_at": { "type": "string", "format": "dateTime" }, "unpublished_at": { "type": "string", "format": "dateTime" } } } }, "splitTest": { "type": "object", "properties": { "id": { "type": "string" }, "site_id": { "type": "string" }, "name": { "type": "string" }, "path": { "type": "string" }, "branches": { "type": "array", "items": { "type": "object" } }, "active": { "type": "boolean" }, "created_at": { "type": "string", "format": "dateTime" }, "updated_at": { "type": "string", "format": "dateTime" }, "unpublished_at": { "type": "string", "format": "dateTime" } } }, "serviceInstance": { "type": "object", "properties": { "id": { "type": "string" }, "url": { "type": "string" }, "config": { "type": "object" }, "external_attributes": { "type": "object" }, "service_slug": { "type": "string" }, "service_path": { "type": "string" }, "service_name": { "type": "string" }, "env": { "type": "object" }, "snippets": { "type": "array", "items": { "type": "object" } }, "auth_url": { "type": "string" }, "created_at": { "type": "string", "format": "dateTime" }, "updated_at": { "type": "string", "format": "dateTime" } } }, "service": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "slug": { "type": "string" }, "service_path": { "type": "string" }, "long_description": { "type": "string" }, "description": { "type": "string" }, "events": { "type": "array", "items": { "type": "object" } }, "tags": { "type": "array", "items": { "type": "string" } }, "icon": { "type": "string" }, "manifest_url": { "type": "string" }, "environments": { "type": "array", "items": { "type": "string" } }, "created_at": { "type": "string", "format": "dateTime" }, "updated_at": { "type": "string", "format": "dateTime" } } }, "site": { "type": "object", "properties": { "id": { "type": "string" }, "state": { "type": "string" }, "plan": { "type": "string" }, "name": { "type": "string" }, "custom_domain": { "type": "string" }, "domain_aliases": { "type": "array", "items": { "type": "string" } }, "branch_deploy_custom_domain": { "type": "string" }, "deploy_preview_custom_domain": { "type": "string" }, "password": { "type": "string" }, "notification_email": { "type": "string" }, "url": { "type": "string" }, "ssl_url": { "type": "string" }, "admin_url": { "type": "string" }, "screenshot_url": { "type": "string" }, "created_at": { "type": "string", "format": "dateTime" }, "updated_at": { "type": "string", "format": "dateTime" }, "user_id": { "type": "string" }, "session_id": { "type": "string" }, "ssl": { "type": "boolean" }, "force_ssl": { "type": "boolean" }, "managed_dns": { "type": "boolean" }, "deploy_url": { "type": "string" }, "published_deploy": { "type": "object", "properties": { "id": { "type": "string" }, "site_id": { "type": "string" }, "user_id": { "type": "string" }, "build_id": { "type": "string" }, "state": { "type": "string" }, "name": { "type": "string" }, "url": { "type": "string" }, "ssl_url": { "type": "string" }, "admin_url": { "type": "string" }, "deploy_url": { "type": "string" }, "deploy_ssl_url": { "type": "string" }, "screenshot_url": { "type": "string" }, "review_id": { "type": "number" }, "draft": { "type": "boolean" }, "required": { "type": "array", "items": { "type": "string" } }, "required_functions": { "type": "array", "items": { "type": "string" } }, "error_message": { "type": "string" }, "branch": { "type": "string" }, "commit_ref": { "type": "string" }, "commit_url": { "type": "string" }, "skipped": { "type": "boolean" }, "created_at": { "type": "string", "format": "dateTime" }, "updated_at": { "type": "string", "format": "dateTime" }, "published_at": { "type": "string", "format": "dateTime" }, "title": { "type": "string" }, "context": { "type": "string" }, "locked": { "type": "boolean" }, "review_url": { "type": "string" }, "framework": { "type": "string" }, "function_schedules": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "cron": { "type": "string" } } } } } }, "account_id": { "type": "string" }, "account_name": { "type": "string" }, "account_slug": { "type": "string" }, "git_provider": { "type": "string" }, "deploy_hook": { "type": "string" }, "capabilities": { "type": "object", "additionalProperties": { "type": "object" } }, "processing_settings": { "type": "object", "properties": { "html": { "type": "object", "properties": { "pretty_urls": { "type": "boolean" } } } } }, "build_settings": { "type": "object", "properties": { "id": { "type": "integer" }, "provider": { "type": "string" }, "deploy_key_id": { "type": "string" }, "repo_path": { "type": "string" }, "repo_branch": { "type": "string" }, "dir": { "type": "string" }, "functions_dir": { "type": "string" }, "cmd": { "type": "string" }, "allowed_branches": { "type": "array", "items": { "type": "string" } }, "public_repo": { "type": "boolean" }, "private_logs": { "type": "boolean" }, "repo_url": { "type": "string" }, "env": { "type": "object", "additionalProperties": { "type": "string" } }, "installation_id": { "type": "integer" }, "stop_builds": { "type": "boolean" } } }, "id_domain": { "type": "string" }, "default_hooks_data": { "type": "object", "properties": { "access_token": { "type": "string" } } }, "build_image": { "type": "string" }, "prerender": { "type": "string" }, "functions_region": { "type": "string" } } }, "siteSetup": { "allOf": [ { "type": "object", "properties": { "id": { "type": "string" }, "state": { "type": "string" }, "plan": { "type": "string" }, "name": { "type": "string" }, "custom_domain": { "type": "string" }, "domain_aliases": { "type": "array", "items": { "type": "string" } }, "branch_deploy_custom_domain": { "type": "string" }, "deploy_preview_custom_domain": { "type": "string" }, "password": { "type": "string" }, "notification_email": { "type": "string" }, "url": { "type": "string" }, "ssl_url": { "type": "string" }, "admin_url": { "type": "string" }, "screenshot_url": { "type": "string" }, "created_at": { "type": "string", "format": "dateTime" }, "updated_at": { "type": "string", "format": "dateTime" }, "user_id": { "type": "string" }, "session_id": { "type": "string" }, "ssl": { "type": "boolean" }, "force_ssl": { "type": "boolean" }, "managed_dns": { "type": "boolean" }, "deploy_url": { "type": "string" }, "published_deploy": { "type": "object", "properties": { "id": { "type": "string" }, "site_id": { "type": "string" }, "user_id": { "type": "string" }, "build_id": { "type": "string" }, "state": { "type": "string" }, "name": { "type": "string" }, "url": { "type": "string" }, "ssl_url": { "type": "string" }, "admin_url": { "type": "string" }, "deploy_url": { "type": "string" }, "deploy_ssl_url": { "type": "string" }, "screenshot_url": { "type": "string" }, "review_id": { "type": "number" }, "draft": { "type": "boolean" }, "required": { "type": "array", "items": { "type": "string" } }, "required_functions": { "type": "array", "items": { "type": "string" } }, "error_message": { "type": "string" }, "branch": { "type": "string" }, "commit_ref": { "type": "string" }, "commit_url": { "type": "string" }, "skipped": { "type": "boolean" }, "created_at": { "type": "string", "format": "dateTime" }, "updated_at": { "type": "string", "format": "dateTime" }, "published_at": { "type": "string", "format": "dateTime" }, "title": { "type": "string" }, "context": { "type": "string" }, "locked": { "type": "boolean" }, "review_url": { "type": "string" }, "framework": { "type": "string" }, "function_schedules": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "cron": { "type": "string" } } } } } }, "account_id": { "type": "string" }, "account_name": { "type": "string" }, "account_slug": { "type": "string" }, "git_provider": { "type": "string" }, "deploy_hook": { "type": "string" }, "capabilities": { "type": "object", "additionalProperties": { "type": "object" } }, "processing_settings": { "type": "object", "properties": { "html": { "type": "object", "properties": { "pretty_urls": { "type": "boolean" } } } } }, "build_settings": { "type": "object", "properties": { "id": { "type": "integer" }, "provider": { "type": "string" }, "deploy_key_id": { "type": "string" }, "repo_path": { "type": "string" }, "repo_branch": { "type": "string" }, "dir": { "type": "string" }, "functions_dir": { "type": "string" }, "cmd": { "type": "string" }, "allowed_branches": { "type": "array", "items": { "type": "string" } }, "public_repo": { "type": "boolean" }, "private_logs": { "type": "boolean" }, "repo_url": { "type": "string" }, "env": { "type": "object", "additionalProperties": { "type": "string" } }, "installation_id": { "type": "integer" }, "stop_builds": { "type": "boolean" } } }, "id_domain": { "type": "string" }, "default_hooks_data": { "type": "object", "properties": { "access_token": { "type": "string" } } }, "build_image": { "type": "string" }, "prerender": { "type": "string" }, "functions_region": { "type": "string" } } }, { "properties": { "repo": { "type": "object", "properties": { "id": { "type": "integer" }, "provider": { "type": "string" }, "deploy_key_id": { "type": "string" }, "repo_path": { "type": "string" }, "repo_branch": { "type": "string" }, "dir": { "type": "string" }, "functions_dir": { "type": "string" }, "cmd": { "type": "string" }, "allowed_branches": { "type": "array", "items": { "type": "string" } }, "public_repo": { "type": "boolean" }, "private_logs": { "type": "boolean" }, "repo_url": { "type": "string" }, "env": { "type": "object", "additionalProperties": { "type": "string" } }, "installation_id": { "type": "integer" }, "stop_builds": { "type": "boolean" } } } } } ] }, "repoInfo": { "type": "object", "properties": { "id": { "type": "integer" }, "provider": { "type": "string" }, "deploy_key_id": { "type": "string" }, "repo_path": { "type": "string" }, "repo_branch": { "type": "string" }, "dir": { "type": "string" }, "functions_dir": { "type": "string" }, "cmd": { "type": "string" }, "allowed_branches": { "type": "array", "items": { "type": "string" } }, "public_repo": { "type": "boolean" }, "private_logs": { "type": "boolean" }, "repo_url": { "type": "string" }, "env": { "type": "object", "additionalProperties": { "type": "string" } }, "installation_id": { "type": "integer" }, "stop_builds": { "type": "boolean" } } }, "submission": { "type": "object", "properties": { "id": { "type": "string" }, "number": { "type": "integer", "format": "int32" }, "email": { "type": "string" }, "name": { "type": "string" }, "first_name": { "type": "string" }, "last_name": { "type": "string" }, "company": { "type": "string" }, "summary": { "type": "string" }, "body": { "type": "string" }, "data": { "type": "object" }, "created_at": { "type": "string", "format": "dateTime" }, "site_url": { "type": "string" } } }, "envVar": { "type": "object", "properties": { "key": { "type": "string", "description": "The environment variable key, like ALGOLIA_ID (case-sensitive)", "x-faker": "commerce.productName" }, "scopes": { "type": "array", "items": { "type": "string", "enum": [ "builds", "functions", "runtime", "post-processing" ] }, "description": "The scopes that this environment variable is set to" }, "values": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "description": "The environment variable value's universally unique ID", "x-faker": "datatype.uuid" }, "value": { "type": "string", "description": "The environment variable's unencrypted value", "x-faker": "internet.password" }, "context": { "type": "string", "enum": [ "all", "dev", "branch-deploy", "deploy-preview", "production", "branch" ], "description": "The deploy context in which this value will be used. `dev` refers to local development when running `netlify dev`." }, "context_parameter": { "type": "string", "description": "An additional parameter for custom branches. Currently, this is used for specifying a branch name when `context=branch`." } }, "description": "Environment variable value model definition" }, "description": "An array of Value objects containing values and metadata", "x-faker": "internet.password" }, "is_secret": { "type": "boolean", "description": "Secret values are only readable by code running on Netlify's systems. With secrets, only the local development context values are readable from the UI, API, and CLI. By default, environment variable values are not secret." }, "updated_at": { "type": "string", "format": "date-time", "description": "The timestamp of when the value was last updated", "x-faker": "date.past" }, "updated_by": { "type": "object", "properties": { "id": { "type": "string", "description": "The user's unique identifier", "x-faker": "datatype.number" }, "full_name": { "type": "string", "description": "The user's full name (first and last)", "x-faker": "name.findName" }, "email": { "type": "string", "description": "The user's email address", "x-faker": "internet.email" }, "avatar_url": { "type": "string", "description": "A URL pointing to the user's avatar", "x-faker": "internet.avatar" } } } }, "description": "Environment variable model definition" }, "envVarValue": { "type": "object", "properties": { "id": { "type": "string", "description": "The environment variable value's universally unique ID", "x-faker": "datatype.uuid" }, "value": { "type": "string", "description": "The environment variable's unencrypted value", "x-faker": "internet.password" }, "context": { "type": "string", "enum": [ "all", "dev", "branch-deploy", "deploy-preview", "production", "branch" ], "description": "The deploy context in which this value will be used. `dev` refers to local development when running `netlify dev`." }, "context_parameter": { "type": "string", "description": "An additional parameter for custom branches. Currently, this is used for specifying a branch name when `context=branch`." } }, "description": "Environment variable value model definition" }, "envVarUser": { "type": "object", "properties": { "id": { "type": "string", "description": "The user's unique identifier", "x-faker": "datatype.number" }, "full_name": { "type": "string", "description": "The user's full name (first and last)", "x-faker": "name.findName" }, "email": { "type": "string", "description": "The user's email address", "x-faker": "internet.email" }, "avatar_url": { "type": "string", "description": "A URL pointing to the user's avatar", "x-faker": "internet.avatar" } } }, "form": { "type": "object", "properties": { "id": { "type": "string" }, "site_id": { "type": "string" }, "name": { "type": "string" }, "paths": { "type": "array", "items": { "type": "string" } }, "submission_count": { "type": "integer", "format": "int32" }, "fields": { "type": "array", "items": { "type": "object" } }, "created_at": { "type": "string", "format": "dateTime" } } }, "hookType": { "type": "object", "properties": { "name": { "type": "string" }, "events": { "type": "array", "items": { "type": "string" } }, "fields": { "type": "array", "items": { "type": "object" } } } }, "hook": { "type": "object", "properties": { "id": { "type": "string" }, "site_id": { "type": "string" }, "type": { "type": "string" }, "event": { "type": "string" }, "data": { "type": "object" }, "created_at": { "type": "string", "format": "dateTime" }, "updated_at": { "type": "string", "format": "dateTime" }, "disabled": { "type": "boolean" } } }, "file": { "type": "object", "properties": { "id": { "type": "string" }, "path": { "type": "string" }, "sha": { "type": "string" }, "mime_type": { "type": "string" }, "size": { "type": "integer", "format": "int64" } } }, "function": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "sha": { "type": "string" } } }, "snippet": { "type": "object", "properties": { "id": { "type": "integer", "format": "int32" }, "site_id": { "type": "string" }, "title": { "type": "string" }, "general": { "type": "string" }, "general_position": { "type": "string" }, "goal": { "type": "string" }, "goal_position": { "type": "string" } } }, "purge": { "type": "object", "properties": { "site_id": { "type": "string" }, "site_slug": { "type": "string" }, "cache_tags": { "type": "array", "items": { "type": "string" } } } }, "deploy": { "type": "object", "properties": { "id": { "type": "string" }, "site_id": { "type": "string" }, "user_id": { "type": "string" }, "build_id": { "type": "string" }, "state": { "type": "string" }, "name": { "type": "string" }, "url": { "type": "string" }, "ssl_url": { "type": "string" }, "admin_url": { "type": "string" }, "deploy_url": { "type": "string" }, "deploy_ssl_url": { "type": "string" }, "screenshot_url": { "type": "string" }, "review_id": { "type": "number" }, "draft": { "type": "boolean" }, "required": { "type": "array", "items": { "type": "string" } }, "required_functions": { "type": "array", "items": { "type": "string" } }, "error_message": { "type": "string" }, "branch": { "type": "string" }, "commit_ref": { "type": "string" }, "commit_url": { "type": "string" }, "skipped": { "type": "boolean" }, "created_at": { "type": "string", "format": "dateTime" }, "updated_at": { "type": "string", "format": "dateTime" }, "published_at": { "type": "string", "format": "dateTime" }, "title": { "type": "string" }, "context": { "type": "string" }, "locked": { "type": "boolean" }, "review_url": { "type": "string" }, "framework": { "type": "string" }, "function_schedules": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "cron": { "type": "string" } } } } } }, "deployFiles": { "type": "object", "properties": { "files": { "type": "object" }, "draft": { "type": "boolean" }, "async": { "type": "boolean" }, "functions": { "type": "object" }, "function_schedules": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "cron": { "type": "string" } } } }, "functions_config": { "type": "object", "additionalProperties": { "type": "object", "properties": { "display_name": { "type": "string" }, "generator": { "type": "string" }, "build_data": { "type": "object" }, "routes": { "type": "array", "items": { "type": "object", "properties": { "pattern": { "type": "string" }, "literal": { "type": "string" }, "expression": { "type": "string" }, "methods": { "type": "array", "items": { "type": "string", "enum": [ "GET", "POST", "PUT", "PATCH", "DELETE", "OPTIONS" ] } }, "prefer_static": { "type": "boolean" } } } }, "excluded_routes": { "type": "array", "items": { "type": "object", "properties": { "pattern": { "type": "string" }, "literal": { "type": "string" }, "expression": { "type": "string" } } } }, "priority": { "type": "integer" }, "traffic_rules": { "type": "object", "properties": { "action": { "type": "object", "properties": { "type": { "type": "string" }, "config": { "type": "object", "properties": { "to": { "type": "string" }, "rate_limit_config": { "type": "object", "properties": { "algorithm": { "type": "string", "enum": [ "sliding_window" ] }, "window_size": { "type": "integer" }, "window_limit": { "type": "integer" } } }, "aggregate": { "type": "object", "properties": { "keys": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "ip", "domain" ] } } } } } } } } } } } } } } }, "branch": { "type": "string" }, "framework": { "type": "string" }, "framework_version": { "type": "string" } } }, "pluginParams": { "type": "object", "properties": { "pinned_version": { "type": "string" } } }, "plugin": { "type": "object", "properties": { "package": { "type": "string" }, "pinned_version": { "type": "string" } } }, "buildStatus": { "type": "object", "properties": { "active": { "type": "integer" }, "pending_concurrency": { "type": "integer" }, "enqueued": { "type": "integer" }, "build_count": { "type": "integer" }, "minutes": { "type": "object", "properties": { "current": { "type": "integer" }, "current_average_sec": { "type": "integer" }, "previous": { "type": "integer" }, "period_start_date": { "type": "string", "format": "dateTime" }, "period_end_date": { "type": "string", "format": "dateTime" }, "last_updated_at": { "type": "string", "format": "dateTime" }, "included_minutes": { "type": "string" }, "included_minutes_with_packs": { "type": "string" } } } } }, "build": { "type": "object", "properties": { "id": { "type": "string" }, "deploy_id": { "type": "string" }, "sha": { "type": "string" }, "done": { "type": "boolean" }, "error": { "type": "string" }, "created_at": { "type": "string", "format": "dateTime" } } }, "buildLogMsg": { "type": "object", "properties": { "message": { "type": "string" }, "error": { "type": "boolean" }, "section": { "type": "string", "enum": [ "initializing", "building", "deploying", "cleanup", "postprocessing" ] } } }, "pluginRunData": { "type": "object", "properties": { "package": { "type": "string" }, "version": { "type": "string" }, "state": { "type": "string" }, "reporting_event": { "type": "string" }, "title": { "type": "string" }, "summary": { "type": "string" }, "text": { "type": "string" } } }, "pluginRun": { "allOf": [ { "type": "object", "properties": { "package": { "type": "string" }, "version": { "type": "string" }, "state": { "type": "string" }, "reporting_event": { "type": "string" }, "title": { "type": "string" }, "summary": { "type": "string" }, "text": { "type": "string" } } }, { "type": "object", "properties": { "deploy_id": { "type": "string" } } } ] }, "metadata": { "type": "object" }, "dnsZoneSetup": { "type": "object", "properties": { "account_slug": { "type": "string" }, "site_id": { "type": "string" }, "name": { "type": "string" } } }, "dnsZones": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "errors": { "type": "array", "items": { "type": "string" } }, "supported_record_types": { "type": "array", "items": { "type": "string" } }, "user_id": { "type": "string" }, "created_at": { "type": "string", "format": "dateTime" }, "updated_at": { "type": "string", "format": "dateTime" }, "records": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "hostname": { "type": "string" }, "type": { "type": "string" }, "value": { "type": "string" }, "ttl": { "type": "integer", "format": "int64" }, "priority": { "type": "integer", "format": "int64" }, "dns_zone_id": { "type": "string" }, "site_id": { "type": "string" }, "flag": { "type": "integer" }, "tag": { "type": "string" }, "managed": { "type": "boolean" } } } }, "dns_servers": { "type": "array", "items": { "type": "string" } }, "account_id": { "type": "string" }, "site_id": { "type": "string" }, "account_slug": { "type": "string" }, "account_name": { "type": "string" }, "domain": { "type": "string" }, "ipv6_enabled": { "type": "boolean" }, "dedicated": { "type": "boolean" } } } }, "dnsZone": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "errors": { "type": "array", "items": { "type": "string" } }, "supported_record_types": { "type": "array", "items": { "type": "string" } }, "user_id": { "type": "string" }, "created_at": { "type": "string", "format": "dateTime" }, "updated_at": { "type": "string", "format": "dateTime" }, "records": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "hostname": { "type": "string" }, "type": { "type": "string" }, "value": { "type": "string" }, "ttl": { "type": "integer", "format": "int64" }, "priority": { "type": "integer", "format": "int64" }, "dns_zone_id": { "type": "string" }, "site_id": { "type": "string" }, "flag": { "type": "integer" }, "tag": { "type": "string" }, "managed": { "type": "boolean" } } } }, "dns_servers": { "type": "array", "items": { "type": "string" } }, "account_id": { "type": "string" }, "site_id": { "type": "string" }, "account_slug": { "type": "string" }, "account_name": { "type": "string" }, "domain": { "type": "string" }, "ipv6_enabled": { "type": "boolean" }, "dedicated": { "type": "boolean" } } }, "dnsRecordCreate": { "type": "object", "properties": { "type": { "type": "string" }, "hostname": { "type": "string" }, "value": { "type": "string" }, "ttl": { "type": "integer", "format": "int64" }, "priority": { "type": "integer", "format": "int64" }, "weight": { "type": "integer", "format": "int64" }, "port": { "type": "integer", "format": "int64" }, "flag": { "type": "integer", "format": "int64" }, "tag": { "type": "string" } } }, "dnsRecords": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "hostname": { "type": "string" }, "type": { "type": "string" }, "value": { "type": "string" }, "ttl": { "type": "integer", "format": "int64" }, "priority": { "type": "integer", "format": "int64" }, "dns_zone_id": { "type": "string" }, "site_id": { "type": "string" }, "flag": { "type": "integer" }, "tag": { "type": "string" }, "managed": { "type": "boolean" } } } }, "dnsRecord": { "type": "object", "properties": { "id": { "type": "string" }, "hostname": { "type": "string" }, "type": { "type": "string" }, "value": { "type": "string" }, "ttl": { "type": "integer", "format": "int64" }, "priority": { "type": "integer", "format": "int64" }, "dns_zone_id": { "type": "string" }, "site_id": { "type": "string" }, "flag": { "type": "integer" }, "tag": { "type": "string" }, "managed": { "type": "boolean" } } }, "sniCertificate": { "type": "object", "properties": { "state": { "type": "string" }, "domains": { "type": "array", "items": { "type": "string" } }, "created_at": { "type": "string", "format": "dateTime" }, "updated_at": { "type": "string", "format": "dateTime" }, "expires_at": { "type": "string", "format": "dateTime" } } }, "ticket": { "type": "object", "properties": { "id": { "type": "string" }, "client_id": { "type": "string" }, "authorized": { "type": "boolean" }, "created_at": { "type": "string", "format": "dateTime" } } }, "accessToken": { "type": "object", "properties": { "id": { "type": "string" }, "access_token": { "type": "string" }, "user_id": { "type": "string" }, "user_email": { "type": "string" }, "created_at": { "type": "string", "format": "dateTime" } } }, "asset": { "type": "object", "properties": { "id": { "type": "string" }, "site_id": { "type": "string" }, "creator_id": { "type": "string" }, "name": { "type": "string" }, "state": { "type": "string" }, "content_type": { "type": "string" }, "url": { "type": "string" }, "key": { "type": "string" }, "visibility": { "type": "string" }, "size": { "type": "integer", "format": "int64" }, "created_at": { "type": "string", "format": "dateTime" }, "updated_at": { "type": "string", "format": "dateTime" } } }, "assetForm": { "type": "object", "properties": { "url": { "type": "string" }, "fields": { "type": "object", "additionalProperties": { "type": "string" } } } }, "assetSignature": { "type": "object", "properties": { "form": { "type": "object", "properties": { "url": { "type": "string" }, "fields": { "type": "object", "additionalProperties": { "type": "string" } } } }, "asset": { "type": "object", "properties": { "id": { "type": "string" }, "site_id": { "type": "string" }, "creator_id": { "type": "string" }, "name": { "type": "string" }, "state": { "type": "string" }, "content_type": { "type": "string" }, "url": { "type": "string" }, "key": { "type": "string" }, "visibility": { "type": "string" }, "size": { "type": "integer", "format": "int64" }, "created_at": { "type": "string", "format": "dateTime" }, "updated_at": { "type": "string", "format": "dateTime" } } } } }, "assetPublicSignature": { "type": "object", "properties": { "url": { "type": "string" } } }, "deployKey": { "type": "object", "properties": { "id": { "type": "string" }, "public_key": { "type": "string" }, "created_at": { "type": "string", "format": "dateTime" } } }, "member": { "type": "object", "properties": { "id": { "type": "string" }, "full_name": { "type": "string" }, "email": { "type": "string" }, "avatar": { "type": "string" }, "role": { "type": "string" } } }, "paymentMethod": { "type": "object", "properties": { "id": { "type": "string" }, "method_name": { "type": "string" }, "type": { "type": "string" }, "state": { "type": "string" }, "data": { "type": "object", "properties": { "card_type": { "type": "string" }, "last4": { "type": "string" }, "email": { "type": "string" } } }, "created_at": { "type": "string", "format": "dateTime" }, "updated_at": { "type": "string", "format": "dateTime" } } }, "accountType": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "description": { "type": "string" }, "capabilities": { "type": "object" }, "monthly_dollar_price": { "type": "integer" }, "yearly_dollar_price": { "type": "integer" }, "monthly_seats_addon_dollar_price": { "type": "integer" }, "yearly_seats_addon_dollar_price": { "type": "integer" } } }, "accountSetup": { "type": "object", "required": [ "name", "type_id" ], "properties": { "name": { "type": "string" }, "type_id": { "type": "string" }, "payment_method_id": { "type": "string" }, "period": { "type": "string", "enum": [ "monthly", "yearly" ] }, "extra_seats_block": { "type": "integer" } } }, "accountUpdateSetup": { "type": "object", "properties": { "name": { "type": "string" }, "slug": { "type": "string" }, "type_id": { "type": "string" }, "extra_seats_block": { "type": "integer" }, "billing_name": { "type": "string" }, "billing_email": { "type": "string" }, "billing_details": { "type": "string" } } }, "accountAddMemberSetup": { "type": "object", "properties": { "role": { "type": "string", "enum": [ "Owner", "Developer", "Billing Admin", "Reviewer" ] }, "email": { "type": "string" } } }, "accountUpdateMemberSetup": { "type": "object", "properties": { "role": { "type": "string", "enum": [ "Owner", "Developer", "Billing Admin", "Reviewer" ] }, "site_access": { "type": "string", "enum": [ "all", "none", "selected" ] }, "site_ids": { "type": "array", "items": { "type": "string" } } } }, "accountMembership": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "slug": { "type": "string" }, "type": { "type": "string" }, "capabilities": { "type": "object", "properties": { "sites": { "type": "object", "properties": { "included": { "type": "integer" }, "used": { "type": "integer" } } }, "collaborators": { "type": "object", "properties": { "included": { "type": "integer" }, "used": { "type": "integer" } } } } }, "billing_name": { "type": "string" }, "billing_email": { "type": "string" }, "billing_details": { "type": "string" }, "billing_period": { "type": "string" }, "payment_method_id": { "type": "string" }, "type_name": { "type": "string" }, "type_id": { "type": "string" }, "owner_ids": { "type": "array", "items": { "type": "string" } }, "roles_allowed": { "type": "array", "items": { "type": "string" } }, "created_at": { "type": "string", "format": "dateTime" }, "updated_at": { "type": "string", "format": "dateTime" } } }, "auditLog": { "type": "object", "properties": { "id": { "type": "string" }, "account_id": { "type": "string" }, "payload": { "type": "object", "properties": { "actor_id": { "type": "string" }, "actor_name": { "type": "string" }, "actor_email": { "type": "string" }, "action": { "type": "string" }, "timestamp": { "type": "string", "format": "dateTime" }, "log_type": { "type": "string" } }, "additionalProperties": { "type": "object" } } } }, "accountUsageCapability": { "type": "object", "properties": { "included": { "type": "integer" }, "used": { "type": "integer" } } }, "buildSetup": { "type": "object", "properties": { "image": { "type": "string" }, "clear_cache": { "type": "boolean" } } }, "buildHookSetup": { "type": "object", "properties": { "title": { "type": "string" }, "branch": { "type": "string" } } }, "buildHook": { "type": "object", "properties": { "id": { "type": "string" }, "title": { "type": "string" }, "branch": { "type": "string" }, "url": { "type": "string" }, "site_id": { "type": "string" }, "created_at": { "type": "string", "format": "dateTime" } } }, "deployedBranch": { "type": "object", "properties": { "id": { "type": "string" }, "deploy_id": { "type": "string" }, "name": { "type": "string" }, "slug": { "type": "string" }, "url": { "type": "string" }, "ssl_url": { "type": "string" } } }, "user": { "type": "object", "properties": { "id": { "type": "string" }, "uid": { "type": "string" }, "full_name": { "type": "string" }, "avatar_url": { "type": "string" }, "email": { "type": "string" }, "affiliate_id": { "type": "string" }, "site_count": { "type": "integer", "format": "int64" }, "created_at": { "type": "string", "format": "dateTime" }, "last_login": { "type": "string", "format": "dateTime" }, "login_providers": { "type": "array", "items": { "type": "string" } }, "onboarding_progress": { "type": "object", "properties": { "slides": { "type": "string" } } } } }, "error": { "type": "object", "required": [ "message" ], "properties": { "code": { "type": "integer", "format": "int64" }, "message": { "type": "string", "x-nullable": false } } }, "functionSchedule": { "type": "object", "properties": { "name": { "type": "string" }, "cron": { "type": "string" } } }, "functionConfig": { "type": "object", "properties": { "display_name": { "type": "string" }, "generator": { "type": "string" }, "build_data": { "type": "object" }, "routes": { "type": "array", "items": { "type": "object", "properties": { "pattern": { "type": "string" }, "literal": { "type": "string" }, "expression": { "type": "string" }, "methods": { "type": "array", "items": { "type": "string", "enum": [ "GET", "POST", "PUT", "PATCH", "DELETE", "OPTIONS" ] } }, "prefer_static": { "type": "boolean" } } } }, "excluded_routes": { "type": "array", "items": { "type": "object", "properties": { "pattern": { "type": "string" }, "literal": { "type": "string" }, "expression": { "type": "string" } } } }, "priority": { "type": "integer" }, "traffic_rules": { "type": "object", "properties": { "action": { "type": "object", "properties": { "type": { "type": "string" }, "config": { "type": "object", "properties": { "to": { "type": "string" }, "rate_limit_config": { "type": "object", "properties": { "algorithm": { "type": "string", "enum": [ "sliding_window" ] }, "window_size": { "type": "integer" }, "window_limit": { "type": "integer" } } }, "aggregate": { "type": "object", "properties": { "keys": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "ip", "domain" ] } } } } } } } } } } } } } }, "functionRoute": { "type": "object", "properties": { "pattern": { "type": "string" }, "literal": { "type": "string" }, "expression": { "type": "string" }, "methods": { "type": "array", "items": { "type": "string", "enum": [ "GET", "POST", "PUT", "PATCH", "DELETE", "OPTIONS" ] } }, "prefer_static": { "type": "boolean" } } }, "excludedFunctionRoute": { "type": "object", "properties": { "pattern": { "type": "string" }, "literal": { "type": "string" }, "expression": { "type": "string" } } }, "trafficRulesConfig": { "type": "object", "properties": { "action": { "type": "object", "properties": { "type": { "type": "string" }, "config": { "type": "object", "properties": { "to": { "type": "string" }, "rate_limit_config": { "type": "object", "properties": { "algorithm": { "type": "string", "enum": [ "sliding_window" ] }, "window_size": { "type": "integer" }, "window_limit": { "type": "integer" } } }, "aggregate": { "type": "object", "properties": { "keys": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "ip", "domain" ] } } } } } } } } } } } }, "trafficRulesRateLimitConfig": { "type": "object", "properties": { "algorithm": { "type": "string", "enum": [ "sliding_window" ] }, "window_size": { "type": "integer" }, "window_limit": { "type": "integer" } } }, "trafficRulesAggregateConfig": { "type": "object", "properties": { "keys": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "ip", "domain" ] } } } } } }, "siteFunction": { "type": "object", "properties": { "branch": { "type": "string" }, "created_at": { "type": "string", "format": "dateTime" }, "functions": { "type": "array", "items": { "type": "object" } }, "id": { "type": "string" }, "log_type": { "type": "string" }, "provider": { "type": "string" } } }, "devServer": { "type": "object", "properties": { "id": { "type": "string" }, "site_id": { "type": "string" }, "branch": { "type": "string" }, "url": { "type": "string" }, "state": { "type": "string" }, "created_at": { "type": "string", "format": "dateTime" }, "updated_at": { "type": "string", "format": "dateTime" }, "starting_at": { "type": "string", "format": "dateTime" }, "error_at": { "type": "string", "format": "dateTime" }, "live_at": { "type": "string", "format": "dateTime" }, "done_at": { "type": "string", "format": "dateTime" }, "title": { "type": "string" } } }, "devServerHook": { "type": "object", "properties": { "id": { "type": "string" }, "title": { "type": "string" }, "branch": { "type": "string" }, "url": { "type": "string" }, "site_id": { "type": "string" }, "created_at": { "type": "string", "format": "dateTime" }, "type": { "type": "string", "enum": [ "new_dev_server", "content_refresh" ] } } }, "devServerHookSetup": { "type": "object", "properties": { "title": { "type": "string" }, "branch": { "type": "string" }, "type": { "type": "string", "enum": [ "new_dev_server", "content_refresh" ] } } } }, "parameters": { "page": { "type": "integer", "format": "int32", "name": "page", "required": false, "in": "query" }, "perPage": { "type": "integer", "format": "int32", "name": "per_page", "required": false, "in": "query" }, "retryCount": { "name": "X-Nf-Retry-Count", "type": "integer", "in": "header" } }, "x-tagGroups": [ { "name": "OAuth", "tags": [ "ticket", "accessToken" ] }, { "name": "User accounts", "tags": [ "user", "accountMembership", "member", "accountType", "paymentMethod", "auditLog" ] }, { "name": "Site", "tags": [ "site", "environmentVariables", "file", "metadata", "purge", "snippet" ] }, { "name": "Domain names", "tags": [ "dnsZone", "sniCertificate" ] }, { "name": "Deploys", "tags": [ "deploy", "deployedBranch", "deployKey" ] }, { "name": "Builds", "tags": [ "build", "buildLogMsg" ] }, { "name": "Dev servers", "tags": [ "devServer" ] }, { "name": "Webhooks and notifications", "tags": [ "hook", "hookType", "buildHook", "devServerHook" ] }, { "name": "Services", "tags": [ "service", "serviceInstance" ] }, { "name": "Functions", "tags": [ "function" ] }, { "name": "Forms", "tags": [ "form", "submission" ] }, { "name": "Split tests", "tags": [ "splitTest" ] }, { "name": "Large media", "tags": [ "asset", "assetPublicSignature" ] } ], "tags": [ { "name": "ticket", "x-displayName": "Ticket" }, { "name": "accessToken", "x-displayName": "Access token" }, { "name": "user", "x-displayName": "User" }, { "name": "accountMembership", "x-displayName": "Accounts" }, { "name": "member", "x-displayName": "Member" }, { "name": "accountType", "x-displayName": "Access type" }, { "name": "paymentMethod", "x-displayName": "Payment method" }, { "name": "auditLog", "x-displayName": "Audit log" }, { "name": "site", "x-displayName": "Site" }, { "name": "environmentVariables", "x-displayName": "Environment variables" }, { "name": "file", "x-displayName": "File" }, { "name": "metadata", "x-displayName": "Metadata" }, { "name": "snippet", "x-displayName": "Snippet" }, { "name": "purge", "x-displayName": "Cache purge" }, { "name": "dnsZone", "x-displayName": "DNS zone" }, { "name": "sniCertificate", "x-displayName": "SNI certificate" }, { "name": "deploy", "x-displayName": "Deploy" }, { "name": "deployedBranch", "x-displayName": "Deployed branch" }, { "name": "deployKey", "x-displayName": "Deploy key" }, { "name": "build", "x-displayName": "Build" }, { "name": "buildLogMsg", "x-displayName": "Build log message" }, { "name": "hook", "x-displayName": "Hook" }, { "name": "hookType", "x-displayName": "Hook type" }, { "name": "buildHook", "x-displayName": "Build hook" }, { "name": "service", "x-displayName": "Service" }, { "name": "serviceInstance", "x-displayName": "Service instance" }, { "name": "function", "x-displayName": "Function" }, { "name": "form", "x-displayName": "Form" }, { "name": "submission", "x-displayName": "Form submission" }, { "name": "splitTest", "x-displayName": "Split test" }, { "name": "asset", "x-displayName": "Asset" }, { "name": "assetPublicSignature", "x-displayName": "Asset public signature" }, { "name": "devServer", "x-displayName": "Dev server" }, { "name": "devServerHook", "x-displayName": "Dev server hook" } ] }