@netlify/open-api
Version:
Netlify's open-api definition as a module
1,346 lines (1,344 loc) • 138 kB
TypeScript
/**
* This file was auto-generated by openapi-typescript.
* Do not make direct changes to the file.
*/
export interface paths {
"/sites": {
/**
* API Reference: {@link https://open-api.netlify.com/#tag/site/operation/listSites | `listSites`}
*
* **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.
*/
get: operations["listSites"];
/**
* API Reference: {@link https://open-api.netlify.com/#tag/site/operation/createSite | `createSite`}
*
* **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.
*/
post: operations["createSite"];
};
"/sites/{site_id}": {
/**
* API Reference: {@link https://open-api.netlify.com/#tag/site/operation/getSite | `getSite`}
*
* **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.
*/
get: operations["getSite"];
/** API Reference: {@link https://open-api.netlify.com/#tag/site/operation/deleteSite | `deleteSite`} */
delete: operations["deleteSite"];
/**
* API Reference: {@link https://open-api.netlify.com/#tag/site/operation/updateSite | `updateSite`}
*
* **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.
*/
patch: operations["updateSite"];
parameters: {
path: {
site_id: string;
};
};
};
"/sites/{site_id}/ssl": {
/** API Reference: {@link https://open-api.netlify.com/#tag/sniCertificate/operation/showSiteTLSCertificate | `showSiteTLSCertificate`} */
get: operations["showSiteTLSCertificate"];
/**
* API Reference: {@link https://open-api.netlify.com/#tag/sniCertificate/operation/provisionSiteTLSCertificate | `provisionSiteTLSCertificate`}
*
* Provisions or updates a TLS certificate for the site.
*
* **Creating a certificate (site has no certificate):**
* - Omit certificate params to initiate Let's Encrypt provisioning
* - Provide certificate, key, and ca_certificates to upload a custom certificate
*
* **Updating a certificate (site already has a certificate):**
* - REQUIRES certificate, key, and ca_certificates to replace with a new custom certificate
* - Use POST /api/v1/sites/{site_id}/ssl/renew to renew an existing Let's Encrypt certificate
*/
post: operations["provisionSiteTLSCertificate"];
};
"/sites/{site_id}/ssl/certificates": {
/** API Reference: {@link https://open-api.netlify.com/#tag/sniCertificate/operation/getAllCertificates | `getAllCertificates`} */
get: operations["getAllCertificates"];
};
"/accounts/{account_id}/env": {
/**
* API Reference: {@link https://open-api.netlify.com/#tag/environmentVariables/operation/getEnvVars | `getEnvVars`}
*
* Returns all environment variables for an account or site. An account corresponds to a team in the Netlify UI.
*/
get: operations["getEnvVars"];
/**
* API Reference: {@link https://open-api.netlify.com/#tag/environmentVariables/operation/createEnvVars | `createEnvVars`}
*
* Creates new environment variables. Granular scopes are available on Pro plans and above.
*/
post: operations["createEnvVars"];
};
"/api/v1/sites/{site_id}/env": {
/**
* API Reference: {@link https://open-api.netlify.com/#tag/environmentVariables/operation/getSiteEnvVars | `getSiteEnvVars`}
*
* Returns all environment variables for a site. This convenience method behaves the same as `getEnvVars` but doesn't require an `account_id` as input.
*/
get: operations["getSiteEnvVars"];
};
"/accounts/{account_id}/env/{key}": {
/**
* API Reference: {@link https://open-api.netlify.com/#tag/environmentVariables/operation/getEnvVar | `getEnvVar`}
*
* Returns an individual environment variable.
*/
get: operations["getEnvVar"];
/**
* API Reference: {@link https://open-api.netlify.com/#tag/environmentVariables/operation/updateEnvVar | `updateEnvVar`}
*
* Updates an existing environment variable and all of its values. Existing values will be replaced by values provided.
*/
put: operations["updateEnvVar"];
/**
* API Reference: {@link https://open-api.netlify.com/#tag/environmentVariables/operation/deleteEnvVar | `deleteEnvVar`}
*
* Deletes an environment variable
*/
delete: operations["deleteEnvVar"];
/**
* API Reference: {@link https://open-api.netlify.com/#tag/environmentVariables/operation/setEnvVarValue | `setEnvVarValue`}
*
* Updates or creates a new value for an existing environment variable.
*/
patch: operations["setEnvVarValue"];
};
"/accounts/{account_id}/env/{key}/value/{id}": {
/**
* API Reference: {@link https://open-api.netlify.com/#tag/environmentVariables/operation/deleteEnvVarValue | `deleteEnvVarValue`}
*
* Deletes a specific environment variable value.
*/
delete: operations["deleteEnvVarValue"];
};
"/sites/{site_id}/functions": {
/** API Reference: {@link https://open-api.netlify.com/#tag/function/operation/searchSiteFunctions | `searchSiteFunctions`} */
get: operations["searchSiteFunctions"];
};
"/sites/{site_id}/forms": {
/** API Reference: {@link https://open-api.netlify.com/#tag/form/operation/listSiteForms | `listSiteForms`} */
get: operations["listSiteForms"];
};
"/sites/{site_id}/forms/{form_id}": {
/** API Reference: {@link https://open-api.netlify.com/#tag/form/operation/deleteSiteForm | `deleteSiteForm`} */
delete: operations["deleteSiteForm"];
};
"/sites/{site_id}/submissions": {
/** API Reference: {@link https://open-api.netlify.com/#tag/submission/operation/listSiteSubmissions | `listSiteSubmissions`} */
get: operations["listSiteSubmissions"];
};
"/sites/{site_id}/files": {
/** API Reference: {@link https://open-api.netlify.com/#tag/file/operation/listSiteFiles | `listSiteFiles`} */
get: operations["listSiteFiles"];
};
"/sites/{site_id}/assets": {
/** API Reference: {@link https://open-api.netlify.com/#tag/asset/operation/listSiteAssets | `listSiteAssets`} */
get: operations["listSiteAssets"];
/** API Reference: {@link https://open-api.netlify.com/#tag/asset/operation/createSiteAsset | `createSiteAsset`} */
post: operations["createSiteAsset"];
parameters: {
path: {
site_id: string;
};
};
};
"/sites/{site_id}/assets/{asset_id}": {
/** API Reference: {@link https://open-api.netlify.com/#tag/asset/operation/getSiteAssetInfo | `getSiteAssetInfo`} */
get: operations["getSiteAssetInfo"];
/** API Reference: {@link https://open-api.netlify.com/#tag/asset/operation/updateSiteAsset | `updateSiteAsset`} */
put: operations["updateSiteAsset"];
/** API Reference: {@link https://open-api.netlify.com/#tag/asset/operation/deleteSiteAsset | `deleteSiteAsset`} */
delete: operations["deleteSiteAsset"];
parameters: {
path: {
site_id: string;
asset_id: string;
};
};
};
"/sites/{site_id}/assets/{asset_id}/public_signature": {
/** API Reference: {@link https://open-api.netlify.com/#tag/assetPublicSignature/operation/getSiteAssetPublicSignature | `getSiteAssetPublicSignature`} */
get: operations["getSiteAssetPublicSignature"];
parameters: {
path: {
site_id: string;
asset_id: string;
};
};
};
"/sites/{site_id}/files/{file_path}": {
/** API Reference: {@link https://open-api.netlify.com/#tag/file/operation/getSiteFileByPathName | `getSiteFileByPathName`} */
get: operations["getSiteFileByPathName"];
};
"/purge": {
/**
* API Reference: {@link https://open-api.netlify.com/#tag/purge/operation/purgeCache | `purgeCache`}
*
* Purges cached content from Netlify's CDN. Supports purging by Cache-Tag.
*/
post: operations["purgeCache"];
};
"/sites/{site_id}/snippets": {
/** API Reference: {@link https://open-api.netlify.com/#tag/snippet/operation/listSiteSnippets | `listSiteSnippets`} */
get: operations["listSiteSnippets"];
/** API Reference: {@link https://open-api.netlify.com/#tag/snippet/operation/createSiteSnippet | `createSiteSnippet`} */
post: operations["createSiteSnippet"];
parameters: {
path: {
site_id: string;
};
};
};
"/sites/{site_id}/snippets/{snippet_id}": {
/** API Reference: {@link https://open-api.netlify.com/#tag/snippet/operation/getSiteSnippet | `getSiteSnippet`} */
get: operations["getSiteSnippet"];
/** API Reference: {@link https://open-api.netlify.com/#tag/snippet/operation/updateSiteSnippet | `updateSiteSnippet`} */
put: operations["updateSiteSnippet"];
/** API Reference: {@link https://open-api.netlify.com/#tag/snippet/operation/deleteSiteSnippet | `deleteSiteSnippet`} */
delete: operations["deleteSiteSnippet"];
parameters: {
path: {
site_id: string;
snippet_id: string;
};
};
};
"/sites/{site_id}/metadata": {
/** API Reference: {@link https://open-api.netlify.com/#tag/metadata/operation/getSiteMetadata | `getSiteMetadata`} */
get: operations["getSiteMetadata"];
/** API Reference: {@link https://open-api.netlify.com/#tag/metadata/operation/updateSiteMetadata | `updateSiteMetadata`} */
put: operations["updateSiteMetadata"];
parameters: {
path: {
site_id: string;
};
};
};
"/sites/{site_id}/build_hooks": {
/** API Reference: {@link https://open-api.netlify.com/#tag/buildHook/operation/listSiteBuildHooks | `listSiteBuildHooks`} */
get: operations["listSiteBuildHooks"];
/** API Reference: {@link https://open-api.netlify.com/#tag/buildHook/operation/createSiteBuildHook | `createSiteBuildHook`} */
post: operations["createSiteBuildHook"];
parameters: {
path: {
site_id: string;
};
};
};
"/sites/{site_id}/build_hooks/{id}": {
/** API Reference: {@link https://open-api.netlify.com/#tag/buildHook/operation/getSiteBuildHook | `getSiteBuildHook`} */
get: operations["getSiteBuildHook"];
/** API Reference: {@link https://open-api.netlify.com/#tag/buildHook/operation/updateSiteBuildHook | `updateSiteBuildHook`} */
put: operations["updateSiteBuildHook"];
/** API Reference: {@link https://open-api.netlify.com/#tag/buildHook/operation/deleteSiteBuildHook | `deleteSiteBuildHook`} */
delete: operations["deleteSiteBuildHook"];
parameters: {
path: {
site_id: string;
id: string;
};
};
};
"/sites/{site_id}/deploys": {
/** API Reference: {@link https://open-api.netlify.com/#tag/deploy/operation/listSiteDeploys | `listSiteDeploys`} */
get: operations["listSiteDeploys"];
/** API Reference: {@link https://open-api.netlify.com/#tag/deploy/operation/createSiteDeploy | `createSiteDeploy`} */
post: operations["createSiteDeploy"];
parameters: {
path: {
site_id: string;
};
query: {
"deploy-previews"?: boolean;
production?: boolean;
state?:
| "new"
| "pending_review"
| "accepted"
| "rejected"
| "enqueued"
| "building"
| "uploading"
| "uploaded"
| "preparing"
| "prepared"
| "processing"
| "processed"
| "ready"
| "error"
| "retrying";
branch?: string;
"latest-published"?: boolean;
};
};
};
"/sites/{site_id}/deploys/{deploy_id}": {
/** API Reference: {@link https://open-api.netlify.com/#tag/deploy/operation/getSiteDeploy | `getSiteDeploy`} */
get: operations["getSiteDeploy"];
/** API Reference: {@link https://open-api.netlify.com/#tag/deploy/operation/updateSiteDeploy | `updateSiteDeploy`} */
put: operations["updateSiteDeploy"];
/** API Reference: {@link https://open-api.netlify.com/#tag/deploy/operation/deleteSiteDeploy | `deleteSiteDeploy`} */
delete: operations["deleteSiteDeploy"];
};
"/deploys/{deploy_id}/cancel": {
/** API Reference: {@link https://open-api.netlify.com/#tag/deploy/operation/cancelSiteDeploy | `cancelSiteDeploy`} */
post: operations["cancelSiteDeploy"];
};
"/sites/{site_id}/deploys/{deploy_id}/restore": {
/** API Reference: {@link https://open-api.netlify.com/#tag/deploy/operation/restoreSiteDeploy | `restoreSiteDeploy`} */
post: operations["restoreSiteDeploy"];
};
"/sites/{site_id}/builds": {
/** API Reference: {@link https://open-api.netlify.com/#tag/build/operation/listSiteBuilds | `listSiteBuilds`} */
get: operations["listSiteBuilds"];
/**
* API Reference: {@link https://open-api.netlify.com/#tag/build/operation/createSiteBuild | `createSiteBuild`}
*
* Runs a build for a site. The build will be scheduled to run at the first opportunity, but it might not start immediately if insufficient account build capacity is available. Files for build could be also uploaded as a zipped site.
*/
post: operations["createSiteBuild"];
parameters: {
path: {
site_id: string;
};
};
};
"/sites/{site_id}/deployed-branches": {
/** API Reference: {@link https://open-api.netlify.com/#tag/deployedBranch/operation/listSiteDeployedBranches | `listSiteDeployedBranches`} */
get: operations["listSiteDeployedBranches"];
parameters: {
path: {
site_id: string;
};
};
};
"/sites/{site_id}/unlink_repo": {
/**
* API Reference: {@link https://open-api.netlify.com/#tag/site/operation/unlinkSiteRepo | `unlinkSiteRepo`}
*
* [Beta] Unlinks the repo from the site.
*
* This action will also:
* - Delete associated deploy keys
* - Delete outgoing webhooks for the repo
* - Delete the site's build hooks
*/
put: operations["unlinkSiteRepo"];
parameters: {
path: {
site_id: string;
};
};
};
"/builds/{build_id}": {
/** API Reference: {@link https://open-api.netlify.com/#tag/build/operation/getSiteBuild | `getSiteBuild`} */
get: operations["getSiteBuild"];
parameters: {
path: {
build_id: string;
};
};
};
"/builds/{build_id}/log": {
/** API Reference: {@link https://open-api.netlify.com/#tag/buildLogMsg/operation/updateSiteBuildLog | `updateSiteBuildLog`} */
post: operations["updateSiteBuildLog"];
parameters: {
path: {
build_id: string;
};
};
};
"/builds/{build_id}/start": {
/** API Reference: {@link https://open-api.netlify.com/#tag/build/operation/notifyBuildStart | `notifyBuildStart`} */
post: operations["notifyBuildStart"];
parameters: {
path: {
build_id: string;
};
query: {
buildbot_version?: string;
build_version?: string;
task_id?: string;
};
};
};
"/{account_id}/builds/status": {
/** API Reference: {@link https://open-api.netlify.com/#tag/build/operation/getAccountBuildStatus | `getAccountBuildStatus`} */
get: operations["getAccountBuildStatus"];
parameters: {
path: {
account_id: string;
};
};
};
"/sites/{site_id}/dns": {
/** API Reference: {@link https://open-api.netlify.com/#tag/dnsZone/operation/getDNSForSite | `getDNSForSite`} */
get: operations["getDNSForSite"];
/** API Reference: {@link https://open-api.netlify.com/#tag/dnsZone/operation/configureDNSForSite | `configureDNSForSite`} */
put: operations["configureDNSForSite"];
parameters: {
path: {
site_id: string;
};
};
};
"/sites/{site_id}/rollback": {
/** API Reference: {@link https://open-api.netlify.com/#tag/deploy/operation/rollbackSiteDeploy | `rollbackSiteDeploy`} */
put: operations["rollbackSiteDeploy"];
parameters: {
path: {
site_id: string;
};
};
};
"/deploys/{deploy_id}": {
/** API Reference: {@link https://open-api.netlify.com/#tag/deploy/operation/getDeploy | `getDeploy`} */
get: operations["getDeploy"];
/** API Reference: {@link https://open-api.netlify.com/#tag/deploy/operation/deleteDeploy | `deleteDeploy`} */
delete: operations["deleteDeploy"];
};
"/deploys/{deploy_id}/lock": {
/** API Reference: {@link https://open-api.netlify.com/#tag/deploy/operation/lockDeploy | `lockDeploy`} */
post: operations["lockDeploy"];
};
"/deploys/{deploy_id}/unlock": {
/** API Reference: {@link https://open-api.netlify.com/#tag/deploy/operation/unlockDeploy | `unlockDeploy`} */
post: operations["unlockDeploy"];
};
"/deploys/{deploy_id}/files/{path}": {
/** API Reference: {@link https://open-api.netlify.com/#tag/file/operation/uploadDeployFile | `uploadDeployFile`} */
put: operations["uploadDeployFile"];
};
"/deploys/{deploy_id}/functions/{name}": {
/** API Reference: {@link https://open-api.netlify.com/#tag/function/operation/uploadDeployFunction | `uploadDeployFunction`} */
put: operations["uploadDeployFunction"];
};
"/forms/{form_id}/submissions": {
/** API Reference: {@link https://open-api.netlify.com/#tag/submission/operation/listFormSubmissions | `listFormSubmissions`} */
get: operations["listFormSubmissions"];
};
"/hooks": {
/** API Reference: {@link https://open-api.netlify.com/#tag/hook/operation/listHooksBySiteId | `listHooksBySiteId`} */
get: operations["listHooksBySiteId"];
/** API Reference: {@link https://open-api.netlify.com/#tag/hook/operation/createHookBySiteId | `createHookBySiteId`} */
post: operations["createHookBySiteId"];
};
"/hooks/{hook_id}": {
/** API Reference: {@link https://open-api.netlify.com/#tag/hook/operation/getHook | `getHook`} */
get: operations["getHook"];
/** API Reference: {@link https://open-api.netlify.com/#tag/hook/operation/updateHook | `updateHook`} */
put: operations["updateHook"];
/** API Reference: {@link https://open-api.netlify.com/#tag/hook/operation/deleteHook | `deleteHook`} */
delete: operations["deleteHook"];
parameters: {
path: {
hook_id: string;
};
};
};
"/hooks/{hook_id}/enable": {
/** API Reference: {@link https://open-api.netlify.com/#tag/hook/operation/enableHook | `enableHook`} */
post: operations["enableHook"];
parameters: {
path: {
hook_id: string;
};
};
};
"/hooks/types": {
/** API Reference: {@link https://open-api.netlify.com/#tag/hookType/operation/listHookTypes | `listHookTypes`} */
get: operations["listHookTypes"];
};
"/oauth/tickets": {
/** API Reference: {@link https://open-api.netlify.com/#tag/ticket/operation/createTicket | `createTicket`} */
post: operations["createTicket"];
};
"/oauth/tickets/{ticket_id}": {
/** API Reference: {@link https://open-api.netlify.com/#tag/ticket/operation/showTicket | `showTicket`} */
get: operations["showTicket"];
};
"/oauth/tickets/{ticket_id}/exchange": {
/** API Reference: {@link https://open-api.netlify.com/#tag/accessToken/operation/exchangeTicket | `exchangeTicket`} */
post: operations["exchangeTicket"];
};
"/deploy_keys": {
/** API Reference: {@link https://open-api.netlify.com/#tag/deployKey/operation/listDeployKeys | `listDeployKeys`} */
get: operations["listDeployKeys"];
/** API Reference: {@link https://open-api.netlify.com/#tag/deployKey/operation/createDeployKey | `createDeployKey`} */
post: operations["createDeployKey"];
};
"/deploy_keys/{key_id}": {
/** API Reference: {@link https://open-api.netlify.com/#tag/deployKey/operation/getDeployKey | `getDeployKey`} */
get: operations["getDeployKey"];
/** API Reference: {@link https://open-api.netlify.com/#tag/deployKey/operation/deleteDeployKey | `deleteDeployKey`} */
delete: operations["deleteDeployKey"];
parameters: {
path: {
key_id: string;
};
};
};
"/{account_slug}/sites": {
/**
* API Reference: {@link https://open-api.netlify.com/#tag/site/operation/listSitesForAccount | `listSitesForAccount`}
*
* **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.
*/
get: operations["listSitesForAccount"];
/**
* API Reference: {@link https://open-api.netlify.com/#tag/site/operation/createSiteInTeam | `createSiteInTeam`}
*
* **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.
*/
post: operations["createSiteInTeam"];
};
"/{account_slug}/members": {
/** API Reference: {@link https://open-api.netlify.com/#tag/member/operation/listMembersForAccount | `listMembersForAccount`} */
get: operations["listMembersForAccount"];
/** API Reference: {@link https://open-api.netlify.com/#tag/member/operation/addMemberToAccount | `addMemberToAccount`} */
post: operations["addMemberToAccount"];
parameters: {
path: {
account_slug: string;
};
};
};
"/{account_slug}/members/{member_id}": {
/** API Reference: {@link https://open-api.netlify.com/#tag/member/operation/getAccountMember | `getAccountMember`} */
get: operations["getAccountMember"];
/** API Reference: {@link https://open-api.netlify.com/#tag/member/operation/updateAccountMember | `updateAccountMember`} */
put: operations["updateAccountMember"];
/** API Reference: {@link https://open-api.netlify.com/#tag/member/operation/removeAccountMember | `removeAccountMember`} */
delete: operations["removeAccountMember"];
parameters: {
path: {
account_slug: string;
member_id: string;
};
};
};
"/billing/payment_methods": {
/** API Reference: {@link https://open-api.netlify.com/#tag/paymentMethod/operation/listPaymentMethodsForUser | `listPaymentMethodsForUser`} */
get: operations["listPaymentMethodsForUser"];
};
"/accounts/types": {
/** API Reference: {@link https://open-api.netlify.com/#tag/accountType/operation/listAccountTypesForUser | `listAccountTypesForUser`} */
get: operations["listAccountTypesForUser"];
};
"/accounts": {
/** API Reference: {@link https://open-api.netlify.com/#tag/accountMembership/operation/listAccountsForUser | `listAccountsForUser`} */
get: operations["listAccountsForUser"];
/** API Reference: {@link https://open-api.netlify.com/#tag/accountMembership/operation/createAccount | `createAccount`} */
post: operations["createAccount"];
};
"/accounts/{account_id}": {
/** API Reference: {@link https://open-api.netlify.com/#tag/accountMembership/operation/getAccount | `getAccount`} */
get: operations["getAccount"];
/** API Reference: {@link https://open-api.netlify.com/#tag/accountMembership/operation/updateAccount | `updateAccount`} */
put: operations["updateAccount"];
/** API Reference: {@link https://open-api.netlify.com/#tag/accountMembership/operation/cancelAccount | `cancelAccount`} */
delete: operations["cancelAccount"];
parameters: {
path: {
account_id: string;
};
};
};
"/accounts/{account_id}/audit": {
/** API Reference: {@link https://open-api.netlify.com/#tag/auditLog/operation/listAccountAuditEvents | `listAccountAuditEvents`} */
get: operations["listAccountAuditEvents"];
parameters: {
path: {
account_id: string;
};
};
};
"/agent_runners": {
/** API Reference: {@link https://open-api.netlify.com/#tag/agentRunner/operation/listAgentRunners | `listAgentRunners`} */
get: operations["listAgentRunners"];
/** API Reference: {@link https://open-api.netlify.com/#tag/agentRunner/operation/createAgentRunner | `createAgentRunner`} */
post: operations["createAgentRunner"];
};
"/agent_runners/{agent_runner_id}": {
/** API Reference: {@link https://open-api.netlify.com/#tag/agentRunner/operation/getAgentRunner | `getAgentRunner`} */
get: operations["getAgentRunner"];
/** API Reference: {@link https://open-api.netlify.com/#tag/agentRunner/operation/deleteAgentRunner | `deleteAgentRunner`} */
delete: operations["deleteAgentRunner"];
/** API Reference: {@link https://open-api.netlify.com/#tag/agentRunner/operation/updateAgentRunner | `updateAgentRunner`} */
patch: operations["updateAgentRunner"];
parameters: {
path: {
agent_runner_id: string;
};
};
};
"/agent_runners/{agent_runner_id}/archive": {
/** API Reference: {@link https://open-api.netlify.com/#tag/agentRunner/operation/archiveAgentRunner | `archiveAgentRunner`} */
post: operations["archiveAgentRunner"];
parameters: {
path: {
agent_runner_id: string;
};
};
};
"/agent_runners/{agent_runner_id}/pull_request": {
parameters: {
path: {
agent_runner_id: string;
};
};
};
"/agent_runners/{agent_runner_id}/commit": {
parameters: {
path: {
agent_runner_id: string;
};
};
};
"/agent_runners/{agent_runner_id}/sessions": {
/** API Reference: {@link https://open-api.netlify.com/#tag/agentRunnerSession/operation/listAgentRunnerSessions | `listAgentRunnerSessions`} */
get: operations["listAgentRunnerSessions"];
/** API Reference: {@link https://open-api.netlify.com/#tag/agentRunnerSession/operation/createAgentRunnerSession | `createAgentRunnerSession`} */
post: operations["createAgentRunnerSession"];
parameters: {
path: {
agent_runner_id: string;
};
};
};
"/agent_runners/{agent_runner_id}/sessions/{agent_runner_session_id}": {
/** API Reference: {@link https://open-api.netlify.com/#tag/agentRunnerSession/operation/getAgentRunnerSession | `getAgentRunnerSession`} */
get: operations["getAgentRunnerSession"];
/** API Reference: {@link https://open-api.netlify.com/#tag/agentRunnerSession/operation/deleteAgentRunnerSession | `deleteAgentRunnerSession`} */
delete: operations["deleteAgentRunnerSession"];
/** API Reference: {@link https://open-api.netlify.com/#tag/agentRunnerSession/operation/updateAgentRunnerSession | `updateAgentRunnerSession`} */
patch: operations["updateAgentRunnerSession"];
parameters: {
path: {
agent_runner_id: string;
agent_runner_session_id: string;
};
};
};
"/submissions/{submission_id}": {
/** API Reference: {@link https://open-api.netlify.com/#tag/submission/operation/listFormSubmission | `listFormSubmission`} */
get: operations["listFormSubmission"];
/** API Reference: {@link https://open-api.netlify.com/#tag/submission/operation/deleteSubmission | `deleteSubmission`} */
delete: operations["deleteSubmission"];
parameters: {
path: {
submission_id: string;
};
};
};
"/sites/{site_id}/service-instances": {
/** API Reference: {@link https://open-api.netlify.com/#tag/serviceInstance/operation/listServiceInstancesForSite | `listServiceInstancesForSite`} */
get: operations["listServiceInstancesForSite"];
parameters: {
path: {
site_id: string;
};
};
};
"/sites/{site_id}/services/{addon}/instances": {
/** API Reference: {@link https://open-api.netlify.com/#tag/serviceInstance/operation/createServiceInstance | `createServiceInstance`} */
post: operations["createServiceInstance"];
parameters: {
path: {
site_id: string;
addon: string;
};
};
};
"/sites/{site_id}/services/{addon}/instances/{instance_id}": {
/** API Reference: {@link https://open-api.netlify.com/#tag/serviceInstance/operation/showServiceInstance | `showServiceInstance`} */
get: operations["showServiceInstance"];
/** API Reference: {@link https://open-api.netlify.com/#tag/serviceInstance/operation/updateServiceInstance | `updateServiceInstance`} */
put: operations["updateServiceInstance"];
/** API Reference: {@link https://open-api.netlify.com/#tag/serviceInstance/operation/deleteServiceInstance | `deleteServiceInstance`} */
delete: operations["deleteServiceInstance"];
parameters: {
path: {
site_id: string;
addon: string;
instance_id: string;
};
};
};
"/services/": {
/** API Reference: {@link https://open-api.netlify.com/#tag/service/operation/getServices | `getServices`} */
get: operations["getServices"];
parameters: {
query: {
search?: string;
};
};
};
"/services/{addonName}": {
/** API Reference: {@link https://open-api.netlify.com/#tag/service/operation/showService | `showService`} */
get: operations["showService"];
parameters: {
path: {
addonName: string;
};
};
};
"/services/{addonName}/manifest": {
/** API Reference: {@link https://open-api.netlify.com/#tag/service/operation/showServiceManifest | `showServiceManifest`} */
get: operations["showServiceManifest"];
parameters: {
path: {
addonName: string;
};
};
};
"/user": {
/** API Reference: {@link https://open-api.netlify.com/#tag/user/operation/getCurrentUser | `getCurrentUser`} */
get: operations["getCurrentUser"];
};
"/sites/{site_id}/traffic_splits": {
/** API Reference: {@link https://open-api.netlify.com/#tag/splitTest/operation/getSplitTests | `getSplitTests`} */
get: operations["getSplitTests"];
/** API Reference: {@link https://open-api.netlify.com/#tag/splitTest/operation/createSplitTest | `createSplitTest`} */
post: operations["createSplitTest"];
parameters: {
path: {
site_id: string;
};
};
};
"/sites/{site_id}/traffic_splits/{split_test_id}": {
/** API Reference: {@link https://open-api.netlify.com/#tag/splitTest/operation/getSplitTest | `getSplitTest`} */
get: operations["getSplitTest"];
/** API Reference: {@link https://open-api.netlify.com/#tag/splitTest/operation/updateSplitTest | `updateSplitTest`} */
put: operations["updateSplitTest"];
parameters: {
path: {
site_id: string;
split_test_id: string;
};
};
};
"/sites/{site_id}/traffic_splits/{split_test_id}/publish": {
/** API Reference: {@link https://open-api.netlify.com/#tag/splitTest/operation/enableSplitTest | `enableSplitTest`} */
post: operations["enableSplitTest"];
parameters: {
path: {
site_id: string;
split_test_id: string;
};
};
};
"/sites/{site_id}/traffic_splits/{split_test_id}/unpublish": {
/** API Reference: {@link https://open-api.netlify.com/#tag/splitTest/operation/disableSplitTest | `disableSplitTest`} */
post: operations["disableSplitTest"];
parameters: {
path: {
site_id: string;
split_test_id: string;
};
};
};
"/dns_zones": {
/** API Reference: {@link https://open-api.netlify.com/#tag/dnsZone/operation/getDnsZones | `getDnsZones`} */
get: operations["getDnsZones"];
/** API Reference: {@link https://open-api.netlify.com/#tag/dnsZone/operation/createDnsZone | `createDnsZone`} */
post: operations["createDnsZone"];
};
"/dns_zones/{zone_id}": {
/** API Reference: {@link https://open-api.netlify.com/#tag/dnsZone/operation/getDnsZone | `getDnsZone`} */
get: operations["getDnsZone"];
/** API Reference: {@link https://open-api.netlify.com/#tag/dnsZone/operation/deleteDnsZone | `deleteDnsZone`} */
delete: operations["deleteDnsZone"];
parameters: {
path: {
zone_id: string;
};
};
};
"/dns_zones/{zone_id}/transfer": {
/** API Reference: {@link https://open-api.netlify.com/#tag/dnsZone/operation/transferDnsZone | `transferDnsZone`} */
put: operations["transferDnsZone"];
parameters: {
path: {
zone_id: string;
};
query: {
/** the account of the dns zone */
account_id: string;
/** the account you want to transfer the dns zone to */
transfer_account_id: string;
/** the user you want to transfer the dns zone to */
transfer_user_id: string;
};
};
};
"/dns_zones/{zone_id}/dns_records": {
/** API Reference: {@link https://open-api.netlify.com/#tag/dnsZone/operation/getDnsRecords | `getDnsRecords`} */
get: operations["getDnsRecords"];
/** API Reference: {@link https://open-api.netlify.com/#tag/dnsZone/operation/createDnsRecord | `createDnsRecord`} */
post: operations["createDnsRecord"];
parameters: {
path: {
zone_id: string;
};
};
};
"/dns_zones/{zone_id}/dns_records/{dns_record_id}": {
/** API Reference: {@link https://open-api.netlify.com/#tag/dnsZone/operation/getIndividualDnsRecord | `getIndividualDnsRecord`} */
get: operations["getIndividualDnsRecord"];
/** API Reference: {@link https://open-api.netlify.com/#tag/dnsZone/operation/deleteDnsRecord | `deleteDnsRecord`} */
delete: operations["deleteDnsRecord"];
parameters: {
path: {
zone_id: string;
dns_record_id: string;
};
};
};
"/sites/{site_id}/dev_servers": {
/** API Reference: {@link https://open-api.netlify.com/#tag/devServer/operation/listSiteDevServers | `listSiteDevServers`} */
get: operations["listSiteDevServers"];
/** API Reference: {@link https://open-api.netlify.com/#tag/devServer/operation/createSiteDevServer | `createSiteDevServer`} */
post: operations["createSiteDevServer"];
/** API Reference: {@link https://open-api.netlify.com/#tag/devServer/operation/deleteSiteDevServers | `deleteSiteDevServers`} */
delete: operations["deleteSiteDevServers"];
parameters: {
path: {
site_id: string;
};
};
};
"/sites/{site_id}/dev_servers/{dev_server_id}": {
/** API Reference: {@link https://open-api.netlify.com/#tag/devServer/operation/getSiteDevServer | `getSiteDevServer`} */
get: operations["getSiteDevServer"];
parameters: {
path: {
site_id: string;
dev_server_id: string;
};
};
};
"/sites/{site_id}/dev_servers/{dev_server_id}/activity": {
parameters: {
path: {
site_id: string;
dev_server_id: string;
};
};
};
"/sites/{site_id}/dev_servers/{dev_server_id}/state": {
/** API Reference: {@link https://open-api.netlify.com/#tag/devServer/operation/updateDevServerState | `updateDevServerState`} */
post: operations["updateDevServerState"];
parameters: {
path: {
site_id: string;
dev_server_id: string;
};
};
};
"/sites/{site_id}/dev_server_hooks": {
/** API Reference: {@link https://open-api.netlify.com/#tag/devServerHook/operation/listSiteDevServerHooks | `listSiteDevServerHooks`} */
get: operations["listSiteDevServerHooks"];
/** API Reference: {@link https://open-api.netlify.com/#tag/devServerHook/operation/createSiteDevServerHook | `createSiteDevServerHook`} */
post: operations["createSiteDevServerHook"];
parameters: {
path: {
site_id: string;
};
};
};
"/sites/{site_id}/dev_server_hooks/{id}": {
/** API Reference: {@link https://open-api.netlify.com/#tag/devServerHook/operation/getSiteDevServerHook | `getSiteDevServerHook`} */
get: operations["getSiteDevServerHook"];
/** API Reference: {@link https://open-api.netlify.com/#tag/devServerHook/operation/updateSiteDevServerHook | `updateSiteDevServerHook`} */
put: operations["updateSiteDevServerHook"];
/** API Reference: {@link https://open-api.netlify.com/#tag/devServerHook/operation/deleteSiteDevServerHook | `deleteSiteDevServerHook`} */
delete: operations["deleteSiteDevServerHook"];
parameters: {
path: {
site_id: string;
id: string;
};
};
};
"/ai-gateway/providers": {
/** API Reference: {@link https://open-api.netlify.com/#tag/aiGateway/operation/getAIGatewayProviders | `getAIGatewayProviders`} */
get: operations["getAIGatewayProviders"];
};
"/sites/{site_id}/ai-gateway/token": {
/**
* API Reference: {@link https://open-api.netlify.com/#tag/aiGateway/operation/getAIGatewayToken | `getAIGatewayToken`}
*
* Returns an AI Gateway token for a specific site
*/
get: operations["getAIGatewayToken"];
parameters: {
path: {
/** The site ID */
site_id: string;
};
};
};
}
export interface components {
schemas: {
DeployValidationsReport: {
/** @description The id of the deploy validations report */
id?: string;
/** @description The id of the deploy */
deploy_id?: string;
secret_scan_result?: components["schemas"]["DeployValidationsReport_SecretScanResult"];
};
DeployValidationsReport_SecretScanResult: {
/** @description The number of files scanned */
scannedFilesCount?: number;
/** @description The list of secrets scan matches */
secretsScanMatches?: string[];
};
splitTestSetup: {
branch_tests?: { [key: string]: unknown };
};
splitTests: components["schemas"]["splitTest"][];
splitTest: {
id?: string;
site_id?: string;
name?: string;
path?: string;
branches?: { [key: string]: unknown }[];
active?: boolean;
/** Format: dateTime */
created_at?: string;
/** Format: dateTime */
updated_at?: string;
/** Format: dateTime */
unpublished_at?: string;
};
serviceInstance: {
id?: string;
url?: string;
config?: { [key: string]: unknown };
external_attributes?: { [key: string]: unknown };
service_slug?: string;
service_path?: string;
service_name?: string;
env?: { [key: string]: unknown };
snippets?: { [key: string]: unknown }[];
auth_url?: string;
/** Format: dateTime */
created_at?: string;
/** Format: dateTime */
updated_at?: string;
};
service: {
id?: string;
name?: string;
slug?: string;
service_path?: string;
long_description?: string;
description?: string;
events?: { [key: string]: unknown }[];
tags?: string[];
icon?: string;
manifest_url?: string;
environments?: string[];
/** Format: dateTime */
created_at?: string;
/** Format: dateTime */
updated_at?: string;
};
site: {
id?: string;
state?: string;
plan?: string;
name?: string;
custom_domain?: string;
domain_aliases?: string[];
branch_deploy_custom_domain?: string;
deploy_preview_custom_domain?: string;
password?: string;
notification_email?: string;
url?: string;
ssl_url?: string;
admin_url?: string;
screenshot_url?: string;
/** Format: dateTime */
created_at?: string;
/** Format: dateTime */
updated_at?: string;
user_id?: string;
session_id?: string;
ssl?: boolean;
force_ssl?: boolean;
managed_dns?: boolean;
deploy_url?: string;
published_deploy?: components["schemas"]["deploy"];
account_id?: string;
account_name?: string;
account_slug?: string;
git_provider?: string;
deploy_hook?: string;
capabilities?: { [key: string]: { [key: string]: unknown } };
processing_settings?: {
html?: {
pretty_urls?: boolean;
};
};
build_settings?: components["schemas"]["repoInfo"];
id_domain?: string;
default_hooks_data?: {
access_token?: string;
};
build_image?: string;
prerender?: string;
functions_region?: string;
/** @default false */
prevent_non_git_prod_deploys?: boolean;
};
siteSetup: components["schemas"]["site"] & {
repo?: components["schemas"]["repoInfo"];
};
repoInfo: {
id?: number;
provider?: string;
deploy_key_id?: string;
repo_path?: string;
repo_branch?: string;
dir?: string;
functions_dir?: string;
cmd?: string;
allowed_branches?: string[];
public_repo?: boolean;
private_logs?: boolean;
repo_url?: string;
env?: { [key: string]: string };
installation_id?: number;
stop_builds?: boolean;
};
submission: {
id?: string;
/** Format: int32 */
number?: number;
email?: string;
name?: string;
first_name?: string;
last_name?: string;
company?: string;
summary?: string;
body?: string;
data?: { [key: string]: unknown };
/** Format: dateTime */
created_at?: string;
site_url?: string;
};
/** @description Environment variable model definition */
envVar: {
/** @description The environment variable key, like ALGOLIA_ID (case-sensitive) */
key?: string;
/** @description The scopes that this environment variable is set to */
scopes?: ("builds" | "functions" | "runtime" | "post-processing")[];
/** @description An array of Value objects containing values and metadata */
values?: components["schemas"]["envVarValue"][];
/** @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. */
is_secret?: boolean;
/**
* Format: date-time
* @description The timestamp of when the value was last updated
*/
updated_at?: string;
updated_by?: components["schemas"]["envVarUser"];
};
/** @description Environment variable value model definition */
envVarValue: {
/** @description The environment variable value's universally unique ID */
id?: string;
/** @description The environment variable's unencrypted value */
value?: string;
/**
* @description The deploy context in which this value will be used. `dev` refers to local development when running `netlify dev`.
* @enum {string}
*/
context?:
| "all"
| "dev"
| "dev-server"
| "branch-deploy"
| "deploy-preview"
| "production"
| "branch";
/** @description An additional parameter for custom branches. Currently, this is used for specifying a branch name when `context=branch`. */
context_parameter?: string;
};
envVarUser: {
/** @description The user's unique identifier */
id?: string;
/** @description The user's full name (first and last) */
full_name?: string;
/** @description The user's email address */
email?: string;
/** @description A URL pointing to the user's avatar */
avatar_url?: string;
};
form: {
id?: string;
site_id?: string;
name?: string;
paths?: string[];
/** Format: int32 */
submission_count?: number;
fields?: { [key: string]: unknown }[];
/** Format: dateTime */
created_at?: string;
};
hookType: {
name?: string;
events?: string[];
fields?: { [key: string]: unknown }[];
};
hook: {
id?: string;
site_id?: string;
type?: string;
event?: string;
data?: { [key: string]: unknown };
/** Format: dateTime */
created_at?: string;
/** Format: dateTime */
updated_at?: string;
disabled?: boolean;
};
file: {
id?: string;
path?: string;
sha?: string;
mime_type?: string;
/** Format: int64 */
size?: number;
};
function: {
id?: string;
name?: string;
sha?: string;
};
snippet: {
/** Format: int32 */
id?: number;
site_id?: string;
title?: string;
general?: string;
general_position?: string;
goal?: string;
goal_position?: string;
};
purge: {
site_id?: string;
site_slug?: string;
cache_tags?: string[];
};
deploy: {
id?: string;
site_id?: string;
user_id?: string;
build_id?: string;
state?: string;
name?: string;
url?: string;
ssl_url?: string;
admin_url?: string;
deploy_url?: string;
deploy_ssl_url?: string;
screenshot_url?: string;
review_id?: number;
draft?: boolean;
required?: string[];
required_functions?: string[];
error_message?: string;
branch?: string;
commit_ref?: string;
commit_url?: string;
skipped?: boolean;
/** Format: dateTime */
created_at?: string;
/** Format: dateTime */
updated_at?: string;
/** Format: dateTime */
published_at?: string;
title?: string;
context?: string;
locked?: boolean;
review_url?: string;
framework?: string;
skew_protection_token?: string;
function_schedules?: components["schemas"]["functionSchedule"][];
};
deployFiles: {
files?: { [key: string]: unknown };
draft?: boolean;
async?: boolean;
functions?: { [key: string]: unknown };
function_schedules?: components["schemas"]["functionSchedule"][];
functions_config?: {
[key: string]: components["schemas"]["functionConfig"];
};
branch?: string;
framework?: string;
framework_version?: string;
};
pluginParams: {
pinned_version?: string;
};
plugin: {
package?: string;
pinned_version?: string;
};
buildStatus: {
active?: number;
pending_concurrency?: number;
enqueued?: number;
build_count?: number;
minutes?: {
current?: number;
current_average_sec?: number;
previous?: number;
/** Format: dateTime */
period_start_date?: string;
/** Format: dateTime */
period_end_date?: string;
/** Format: dateTime */
last_updated_at?: string;
included_minutes?: string;
included_minutes_with_packs?: string;
};
};
build: {
id?: string;
deploy_id?: string;
sha?: string;
done?: boolean;
error?: string;
/** Format: dateTime */
created_at?: string;
};
buildLogMsg: {
message?: string;
error?: boolean;
/** @enum {string} */
section?:
| "initializing"
| "building"
| "deploying"
| "cleanup"
| "postprocessing";
};
pluginRunData: {
package?: string;
version?: string;
state?: string;
reporting_event?: string;
title?: string;
summary?: string;
text?: string;
};
pluginRun: components["schemas"]["pluginRunData"] & {
deploy_id?: string;
};
metadata: { [key: string]: unknown };
dnsZoneSetup: {
account_slug?: string;
site_id?: string;
name?: string;
};
dnsZones: components["schemas"]["dnsZone"][];
dnsZone: {
id?: string;
name?: string;
errors?: string[];
supported_record_types?: string[];
user_id?: string;
/** Format: dateTime */
created_at?: string;
/** Format: dateTime */
updated_at?: string;
records?: components["schemas"]["dnsRecord"][];
dns_servers?: string[];
account_id?: string;
site_id?: string;
account_slug?: string;
account_name?: string;
domain?: string;
ipv6_enabled?: boolean;
dedicated?: boolean;
};
dnsRecordCreate: {
type?: string;
hostname?: string;
value?: string;
/** Format: int64 */
ttl?: number;
/** Format: int64 */
priority?: number;
/** Format: int64 */
weight?: number;
/** Format: int64 */
port?: number;
/** Format: int64 */
flag?: number;
tag?: string;
};
dnsRecords: components["schemas"]["dnsRecord"][];
dnsRecord: {
id?: string;
hostname?: string;
type?: string;
value?: string;
/** Format: int64 */
ttl?: number;
/** Format: int64 */
priority?: number;
dns_zone_id?: string;
site_id?: string;
flag?: number;
tag?: string;
managed?: boolean;
};
sniCertificate: {
state?: string;
domains?: string[];
/** Format: dateTime */
created_at?: string;
/** Format: dateTime */
updated_at?: string;
/** Format: dateTime */
expires_at?: string;
};
ticket: {
id?: string;
client_id?: string;
authorized?: boolean;
/** Format: dateTime */
created_at?: string;
};
accessToken: {
id?: string;
access_token?: string;
user_id?: string;
user_email?: string;
/** Format: dateTime */
created_at?: string;
};
asset: {
id?: string;
site_id?: string;
creator_id?: string;
name?: string;
state?: string;
content_type?: string;
url?: string;
key?: string;
visibility?: string;
/