Altimate AI DBT_CLOUD API
The DBT_CLOUD API from Altimate AI — 11 operation(s) for dbt_cloud.
The DBT_CLOUD API from Altimate AI — 11 operation(s) for dbt_cloud.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/altimate-ai-dbt-cloud-api"
curl "https://apis.io/api/v1/apis?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Fast ACCOUNT_COSTS DBT CLOUD API
version: 0.1.0
servers:
- url: https://api.myaltimate.com
description: Base URL reconciled from apis.yml
tags:
- name: DBT_CLOUD
paths:
/api/v1/dbt/cloud/connections:
post:
tags:
- DBT_CLOUD
summary: Create Connection
description: 'Create a new dbt Cloud connection.
This will:
1. Validate the API token
2. Create the connection record
3. Discover all projects and environments
4. Create DBTCoreIntegration records for each project'
operationId: create_connection_api_v1_dbt_cloud_connections_post
security:
- HTTPBearer: []
- HTTPBearer: []
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/DbtCloudConnectionCreateRequest'
responses:
'201':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/DbtCloudConnectionResponse'
'400':
description: Bad request
content:
application/json:
schema:
type: object
additionalProperties: true
title: Response 400 Create Connection Api V1 Dbt Cloud Connections Post
'403':
description: Forbidden
content:
application/json:
schema:
type: object
additionalProperties: true
title: Response 403 Create Connection Api V1 Dbt Cloud Connections Post
'404':
description: Not found
content:
application/json:
schema:
type: object
additionalProperties: true
title: Response 404 Create Connection Api V1 Dbt Cloud Connections Post
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
get:
tags:
- DBT_CLOUD
summary: List Connections
description: List all dbt Cloud connections.
operationId: list_connections_api_v1_dbt_cloud_connections_get
security:
- HTTPBearer: []
- HTTPBearer: []
parameters:
- name: navigationSource
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Navigationsource
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/DbtCloudConnectionListResponse'
'400':
description: Bad request
content:
application/json:
schema:
type: object
additionalProperties: true
title: Response 400 List Connections Api V1 Dbt Cloud Connections Get
'403':
description: Forbidden
content:
application/json:
schema:
type: object
additionalProperties: true
title: Response 403 List Connections Api V1 Dbt Cloud Connections Get
'404':
description: Not found
content:
application/json:
schema:
type: object
additionalProperties: true
title: Response 404 List Connections Api V1 Dbt Cloud Connections Get
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/v1/dbt/cloud/connections/{connection_id}:
get:
tags:
- DBT_CLOUD
summary: Get Connection
description: Get a dbt Cloud connection with all projects and environments.
operationId: get_connection_api_v1_dbt_cloud_connections__connection_id__get
security:
- HTTPBearer: []
- HTTPBearer: []
parameters:
- name: connection_id
in: path
required: true
schema:
type: integer
title: Connection Id
- name: navigationSource
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Navigationsource
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/DbtCloudConnectionResponse'
'400':
description: Bad request
content:
application/json:
schema:
type: object
additionalProperties: true
title: Response 400 Get Connection Api V1 Dbt Cloud Connections Connection Id Get
'403':
description: Forbidden
content:
application/json:
schema:
type: object
additionalProperties: true
title: Response 403 Get Connection Api V1 Dbt Cloud Connections Connection Id Get
'404':
description: Not found
content:
application/json:
schema:
type: object
additionalProperties: true
title: Response 404 Get Connection Api V1 Dbt Cloud Connections Connection Id Get
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
delete:
tags:
- DBT_CLOUD
summary: Delete Connection
description: 'Delete a dbt Cloud connection.
This will permanently delete the connection and all associated records:
- dbt Cloud projects and environments
- Associated DBTCoreIntegration records
- Associated DBTCoreIntegrationEnvironment records
- Periodic sync tasks'
operationId: delete_connection_api_v1_dbt_cloud_connections__connection_id__delete
deprecated: true
security:
- HTTPBearer: []
- HTTPBearer: []
parameters:
- name: connection_id
in: path
required: true
schema:
type: integer
title: Connection Id
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/StandardResponse'
'400':
description: Bad request
content:
application/json:
schema:
type: object
additionalProperties: true
title: Response 400 Delete Connection Api V1 Dbt Cloud Connections Connection Id Delete
'403':
description: Forbidden
content:
application/json:
schema:
type: object
additionalProperties: true
title: Response 403 Delete Connection Api V1 Dbt Cloud Connections Connection Id Delete
'404':
description: Not found
content:
application/json:
schema:
type: object
additionalProperties: true
title: Response 404 Delete Connection Api V1 Dbt Cloud Connections Connection Id Delete
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
patch:
tags:
- DBT_CLOUD
summary: Update Connection
description: 'Update an existing dbt Cloud connection.
Allows updating:
- name: Connection display name
- api_token: Service token (will be validated)
- api_base_url: API base URL
If api_token is provided, it will be validated against dbt Cloud API.'
operationId: update_connection_api_v1_dbt_cloud_connections__connection_id__patch
deprecated: true
security:
- HTTPBearer: []
- HTTPBearer: []
parameters:
- name: connection_id
in: path
required: true
schema:
type: integer
title: Connection Id
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/DbtCloudConnectionUpdateRequest'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/DbtCloudConnectionResponse'
'400':
description: Bad request
content:
application/json:
schema:
type: object
additionalProperties: true
title: Response 400 Update Connection Api V1 Dbt Cloud Connections Connection Id Patch
'403':
description: Forbidden
content:
application/json:
schema:
type: object
additionalProperties: true
title: Response 403 Update Connection Api V1 Dbt Cloud Connections Connection Id Patch
'404':
description: Not found
content:
application/json:
schema:
type: object
additionalProperties: true
title: Response 404 Update Connection Api V1 Dbt Cloud Connections Connection Id Patch
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/v1/dbt/cloud/connections/{connection_id}/refresh:
post:
tags:
- DBT_CLOUD
summary: Refresh Connection
description: 'Re-discover projects and environments from dbt Cloud.
Use this to sync new projects/environments that were added in dbt Cloud.'
operationId: refresh_connection_api_v1_dbt_cloud_connections__connection_id__refresh_post
deprecated: true
security:
- HTTPBearer: []
- HTTPBearer: []
parameters:
- name: connection_id
in: path
required: true
schema:
type: integer
title: Connection Id
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/DbtCloudDiscoveryResponse'
'400':
description: Bad request
content:
application/json:
schema:
type: object
additionalProperties: true
title: Response 400 Refresh Connection Api V1 Dbt Cloud Connections Connection Id Refresh Post
'403':
description: Forbidden
content:
application/json:
schema:
type: object
additionalProperties: true
title: Response 403 Refresh Connection Api V1 Dbt Cloud Connections Connection Id Refresh Post
'404':
description: Not found
content:
application/json:
schema:
type: object
additionalProperties: true
title: Response 404 Refresh Connection Api V1 Dbt Cloud Connections Connection Id Refresh Post
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/v1/dbt/cloud/projects/{project_id}:
patch:
tags:
- DBT_CLOUD
summary: Update Project
description: Enable or disable sync for a dbt Cloud project.
operationId: update_project_api_v1_dbt_cloud_projects__project_id__patch
deprecated: true
security:
- HTTPBearer: []
- HTTPBearer: []
parameters:
- name: project_id
in: path
required: true
schema:
type: integer
title: Project Id
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/DbtCloudProjectUpdateRequest'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/DbtCloudProjectResponse'
'400':
description: Bad request
content:
application/json:
schema:
type: object
additionalProperties: true
title: Response 400 Update Project Api V1 Dbt Cloud Projects Project Id Patch
'403':
description: Forbidden
content:
application/json:
schema:
type: object
additionalProperties: true
title: Response 403 Update Project Api V1 Dbt Cloud Projects Project Id Patch
'404':
description: Not found
content:
application/json:
schema:
type: object
additionalProperties: true
title: Response 404 Update Project Api V1 Dbt Cloud Projects Project Id Patch
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/v1/dbt/cloud/environments/{environment_id}:
patch:
tags:
- DBT_CLOUD
summary: Update Environment
description: Enable or disable sync for a dbt Cloud environment.
operationId: update_environment_api_v1_dbt_cloud_environments__environment_id__patch
deprecated: true
security:
- HTTPBearer: []
- HTTPBearer: []
parameters:
- name: environment_id
in: path
required: true
schema:
type: integer
title: Environment Id
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/DbtCloudEnvironmentUpdateRequest'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/DbtCloudEnvironmentResponse'
'400':
description: Bad request
content:
application/json:
schema:
type: object
additionalProperties: true
title: Response 400 Update Environment Api V1 Dbt Cloud Environments Environment Id Patch
'403':
description: Forbidden
content:
application/json:
schema:
type: object
additionalProperties: true
title: Response 403 Update Environment Api V1 Dbt Cloud Environments Environment Id Patch
'404':
description: Not found
content:
application/json:
schema:
type: object
additionalProperties: true
title: Response 404 Update Environment Api V1 Dbt Cloud Environments Environment Id Patch
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/v1/dbt/cloud/connections/{connection_id}/sync:
post:
tags:
- DBT_CLOUD
summary: Trigger Sync
description: "Trigger a manual sync for all enabled projects/environments.\n\nThis will queue a background task to:\n1. Fetch new runs from dbt Cloud\n2. Download artifacts\n3. Upload to S3\n4. Trigger ingestion pipeline\n\nArgs:\n force: If True, resets processed runs to force re-download of all artifacts"
operationId: trigger_sync_api_v1_dbt_cloud_connections__connection_id__sync_post
security:
- HTTPBearer: []
- HTTPBearer: []
parameters:
- name: connection_id
in: path
required: true
schema:
type: integer
title: Connection Id
- name: force
in: query
required: false
schema:
type: boolean
default: false
title: Force
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/DbtCloudSyncResponse'
'400':
description: Bad request
content:
application/json:
schema:
type: object
additionalProperties: true
title: Response 400 Trigger Sync Api V1 Dbt Cloud Connections Connection Id Sync Post
'403':
description: Forbidden
content:
application/json:
schema:
type: object
additionalProperties: true
title: Response 403 Trigger Sync Api V1 Dbt Cloud Connections Connection Id Sync Post
'404':
description: Not found
content:
application/json:
schema:
type: object
additionalProperties: true
title: Response 404 Trigger Sync Api V1 Dbt Cloud Connections Connection Id Sync Post
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/v1/dbt/cloud/connections/{connection_id}/sync-history:
get:
tags:
- DBT_CLOUD
summary: Get Sync History
description: Get sync history for a connection with pagination.
operationId: get_sync_history_api_v1_dbt_cloud_connections__connection_id__sync_history_get
security:
- HTTPBearer: []
- HTTPBearer: []
parameters:
- name: connection_id
in: path
required: true
schema:
type: integer
title: Connection Id
- name: page
in: query
required: false
schema:
type: integer
default: 1
title: Page
- name: size
in: query
required: false
schema:
type: integer
default: 20
title: Size
- name: navigationSource
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Navigationsource
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/DbtCloudSyncHistoryResponse'
'400':
description: Bad request
content:
application/json:
schema:
type: object
additionalProperties: true
title: Response 400 Get Sync History Api V1 Dbt Cloud Connections Connection Id Sync History Get
'403':
description: Forbidden
content:
application/json:
schema:
type: object
additionalProperties: true
title: Response 403 Get Sync History Api V1 Dbt Cloud Connections Connection Id Sync History Get
'404':
description: Not found
content:
application/json:
schema:
type: object
additionalProperties: true
title: Response 404 Get Sync History Api V1 Dbt Cloud Connections Connection Id Sync History Get
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/v1/dbt/cloud/connections/{connection_id}/schedule:
patch:
tags:
- DBT_CLOUD
summary: Update Schedule
description: Update the sync schedule for a connection.
operationId: update_schedule_api_v1_dbt_cloud_connections__connection_id__schedule_patch
deprecated: true
security:
- HTTPBearer: []
- HTTPBearer: []
parameters:
- name: connection_id
in: path
required: true
schema:
type: integer
title: Connection Id
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/DbtCloudScheduleUpdateRequest'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/DbtCloudScheduleResponse'
'400':
description: Bad request
content:
application/json:
schema:
type: object
additionalProperties: true
title: Response 400 Update Schedule Api V1 Dbt Cloud Connections Connection Id Schedule Patch
'403':
description: Forbidden
content:
application/json:
schema:
type: object
additionalProperties: true
title: Response 403 Update Schedule Api V1 Dbt Cloud Connections Connection Id Schedule Patch
'404':
description: Not found
content:
application/json:
schema:
type: object
additionalProperties: true
title: Response 404 Update Schedule Api V1 Dbt Cloud Connections Connection Id Schedule Patch
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/v1/dbt/cloud/validate:
post:
tags:
- DBT_CLOUD
summary: Validate Token
description: 'Validate a dbt Cloud API token without creating a connection.
Use this to verify credentials before creating a connection.'
operationId: validate_token_api_v1_dbt_cloud_validate_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/DbtCloudValidateTokenRequest'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/DbtCloudValidationResponse'
'400':
description: Bad request
content:
application/json:
schema:
additionalProperties: true
type: object
title: Response 400 Validate Token Api V1 Dbt Cloud Validate Post
'403':
description: Forbidden
content:
application/json:
schema:
additionalProperties: true
type: object
title: Response 403 Validate Token Api V1 Dbt Cloud Validate Post
'404':
description: Not found
content:
application/json:
schema:
additionalProperties: true
type: object
title: Response 404 Validate Token Api V1 Dbt Cloud Validate Post
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- HTTPBearer: []
- HTTPBearer: []
/api/v1/dbt/cloud/connections/{connection_id}/test:
post:
tags:
- DBT_CLOUD
summary: Test Connection
description: 'Test an existing dbt Cloud connection using stored credentials.
Use this to verify that an existing connection''s credentials are still valid.'
operationId: test_connection_api_v1_dbt_cloud_connections__connection_id__test_post
security:
- HTTPBearer: []
- HTTPBearer: []
parameters:
- name: connection_id
in: path
required: true
schema:
type: integer
title: Connection Id
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/DbtCloudValidationResponse'
'400':
description: Bad request
content:
application/json:
schema:
type: object
additionalProperties: true
title: Response 400 Test Connection Api V1 Dbt Cloud Connections Connection Id Test Post
'403':
description: Forbidden
content:
application/json:
schema:
type: object
additionalProperties: true
title: Response 403 Test Connection Api V1 Dbt Cloud Connections Connection Id Test Post
'404':
description: Not found
content:
application/json:
schema:
type: object
additionalProperties: true
title: Response 404 Test Connection Api V1 Dbt Cloud Connections Connection Id Test Post
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/v1/dbt/cloud/trigger-ingestion:
post:
tags:
- DBT_CLOUD
summary: Trigger Dbt Ingestion
description: 'Trigger the dbt ingestion worker to process pending GlobalTasks.
This is primarily for local development and testing.
In production, this is triggered automatically by Celery beat.'
operationId: trigger_dbt_ingestion_api_v1_dbt_cloud_trigger_ingestion_post
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/StandardResponse'
'400':
description: Bad request
content:
application/json:
schema:
additionalProperties: true
type: object
title: Response 400 Trigger Dbt Ingestion Api V1 Dbt Cloud Trigger Ingestion Post
'403':
description: Forbidden
content:
application/json:
schema:
additionalProperties: true
type: object
title: Response 403 Trigger Dbt Ingestion Api V1 Dbt Cloud Trigger Ingestion Post
'404':
description: Not found
content:
application/json:
schema:
additionalProperties: true
type: object
title: Response 404 Trigger Dbt Ingestion Api V1 Dbt Cloud Trigger Ingestion Post
deprecated: true
security:
- HTTPBearer: []
components:
schemas:
DbtCloudScheduleUpdateRequest:
properties:
sync_type:
anyOf:
- type: string
- type: 'null'
title: Sync Type
description: 'Sync type: ''scheduled'' or ''real_time'''
cron_expr:
anyOf:
- type: string
- type: 'null'
title: Cron Expr
description: Cron expression for sync schedule
lookback_days:
anyOf:
- type: integer
maximum: 365.0
minimum: 1.0
- type: 'null'
title: Lookback Days
description: Days to look back for runs
is_active:
anyOf:
- type: boolean
- type: 'null'
title: Is Active
description: Enable/disable the schedule
type: object
title: DbtCloudScheduleUpdateRequest
description: Request to update the sync schedule.
DbtCloudValidateTokenRequest:
properties:
api_token:
type: string
minLength: 1
title: Api Token
description: dbt Cloud service token
account_id:
type: string
maxLength: 64
minLength: 1
title: Account Id
description: dbt Cloud account ID
api_base_url:
anyOf:
- type: string
- type: 'null'
title: Api Base Url
description: API base URL (for single-tenant or regional deployments)
default: https://cloud.getdbt.com/api/v2/
type: object
required:
- api_token
- account_id
title: DbtCloudValidateTokenRequest
description: Request to validate a dbt Cloud API token.
DbtCloudConnectionUpdateRequest:
properties:
name:
anyOf:
- type: string
maxLength: 128
minLength: 1
- type: 'null'
title: Name
description: Connection name
api_token:
anyOf:
- type: string
minLength: 1
- type: 'null'
title: Api Token
description: dbt Cloud service token (if updating credentials)
api_base_url:
anyOf:
- type: string
- type: 'null'
title: Api Base Url
description: API base URL (for single-tenant or regional deployments)
type: object
title: DbtCloudConnectionUpdateRequest
description: Request to update an existing dbt Cloud connection.
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError
DbtCloudDiscoveryResponse:
properties:
connection_id:
type: integer
title: Connection Id
projects_discovered:
type: integer
title: Projects Discovered
environments_discovered:
type: integer
title: Environments Discovered
projects:
items:
$ref: '#/components/schemas/DbtCloudProjectResponse'
type: array
title: Projects
type: object
required:
- connection_id
- projects_discovered
- environments_discovered
- projects
title: DbtCloudDiscoveryResponse
description: Response after discovering projects/environments.
DbtCloudProjectResponse:
properties:
id:
type: integer
title: Id
external_project_id:
type: string
title: External Project Id
project_name:
anyOf:
- type: string
- type: 'null'
title: Project Name
dbt_core_integration_id:
type: integer
title: Dbt Core Integration Id
is_enabled:
type: boolean
title: Is Enabled
created_at:
type: string
format: date-time
title: Created At
last_modified_at:
type: string
format: date-time
title: Last Modified At
environments:
anyOf:
- items:
$ref: '#/components/schemas/DbtCloudEnvironmentResponse'
type: array
- type: 'null'
title: Environments
type: object
required:
- id
- external_project_id
- project_name
- dbt_core_integration_id
- is_enabled
- created_at
- last_modified_at
title: DbtCloudProjectResponse
description: dbt Cloud project information.
DbtCloudConnectionResponse:
properties:
id:
type: integer
title: Id
name:
type: string
title: Name
account_id:
type: string
title: Account Id
api_base_url:
type: string
title: Api Base Url
is_active:
type: boolean
title: Is Active
created_at:
# --- truncated at 32 KB (44 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/altimate-ai/refs/heads/main/openapi/altimate-ai-dbt-cloud-api-openapi.yml