Developer tools
Netlify in your product and your AI agents, through one API
The Netlify toolkit covers sites, deploys (list, read, build, cancel and restore) and the forms and submissions Netlify collects. Your customer connects Netlify once with an API key, and your product or AI agent calls each operation through Connect, which stores the credentials and logs every execution.
15 days to try it. No credit card.
POST https://connect.reportei.com/api/tools/netlify_create_site_build/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"site_id": "<site_id>"
}
}How it works
From a connected customer to the first Netlify call.
- 1
Your customer connects the account
Your system opens a Connect session for the toolkit and your customer connects their Netlify account. You get the connection id.
- 2
Your product calls the tool
A POST to /api/tools/{tool}/execute with the connection id and arguments. On success, Connect preserves the app's response status and body.
- 3
Connect handles the rest
It stores the credential encrypted, renews tokens for OAuth connections that support renewal and records executions in an audit trail available through the API.
Use cases
What your product does with Netlify.
Deploy button in your CMS
Call Create site build when content is published and follow the deploy with Get deploy until its state is ready or error.
One-call rollback
Restore an earlier deploy to make it the live version of the site when a release goes wrong.
Forms into your inbox or CRM
Read the submissions of a site's forms and pass them to your product, then delete spam submissions.
Tools
11 Netlify tools
- List sitesGETLists the sites (projects, in the Netlify UI) the account can reach, with id, name, url, custom_domain, the published deploy and build settings. The id or the domain of a site is the site_id that the other tools take. Paginate with page and per_page: a page with fewer items than per_page is the last one.
- Update sitePATCHChanges the name or the domains of a site and returns it. Only the fields sent change. The DNS of a new custom domain still has to point to Netlify.
- List site deploysGETLists the deploys of a site, newest first, with id, state, branch, context, error_message and the deploy URL. Paginate with page and per_page: a page with fewer items than per_page is the last one.
- Get deployGETReturns a deploy, with state (ready when it is live or ready to publish, error when the build failed), error_message, branch, commit_ref, published_at and the deploy URL.
- Create site buildPOSTStarts a build of a site from its connected repository and returns the build, with deploy_id to follow in Get deploy. Without branch it builds production; another branch makes a branch deploy. It waits in line when the team has no free build capacity.
- Cancel deployPOSTStops a deploy that is still queued or building, and returns it.
- Restore site deployPOSTPublishes an earlier deploy again and makes it the live version of the site, which is how a rollback works. Returns the deploy.
- List site formsGETLists the forms Netlify detected in a site, with id, name, fields and submission_count. The submissions themselves come from List form submissions.
- List site submissionsGETLists the submissions of every form of a site, newest first, with name, email, the data of each field and created_at. Paginate with page and per_page: a page with fewer items than per_page is the last one.
- List form submissionsGETLists the submissions of one form, newest first, with name, email, the data of each field and created_at. Paginate with page and per_page: a page with fewer items than per_page is the last one.
API key
Your customer pastes the app's key on a Connect screen, or your system sends the key with POST /api/customer-toolkits, with no screen.
Questions about the Netlify toolkit
Do I need to build against the Netlify API?
No. Connect ships 11 Netlify tools, described and ready. Your customer connects the account and your system calls every tool through the same endpoint, with the same request format.
How does my customer connect their Netlify account?
With the mode the toolkit accepts: API key. Connect stores the credential encrypted and never returns it to your system.
Does it work with AI agents?
Yes. Each tool's input is described in JSON Schema, which your agent uses directly as a tool definition. The agent picks the tool and the arguments, and your system makes the call to Connect.
Does my customer need a Reportei account?
No. Your customer connects the account on a Connect screen, or your system sends the credential through the API, and they keep using only your product.
Toolkits in the same category
See all 100 toolkitsSee Connect applied to your product.
Try it for 15 days with no card, or walk our team through your use case.
