Netlify Connect /Manage data layers /

Manage data layers in Netlify Connect

This product is available on Connect Enterprise plans.

Once you create and configure a data layer, you can review and modify the data layer on the settings page in the Netlify UI.

Want to create another data layer?

To create a brand new data layer, navigate to the

Connect

page for your team and select Add new data layer. For more information on the flow to add and configure a new data layer, refer to our get started with Netlify Connect doc.

# Access data layer settings

To review or modify a data layer and its connected data sources, sites, or webhooks, navigate to the settings page for the data layer:

Navigate to the
Connect
page for your team in the Netlify UI.
Select the data layer from the Data layers list.
Select Data layer settings.

# Update data layer information

Team Owners and Developers can update the name or description of a data layer:

Navigate to the
Connect
page for your team in the Netlify UI.
Select the data layer from the Data layers list, and then select Data layer settings.
On the data layer settings page, select
General Data layer information
.
Select Edit settings.
Enter the updated name or description.
Select Save.

Team Owners also have the ability to delete a data layer.

# Update data sources, sites and webhooks

On the data layer settings page, you can add and manage the following:

# Manage API authentication tokens

You must authenticate all requests to your data layer’s GraphQL API using a token.

Team Owners and Developers can generate multiple authentication tokens for each data layer, as needed.

# Generate an authentication token

To generate an authentication token for your data layer:

Navigate to the
Connect
page for your team in the Netlify UI.
Select the data layer from the Data layers list, and then select Data layer settings.
On the data layer settings page, select API tokens.
Select Add an API token.
Enter a name for the token and then select Generate token. Netlify will generate a token for you.
Select the clipboard icon to copy your token and then store it in a safe place. To protect your data, you won’t be able to reveal this token again.

Make sure to include the authentication token in the authorization header for all API requests: Authorization: Bearer <YOUR_AUTH_TOKEN>

Keep your authentication token secure

To keep your authentication token secure, we recommend that you store it in an environment variable on Netlify instead of in your repository. You can also avoid revealing the token in the browser by using a Netlify Function or Edge Function to access the variable and query the GraphQL API during runtime.

# Revoke authentication tokens

You can revoke individual tokens for your data layer in the Netlify UI.

Once you revoke an authentication token, any client applications or scripts that use that token will no longer be able to access the data layer’s GraphQL API.

This action cannot be reversed.

To revoke an authentication token:

Navigate to the
Connect
page for your team in the Netlify UI.
Select the data layer from the Data layers list, and then select Data layer settings.
On the data layer settings page, select API tokens.
Find the token you want to revoke and select Revoke.
A confirmation prompt will appear. Review the details and then select Revoke to confirm.

# Manage data revisions

Every successful sync to your data layer generates a new data revision that represents the GraphQL schema and data at that point in time. You can query against the data revision using the revision’s GraphQL sandbox or its unique API URL. You can also pin a specific data revision and your data layer’s API will always use that revision.

Learn more about data revisions.

Which data revision is the data layer’s GraphQL API using?

At the top of the data layer’s overview page, you will find information about the data revision that your data layer’s GraphQL API is currently using — including the data revision ID and whether or not the API is using a pinned revision.

# Delete a data layer

When you delete a data layer, everything connected to it is deleted — the GraphQL API and all data, data sources, site connections, and webhooks. Note that if you have submitted a support request related to the data layer, it will be difficult for us to help if you delete it.

When you delete a data layer, the GraphQL API will be deleted also

When you delete a data layer, the GraphQL API and all data revisions for that data layer will no longer be available. Remember to remove or adjust any code that uses the data layer’s GraphQL API to avoid any errors.

As this action cannot be reversed, only Team Owners can delete a data layer.

To delete a data layer:

Navigate to the
Connect
page for your team in the Netlify UI.
Select the data layer from the Data layers list, and then select Data layer settings.
On the data layer settings page, select Danger zone.
Select Delete this data layer.
A confirmation prompt will appear. Review the details and then enter the name of the data layer you want to delete.
Select Delete.