Before you begin

To follow these steps, you must have at least Modeler access.

How to

Find your hub

Every API endpoint requires a {hub} parameter which corresponds to your region. You can find your region by logging into vena.io and viewing the region listed in the URL. Once you have your region, it is used in place of the {hub} parameter found in an endpoint’s base URL.

E.g., If your region is us2, then you would insert it as a {hub} parameter into a URL as shown below:

  • URL: https://{hub}.vena.io/api/public/v1/
  • URL with region inserted into {hub} parameter: https://us2.vena.io/api/public/v1/

Find the template ID

Import API requests require specifying which Vena ETL template you will use for loading data. You can find the template ID by following the steps below.

  1. Log in to vena.io.

  2. Navigate to the Modeler tab.

  3. Select your data model.

  4. Select ETL from the sidebar tab.

  5. Select the vertical ellipsis next to your preferred template in the Actions column.

    vertical ellipsis


  1. Select View/Edit Details.

    screenshot of ETL tab showing View/Edit details button
  2. The template ID is beneath the template name, as shown below.

    screenshot of ETL tab modal showing template ID

Find the model ID

Export API requests require specifying which Vena model you will retrieve data from. You can find the model ID by following the steps below.

  1. Log in to vena.io.

  2. Navigate to the Modeler tab.

  3. Select your data model.

  4. The model ID appears in the URL as shown below.

    screenshot of modeler tab showing model ID in url

    Switching data models will change this number to a new model ID.