Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.sidecardata.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Requirements

Sidecar requires a dbt Cloud service account token to access the dbt Cloud API. This token must have permission to access the Administrative API, the Discovery API, and the ability to create and execute jobs. You must be on a Team or Enterprise plan, and your projects must be on version 1.0 or later.

​
1. Create a service account token

  1. Navigate to Account settings in dbt Cloud.
  2. Navigate to API tokens > Service tokens.
  3. Click + Create service token.
  4. Give the service token a name like sidecar-data.
  5. Click + Add permission.
  1. Job Admin — to create and execute jobs
  2. Member — to access the Discovery API and Administrative API
  3. Billing Admin — to monitor costs
  1. Click Save to create the service token.
  2. Copy the service token value and save it in a safe place.

​
2. Connect dbt Cloud to Sidecar

  1. In the Onboarding page (or Settings), navigate to the Connect your dbt Cloud section.
  2. Enter your Account ID. This can be found in dbt Cloud under Account Settings > Account > Account ID.
  3. Paste the API Token you created in Step 1.
  4. dbt Cloud has standard and non-standard API URLs. Check which type you have by navigating to Account Settings > Account in dbt Cloud:
    • If you see a section called Access URLs, you have non-standard URLs.
    • If you do not, you have standard URLs.
  5. If you have non-standard URLs, enter the values for Access URL, Semantic Layer GraphQL API URL, and Discovery API URL. Otherwise, skip this step.
  6. Click Test then Save.
For customers with single-tenant instances of dbt Cloud, the API URLs follow this pattern:
  • Access URL: Your vanity URL for this account
  • Discovery API URL: https://metadata.YOUR_ACCESS_URL/graphql
  • Semantic Layer GraphQL API URL: https://semantic-layer.ABC123.getdbt.com/api/graphql