Configuring API Access | Airbyte Documentation (original) (raw)

AvailableCloud AvailableSelf-Managed Community (OSS)AvailableSelf-Managed Enterprise

The Airbyte API enables you to programmatically interact with Airbyte: create sources, destinations, run syncs, list workspaces, and much more.

Access to the API is controlled through application keys. Applications keys are tied to individual users and their respective permissions.

Prerequisites

• Cloud
• Self-Managed

Access to a Cloud workspace.

Step 1: Create an Application​

While logged into the Airbyte UI, go to Settings -> Account -> Applications. Click the button "Create an application".

Name your application for easy identification.

A client_id and client_secret will be automatically generated. The client_secret can be exposed by clicking on the icon next to the secret.

Step 2: Obtain an Access Token​

Once the client_secret is exposed, you can use the button in the UI to get an access token to do a quick test.

You can also use the client_id and client_secret to retrive an access token using the Get an Access Token endpoint.

• Cloud
• Self-Managed

POST https://api.airbyte.com/api/v1/applications/token

Ensure the following JSON Body is attached to the request, populated with your client_id and client_secret:

{ 
  "client_id": "", 
  "client_secret": "" 
  }

The API response should provide an access_token, which is a Bearer Token valid for 3 minutes. It can be used to make requests to the API. Once your access_token expires, you must make a new request to the applications/token endpoint to get a new token.

tip

Access tokens are short-lived (3 minutes) so we recommend fetching a new token before each request. The Terraform Provider/SDKs properly handle this for you if you initialize the Provider/SDK with the Client Credentials grant type using your Application's client_id and client_secret.

Step 3: Operate Airbyte via API​

You may now make requests to any endpoint documented in our Airbyte API Reference. For example, you may use the List workspaces endpoint to verify the list of workspaces in your organization. Ensure to include your access_token as a Bearer Token in your request.:

GET <YOUR_WEBAPP_URL>/api/public/v1/workspaces

Expect a response like the following:

{
  "data": [
    {
      "workspaceId": "b5367aab-9d68-4fea-800f-0000000000",
      "name": "Finance Team",
      "dataResidency": "auto"
    },
    {
      "workspaceId": "b5367aab-9d68-4fea-800f-0000000001",
      "name": "Analytics Team",
      "dataResidency": "auto"
    }
  ]
}

To go further, you may use our Python and Java SDKs to make API requests directly in code, or our Terraform Provider (which uses the Airbyte API) to declare your Airbyte configuration as infrastructure.