Write API
With the Write API you can create, delete, and update content in Builder. This can be useful if you want to programmatically from your own internal application, or as part of a code release and build process.
This API is separate from the Admin API, which is meant to be used for administering Builder Spaces and create, read, update, and delete models.
Getting Started
First, you'll need to create a private key. Go over to your organization settings page (be sure to have Developer or Admin permissions) and create a private key and copy it. Note: Be careful with this key and keep it secret! It allows anyone to have write access to your content in Builder. Only use it in API calls from your server, not any calls from public client applications.
Usage
POST
To create new entries in Builder, send a POST request like below
PATCH
To update entries in Builder, send a PATCH request like below.
Properties of the request body will merge with the current document, so you do not need to supply the entire document contents, only what you have changed.
PUT
To replace entries in Builder, send a PUT request like below
DELETE
To delete entries in Builder, send a DELETE request like below
Need Expert help?
Reach out to us, and we will match you with a Builder expert.