> ## Documentation Index
> Fetch the complete documentation index at: https://docs.atako.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Netlify

> Connect Netlify to your Atako agents — 10 read and 6 write actions.

Let your agents manage Netlify sites, deploys, forms, environment variables, DNS zones, build hooks and accounts.

## Connection

* **Authentication**: API key (Personal access token).

<Note>
  Sign in at app.netlify.com → User settings → Applications → Personal access tokens → New access token. Give it a name, copy the token (starts with nfp\_).

  See [Netlify's documentation](https://docs.netlify.com/api/get-started/).
</Note>

## Read actions (10)

| Action                  | Description                                                                                                                    |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| `get_current_user`      | Get the authenticated user profile. Probe action — no arguments required.                                                      |
| `get_deploy`            | Retrieve a single deploy by ID.                                                                                                |
| `get_site`              | Retrieve a single site by ID or name.                                                                                          |
| `list_accounts`         | List accounts the authenticated user belongs to.                                                                               |
| `list_build_hooks`      | List build hooks for a site.                                                                                                   |
| `list_dns_zones`        | List DNS zones for the account.                                                                                                |
| `list_form_submissions` | List submissions for a form. Pagination: page (integer, 1-based) and per\_page (integer, default 100).                         |
| `list_site_deploys`     | List deploys for a site. Optionally filter by state. Pagination: page (integer, 1-based) and per\_page (integer, default 100). |
| `list_site_forms`       | List forms for a site.                                                                                                         |
| `list_sites`            | List sites. Optionally filter by name and ownership. Pagination: page (integer, 1-based) and per\_page (integer, default 100). |

## Write actions (6)

| Action              | Description                                                                                                                                                                                             |
| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `create_build_hook` | Create a build hook for a site. Arguments: site\_id (string, path) — the site; title (string, body) — hook name; branch (string, optional, body) — branch to build (defaults to the production branch). |
| `lock_deploy`       | Lock a deploy to prevent it from being published over. Arguments: deploy\_id (string, path) — the deploy to lock.                                                                                       |
| `restore_deploy`    | Restore a previous deploy, making it the current published deploy. Arguments: site\_id (string, path) — the site; deploy\_id (string, path) — the deploy to restore.                                    |
| `trigger_build`     | Trigger a new build for a site. Arguments: site\_id (string, path) — the site to build; clear\_cache (boolean, optional, body) — clear the build cache before building.                                 |
| `unlock_deploy`     | Unlock a previously locked deploy. Arguments: deploy\_id (string, path) — the deploy to unlock.                                                                                                         |
| `update_site`       | Update a site's settings. Arguments: site\_id (string, path) — the site; name (string, optional, body) — new site name; custom\_domain (string, optional, body) — custom domain.                        |

## Permissions

Every action above must be explicitly granted to an agent before it can be used. See [Permissions](/integrations/permissions) for the grant model and [Security](/integrations/security) for how credentials are protected.