How Do I Back up a Connector’s Schema?

Question

How do I backup my connector's schema before I edit it?

Environment

REST API - Applicable to all non-Magic Folder connectors.

Answer

Use our REST API to back up the connector's schema.

NOTE: The Fivetran REST API is only available for Standard, Free, Enterprise, and Business Critical accounts.

Get API key and API secret

1. Log in to your Fivetran dashboard.
2. In the bottom left menu, click your username and then select API Key.
3. Click Generate API key.
4. Copy the API Key and API Secret.

NOTE: You must be an Account Administrator on a Trial, Free, Standard, Enterprise, or Business Critical plan to access this information. If you are not an Account Administrator, ask someone who is an active Account Administrator to update your role by visiting Account Settings > Users & Permissions.

Encode API key and secret to Base64 format

1. Execute the following command in your terminal window. Replace the <API key> and <API secret> values with your API key and secret: echo -n '<API key>:<API secret>' | openssl base64.
2. Note the output. You must use the output as the Basic <output string> in Step 3.

Execute API request

1. Execute the following request in the application of your choice, such as curl or Postman: GET api.fivetran.com/v1/connectors/{connector_id}/schemas. Use the Basic <output string> you found in Step 2.
2. Save the response in JSON format.

Reference documents

For more information about API connector configurations, read the following documents:

• Retrieve a Connector Schema Config
• Use Case: Create a new connector based on an existing connector's parameters