---
canonical_url: "https://docs.composio.dev/toolkits/dbt_cloud"
markdown_url: "https://docs.composio.dev/toolkits/dbt_cloud.md"
product: "platform"
version: null
last_updated: null
---

# dbt Cloud

dbt Cloud provides administrative, metadata discovery, and Semantic Layer APIs for operating analytics projects and querying governed data products.

- **Category:** developer tools
- **Auth:** BEARER_TOKEN, OAUTH2
- **Composio-managed OAuth available?** No
- **Tools:** 20
- **Triggers:** 0
- **Slug:** `DBT_CLOUD`
- **Version:** 00000000_00

## Tools

### Admin API Delete

**Slug:** `DBT_CLOUD_ADMIN_API_DELETE`

Irreversibly delete one selected dbt Cloud administrative resource using a fixed documented Admin API operation from the official v2 or v3 OpenAPI specification. Operation values are provider operation IDs. Deleted resources and configuration cannot be recovered by this action.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `query` | object | No | Optional scalar query parameters for the selected operation. |
| `operation` | string ("admin_v3_destroy_adapter" | "admin_v3_delete_account_connection_delete" | "admin_v2_destroy_ssh_tunnel" | "admin_v3_delete_credentials" | "admin_v3_destroy_projects_environment_variable" | "admin_v3_destroy_projects_environment_variables_bulk" | "admin_v3_delete_environment_sao_cache" | "admin_v3_destroy_environment" | "admin_v3_destroy_extended_attributes" | "admin_v3_delete_ip_restriction" | "admin_v2_destroy_job" | "admin_v3_destroy_license_map" | "admin_v3_delete_lineage_integration" | "admin_v2_destroy_notification" | "admin_v3_destroy_oauth_configuration" | "admin_v3_delete_private_endpoint" | "admin_v3_delete_profile" | "admin_v3_destroy_project" | "admin_v3_destroy_repository" | "admin_v3_destroy_service_token" | "admin_v3_delete_account_scoped_pat" | "admin_v3_delete_user_credentials" | "admin_v3_destroy_webhooks_subscription") | Yes | Exact documented dbt Cloud Admin API DELETE operation ID. Use the matching operation in the official v2 or v3 OpenAPI specification for its exact path and query parameters. |
| `path_params` | object | No | Path parameters required by the selected operation. Do not include account_id; it is always taken from the connected account. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Admin API Read

**Slug:** `DBT_CLOUD_ADMIN_API_READ`

Perform one documented dbt Cloud Admin read selected by operation, using its documented path and optional query parameters from the official v2 and v3 OpenAPI specifications. Operation values are provider operation IDs. This broad read is Bearer-token only because the mapped set includes operations with no official OAuth scope.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `query` | object | No | Documented query parameters for the selected operation. |
| `operation` | string ("admin_v2_list_account_license_allocations" | "admin_v2_list_invites" | "admin_v2_list_notifications" | "admin_v2_list_ssh_tunnels" | "admin_v2_list_users" | "admin_v2_retrieve_account" | "admin_v2_retrieve_invite" | "admin_v2_retrieve_job_artifact" | "admin_v2_retrieve_notification" | "admin_v2_retrieve_run_step" | "admin_v2_retrieve_ssh_tunnel" | "admin_v2_retrieve_user" | "admin_v3_download_bulk_audit_log_export" | "admin_v3_get_account_scoped_pat" | "admin_v3_get_bulk_audit_log_export_status" | "admin_v3_get_credentials" | "admin_v3_get_lineage_integration" | "admin_v3_get_recent_audit_log_events_csv" | "admin_v3_get_user_credentials" | "admin_v3_list_account_connections" | "admin_v3_list_account_scoped_pats" | "admin_v3_list_accounts" | "admin_v3_list_collections_from_bi_tool" | "admin_v3_list_collections_from_bi_tool_2" | "admin_v3_list_credentials" | "admin_v3_list_favorite_asset_responses" | "admin_v3_list_groups" | "admin_v3_list_ip_restrictions" | "admin_v3_list_license_maps" | "admin_v3_list_lineage_integrations" | "admin_v3_list_oauthconfigurations" | "admin_v3_list_private_endpoints" | "admin_v3_list_profiles" | "admin_v3_list_recent_audit_log_events" | "admin_v3_list_repositories" | "admin_v3_list_semantic_layer_credentials" | "admin_v3_list_service_tokens" | "admin_v3_list_user_credentials" | "admin_v3_list_users" | "admin_v3_list_webhooks_events" | "admin_v3_list_webhooks_subscription_event_receipt" | "admin_v3_list_webhooks_subscriptions" | "admin_v3_retrieve_account_connection" | "admin_v3_retrieve_adapter" | "admin_v3_retrieve_adapter_schema" | "admin_v3_retrieve_environment" | "admin_v3_retrieve_extended_attributes" | "admin_v3_retrieve_group" | "admin_v3_retrieve_ip_restriction" | "admin_v3_retrieve_license_map" | "admin_v3_retrieve_oauth_configuration" | "admin_v3_retrieve_private_endpoint" | "admin_v3_retrieve_profile" | "admin_v3_retrieve_project" | "admin_v3_retrieve_projects_environment_variables_environment" | "admin_v3_retrieve_projects_environment_variables_job" | "admin_v3_retrieve_projects_environment_variables_user" | "admin_v3_retrieve_projects_managed_repositories_download" | "admin_v3_retrieve_repository" | "admin_v3_retrieve_service_token" | "admin_v3_retrieve_service_tokens_permission" | "admin_v3_retrieve_user" | "admin_v3_retrieve_webhooks_subscription" | "admin_v3_test_webhooks_subscription" | "admin_v3_validate_client_ip_against_ip_restrictions" | "admin_v3_validate_client_ip_against_ip_restrictions_excluding_specified_ip_rule") | Yes | Documented dbt Cloud Admin API GET operation ID. Use the matching operation in the official v2 or v3 OpenAPI specification to determine its exact path and query parameters. |
| `path_params` | object | No | Values for the selected operation's documented path placeholders. Do not supply account_id; it always comes from the connection. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Admin API Write

**Slug:** `DBT_CLOUD_ADMIN_API_WRITE`

Execute one predeclared dbt Cloud Administrative API POST, PATCH, or PUT operation. Selected operations may create or mutate administrative resources; review the matching provider OpenAPI operation, path parameters, query, and body before execution. Operation values are provider operation IDs. This action is bearer-token only because the operation set includes routes outside dbt Cloud's officially documented OAuth scopes.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `body` | object | No | Documented JSON request body; omit when the operation takes no body. |
| `query` | object | No | Documented query parameters as JSON values. |
| `operation` | string ("admin_v2_create_job" | "admin_v2_create_notification" | "admin_v2_create_ssh_tunnel" | "admin_v2_partial_update_account" | "admin_v2_retry_failed_job" | "admin_v2_unsubscribe_from_notifications" | "admin_v2_update_account" | "admin_v2_update_job" | "admin_v2_update_license_permissions" | "admin_v2_update_notification" | "admin_v2_update_ssh_tunnel" | "admin_v2_update_user" | "admin_v3_assign_group_permissions" | "admin_v3_assign_user_to_groups" | "admin_v3_create_account_connection" | "admin_v3_create_account_scoped_pat" | "admin_v3_create_adapter" | "admin_v3_create_credentials" | "admin_v3_create_environment" | "admin_v3_create_extended_attributes" | "admin_v3_create_group" | "admin_v3_create_license_map" | "admin_v3_create_lineage_integration" | "admin_v3_create_managed_repository" | "admin_v3_create_oauthconfiguration" | "admin_v3_create_private_endpoint" | "admin_v3_create_profile" | "admin_v3_create_project" | "admin_v3_create_projects_environment_variable" | "admin_v3_create_projects_environment_variables_bulk" | "admin_v3_create_repository" | "admin_v3_create_service_token" | "admin_v3_create_user_credentials" | "admin_v3_create_webhooks_subscription" | "admin_v3_enable_ip_restrictions" | "admin_v3_partial_update_credentials" | "admin_v3_rotate_account_scoped_pat" | "admin_v3_save_ip_restriction" | "admin_v3_send_user_invites" | "admin_v3_submit_bulk_audit_log_export_request" | "admin_v3_update_account_connection" | "admin_v3_update_adapter" | "admin_v3_update_credentials" | "admin_v3_update_environment" | "admin_v3_update_extended_attributes" | "admin_v3_update_group" | "admin_v3_update_ip_restriction" | "admin_v3_update_license_map" | "admin_v3_update_lineage_integration" | "admin_v3_update_lineage_integration_selections" | "admin_v3_update_oauth_configuration" | "admin_v3_update_private_endpoint" | "admin_v3_update_profile" | "admin_v3_update_project" | "admin_v3_update_projects_environment_variable" | "admin_v3_update_projects_environment_variables_bulk" | "admin_v3_update_repository" | "admin_v3_update_service_token" | "admin_v3_update_user_credentials" | "admin_v3_update_webhooks_subscription") | Yes | Documented dbt Cloud Admin operation ID. Use the matching operation in the official v2 or v3 OpenAPI specification for exact path, query, and JSON body fields. |
| `path_params` | object | No | Exact non-account path parameters required by the selected operation. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Cancel Run

**Slug:** `DBT_CLOUD_CANCEL_RUN`

Irreversibly request cancellation of a queued, starting, or running dbt Cloud run. This mutates the selected run's execution state and does not delete its run record. The response is the run record returned after the cancellation request.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `run_id` | integer | Yes | Numeric ID of the queued, starting, or running dbt Cloud run to cancel. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Download Run Artifact

**Slug:** `DBT_CLOUD_DOWNLOAD_RUN_ARTIFACT`

Download one artifact file from a completed dbt Cloud run using a path returned by List Run Artifacts.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `step` | integer | No | One-based run step index. Omit it to download the artifact compiled for the run's last step. |
| `run_id` | integer | Yes | Numeric ID of the dbt Cloud run that produced the artifact. |
| `artifact_path` | string | Yes | Artifact path exactly as returned by List Run Artifacts, such as manifest.json or metadata/telemetry-1-otel.parquet. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Find Semantic Saved Queries

**Slug:** `DBT_CLOUD_FIND_SEMANTIC_SAVED_QUERIES`

List or search saved Semantic Layer queries, or return one exact saved query by name.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `search` | string | No | Substring for listing saved queries; mutually exclusive with saved_query_name. |
| `page_size` | integer | No | Maximum saved queries in this page (1-100). |
| `next_cursor` | string | No | Opaque cursor returned by a previous list call; omit for page one. |
| `environment_id` | integer | Yes | Semantic Layer production environment to query. |
| `saved_query_name` | string | No | Exact saved-query name to retrieve; omit to list or search. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Job

**Slug:** `DBT_CLOUD_GET_JOB`

Return one dbt Cloud job definition and optionally selected related execution context.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `job_id` | integer | Yes | Job to retrieve. |
| `include_related` | array | No | Related job objects to include in the response. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Run

**Slug:** `DBT_CLOUD_GET_RUN`

Return one dbt Cloud run with optional job, environment, step, retry, audit, or log context.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `run_id` | integer | Yes | Run to retrieve. |
| `include_related` | array | No | Related run objects to include in the response. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Run Failure Details

**Slug:** `DBT_CLOUD_GET_RUN_FAILURE_DETAILS`

Return dbt Cloud status and step logs for a failed run. This action only reads the run record and never starts or enqueues a retry.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `run_id` | integer | Yes | Failed run whose failure diagnostics to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Environments

**Slug:** `DBT_CLOUD_LIST_ENVIRONMENTS`

Return one page of environments for a dbt Cloud project, with optional deployment and name filters.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum environments in this page (1-100). |
| `project_id` | integer | Yes | Project whose environments to list. |
| `next_cursor` | string | No | Opaque cursor returned by a previous call; omit for the first page and pass it back unchanged to continue. |
| `name_contains` | string | No | Case-insensitive substring to match against environment names. |
| `deployment_type` | string ("production" | "staging") | No | Restrict results to production or staging environments. |
| `include_related` | array | No | Related environment objects to include. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Jobs

**Slug:** `DBT_CLOUD_LIST_JOBS`

Return one page of dbt Cloud jobs, optionally filtered by project, environment, name, schedule, or state.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum jobs in this page (1-100). |
| `state` | string ("active" | "deleted" | "all") | No | Soft-deletion state to return. |
| `project_id` | integer | No | Project whose jobs to return. |
| `next_cursor` | string | No | Opaque cursor returned by a previous call; omit for the first page. |
| `name_contains` | string | No | Case-insensitive substring to match against job names. |
| `environment_id` | integer | No | Environment whose jobs to return. |
| `include_related` | array | No | Related job objects to include. |
| `triggers_schedule` | boolean | No | Filter by whether jobs run on a schedule. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Projects

**Slug:** `DBT_CLOUD_LIST_PROJECTS`

Return one page of dbt Cloud projects, optionally filtered by name, IDs, or deletion state.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum projects in this page (1-100). |
| `state` | string ("active" | "deleted" | "all") | No | Soft-deletion state to return. |
| `next_cursor` | string | No | Opaque cursor returned by a previous call; omit for the first page. |
| `project_ids` | array | No | Project IDs to include. |
| `name_contains` | string | No | Case-insensitive substring to match against project names. |
| `include_related` | array | No | Related project objects to include. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Run Artifacts

**Slug:** `DBT_CLOUD_LIST_RUN_ARTIFACTS`

Return artifact paths available for a completed dbt Cloud run.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `run_id` | integer | Yes | Completed run whose artifact paths to list. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Runs

**Slug:** `DBT_CLOUD_LIST_RUNS`

Return one page of dbt Cloud runs, optionally filtered by job, project, environment, status, creation time, finish time, or deletion state.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum runs in this page (1-100). |
| `state` | string ("active" | "deleted" | "all") | No | Run soft-deletion state to return. 'all' omits the provider state filter. |
| `job_id` | integer | No | Job ID persisted on each run record; sent as dbt's job_definition_id filter. Runs whose job was deleted or detached may report 0 instead. |
| `statuses` | array | No | Run statuses to include. Multiple values are combined as one filter. |
| `project_id` | integer | No | Project ID persisted on each run record. Runs whose project was deleted or detached may report 0 instead. |
| `next_cursor` | string | No | Opaque cursor returned by a previous call; omit for the first page. |
| `environment_id` | integer | No | Environment whose runs to return. |
| `include_related` | array | No | Related run objects to include in each result. |
| `created_at_range` | array | No | Inclusive creation-time range as exactly two ISO 8601 timestamps: start, then end. |
| `finished_at_range` | array | No | Inclusive finish-time range as exactly two ISO 8601 timestamps: start, then end. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Semantic Attributes

**Slug:** `DBT_CLOUD_LIST_SEMANTIC_ATTRIBUTES`

Return one page of dimensions, entities, group-bys, or queryable time granularities available for selected metrics.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `search` | string | No | Substring filter for dimensions, entities, or group-bys; not used for time granularities. |
| `metrics` | array | No | Metrics is a list of objects shaped like [{"name": "revenue"}]. It selects the metrics whose compatible attributes to return. Required and non-empty for dimension and time_granularity; optional for entity and group_by. |
| `page_size` | integer | No | Maximum attributes in this page when the selected operation is paginated. |
| `next_cursor` | string | No | Opaque cursor returned by a previous paginated call; omit for page one. |
| `attribute_type` | string ("dimension" | "entity" | "group_by" | "time_granularity") | Yes | Kind of queryable attribute to list. dimension and time_granularity require at least one metric; entity and group_by do not. |
| `environment_id` | integer | Yes | Semantic Layer production environment to query. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Semantic Metrics

**Slug:** `DBT_CLOUD_LIST_SEMANTIC_METRICS`

Return one page of governed Semantic Layer metrics, optionally searched or grouped.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `search` | string | No | Substring used by the documented metrics search. |
| `group_by` | array | No | Grouping definitions for the metric listing. |
| `page_size` | integer | No | Maximum metrics in this page. |
| `next_cursor` | string | No | Opaque cursor returned by a previous call; omit for page one. |
| `environment_id` | integer | Yes | Semantic Layer production environment to query. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Query Discovery Metadata

**Slug:** `DBT_CLOUD_QUERY_DISCOVERY_METADATA`

List dbt metadata resources in an environment or job-run context, retrieve one node by case-sensitive unique ID, or inspect model health in an environment.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum resources in this page (1-100). |
| `job_id` | integer | No | Job ID; required when context is job. |
| `run_id` | integer | No | Historical run ID for job context; omit for the latest run. |
| `context` | string ("environment" | "job") | Yes | Use latest environment state or a job's latest or specified run. |
| `operation` | string ("list_resources" | "get_node_details" | "get_model_health") | Yes | Discovery intent to execute. |
| `unique_id` | string | No | Case-sensitive dbt unique ID; required for node details or model health. |
| `next_cursor` | string | No | Opaque cursor returned by a previous list call; omit for the first page. |
| `resource_type` | string ("model" | "source" | "seed" | "snapshot" | "test" | "macro" | "metric" | "exposure") | No | Resource family; required for listing and details. Model health is fixed to model. |
| `environment_id` | integer | No | Environment ID; required when context is environment. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Query Semantic Metrics

**Slug:** `DBT_CLOUD_QUERY_SEMANTIC_METRICS`

Submit an ad-hoc dbt Semantic Layer query using metrics and/or group-bys, or execute a saved query; poll it to a documented terminal state and return one decoded JSON result page. Pass next_cursor to retrieve another page without creating a new query.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum records requested from the metric query. |
| `where` | array | No | Semantic Layer filter expressions for an ad-hoc or saved query. |
| `metrics` | array | No | Metrics for an ad-hoc query; omit when saved_query is set. |
| `group_by` | array | No | Dimensions or entities used to group an ad-hoc query. |
| `order_by` | array | No | Result ordering; each item selects exactly one metric or group_by target. |
| `next_cursor` | string | No | Opaque result-page cursor returned by this action. When set, fetches that page without creating or polling another query. |
| `saved_query` | string | No | Saved-query name to execute; mutually exclusive with metrics and group_by. |
| `environment_id` | integer | No | Semantic Layer production environment to query. Required when starting a query; omit when continuing with next_cursor. |
| `poll_timeout_seconds` | integer | No | Maximum total polling time before failing. Must not exceed poll_interval_seconds multiplied by 99, or by 79 when include_query_metadata is true. |
| `poll_interval_seconds` | number | No | Seconds between status checks. Must be large enough that poll_timeout_seconds uses at most 99 checks, or 79 when include_query_metadata is true. |
| `include_query_metadata` | boolean | No | Also query the documented queryRecords field and include the matching execution record when available. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Retry Run

**Slug:** `DBT_CLOUD_RETRY_RUN`

Start a new retry from a failed dbt Cloud run and return the newly enqueued run record.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `run_id` | integer | Yes | Numeric ID of the failed dbt Cloud run to retry. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Trigger Job Run

**Slug:** `DBT_CLOUD_TRIGGER_JOB_RUN`

Start a new run for a dbt Cloud job, optionally overriding its revision, target, commands, docs generation, threads, or timeout. Each successful call enqueues a new run.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cause` | string | Yes | Non-empty reason recorded for this run. |
| `job_id` | integer | Yes | Numeric ID of the dbt Cloud job to run. |
| `git_sha` | string | No | Git commit SHA to check out before running. |
| `git_branch` | string | No | Git branch to check out before running. |
| `steps_override` | array | No | Non-empty dbt commands that replace the job's configured commands. |
| `schema_override` | string | No | Destination schema override for the configured target. |
| `threads_override` | integer | No | Number of execution threads to use. |
| `dbt_version_override` | string ("fallback" | "extended" | "compatible" | "latest" | "fusion-fallback" | "fusion-extended" | "latest-fusion" | "fusion-stable" | "fusion-nightly") | No | dbt runtime channel override. |
| `target_name_override` | string | No | Override for the target.name context value. |
| `generate_docs_override` | boolean | No | Whether this run should generate docs. |
| `timeout_seconds_override` | integer | No | Run timeout in seconds. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |