Skip to main content
Databricks logo

Overview

Add Databricks to any ModuleX agent or workflow. Manage Databricks jobs, runs, SQL warehouses, and vector search indexes via the Databricks REST API ({domain}.cloud.databricks.com).
Categories: Analytics & Data · Data Engineering · Analytics · Machine Learning · Auth: Databricks Personal Access Token · Actions: 41

Authentication

Databricks Personal Access Token

Authenticate using your Databricks workspace domain and a personal access token.

Required Credentials

FieldDescriptionRequiredFormat
Workspace DomainYour Databricks workspace subdomain (the part before .cloud.databricks.com).Yesmy-workspace
Access TokenA Databricks personal access token.Yesdapi0123456789abcdef0123456789abcdef

Available Actions

Parameters

job_id
string
Identifier of a job. If omitted with all_queued_runs=true, cancels all queued runs in the workspace.
all_queued_runs
boolean
Cancel all queued runs. If no job_id is provided, all queued runs in the workspace are canceled.

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    }
  },
  "required": [
    "success"
  ],
  "title": "CancelAllRunsOutput",
  "type": "object"
}

Parameters

run_id
string
required
Identifier of the run to cancel.

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    }
  },
  "required": [
    "success"
  ],
  "title": "CancelRunOutput",
  "type": "object"
}

Parameters

name
string
required
The name of the vector search endpoint to create.

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "data": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Data"
    }
  },
  "required": [
    "success"
  ],
  "title": "CreateEndpointOutput",
  "type": "object"
}

Parameters

tasks
string
required
JSON string of task specifications for this job.
name
string
An optional name for the job.
tags
string
JSON string of tags associated with the job.
job_clusters
string
JSON string of job cluster specifications.
email_notifications
string
JSON string of email notification settings.
webhook_notifications
string
JSON string of webhook notification settings.
timeout_seconds
integer
Timeout in seconds applied to each run of this job.
schedule
string
JSON string of schedule definition with quartz_cron_expression and timezone_id.
max_concurrent_runs
integer
Maximum number of concurrent runs for the job.
git_source
string
JSON string specifying a remote Git repository for task source code.
access_control_list
string
JSON string of permissions to set on the job.

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "job_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Job Id"
    }
  },
  "required": [
    "success"
  ],
  "title": "CreateJobOutput",
  "type": "object"
}

Parameters

name
string
required
A human-readable name for the warehouse.
cluster_size
string
required
Size of the cluster: 2X-Small, X-Small, Small, Medium, Large, X-Large, 2X-Large, 3X-Large, 4X-Large.
auto_stop_minutes
integer
Minutes of inactivity before auto-stop. 0 disables. Must be 0 or >= 10. (Default: 10)
min_num_clusters
integer
Minimum number of clusters to maintain. (Default: 1)
max_num_clusters
integer
Maximum number of clusters for autoscaling. (Default: 1)
enable_photon
boolean
Whether to use Photon optimized clusters.
enable_serverless_compute
boolean
Whether to use serverless compute.
warehouse_type
string
Warehouse type: TYPE_UNSPECIFIED, CLASSIC, or PRO.
spot_instance_policy
string
Spot instance policy: POLICY_UNSPECIFIED, COST_OPTIMIZED, RELIABILITY_OPTIMIZED.
channel
string
JSON string of channel details.
tags
string
JSON string of custom key-value tags.

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "data": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Data"
    }
  },
  "required": [
    "success"
  ],
  "title": "CreateSqlWarehouseOutput",
  "type": "object"
}

Parameters

name
string
required
A unique name for the index (e.g., main_catalog.docs.en_wiki_index).
endpoint_name
string
required
The name of the vector search endpoint.
index_type
string
required
Type of index: DELTA_SYNC or DIRECT_ACCESS.
primary_key
string
required
The primary key column for the index.
source_table
string
The Delta table backing the index (required for DELTA_SYNC).
columns_to_sync
string
JSON array of column names to sync from the source Delta table.
embedding_source_columns
string
JSON array of embedding source column configs.
index_schema_json
string
The schema of the index in JSON format (required for DIRECT_ACCESS). Sent on the wire as schema_json.
pipeline_type
string
Pipeline type: TRIGGERED or CONTINUOUS. (Default: TRIGGERED)

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "data": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Data"
    }
  },
  "required": [
    "success"
  ],
  "title": "CreateVectorSearchIndexOutput",
  "type": "object"
}

Parameters

endpoint_name
string
required
The name of the vector search endpoint to delete.

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    }
  },
  "required": [
    "success"
  ],
  "title": "DeleteEndpointOutput",
  "type": "object"
}

Parameters

job_id
string
required
Identifier of the job to delete.

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    }
  },
  "required": [
    "success"
  ],
  "title": "DeleteJobOutput",
  "type": "object"
}

Parameters

run_id
string
required
Identifier of the run to delete.

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    }
  },
  "required": [
    "success"
  ],
  "title": "DeleteRunOutput",
  "type": "object"
}

Parameters

warehouse_id
string
required
The ID of the SQL Warehouse to delete.

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    }
  },
  "required": [
    "success"
  ],
  "title": "DeleteSqlWarehouseOutput",
  "type": "object"
}

Parameters

index_name
string
required
The name of the vector search index to delete.

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    }
  },
  "required": [
    "success"
  ],
  "title": "DeleteVectorSearchIndexOutput",
  "type": "object"
}

Parameters

index_name
string
required
The name of the vector search index.
primary_keys
string
required
JSON array of primary key values to delete.

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "data": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Data"
    }
  },
  "required": [
    "success"
  ],
  "title": "DeleteVectorSearchIndexDataOutput",
  "type": "object"
}

Parameters

warehouse_id
string
required
The ID of the SQL Warehouse to edit.
name
string
New logical name for the warehouse.
cluster_size
string
Size of clusters: 2X-Small, X-Small, Small, Medium, Large, X-Large, 2X-Large, 3X-Large, 4X-Large.
auto_stop_mins
integer
Minutes of inactivity before auto-stop. 0 disables. Must be 0 or >= 10.
min_num_clusters
integer
Minimum number of clusters.
max_num_clusters
integer
Maximum number of clusters for autoscaling.
enable_photon
boolean
Whether to use Photon optimized clusters.
enable_serverless_compute
boolean
Whether to use serverless compute.
warehouse_type
string
Warehouse type: TYPE_UNSPECIFIED, CLASSIC, or PRO.
spot_instance_policy
string
Spot instance policy: POLICY_UNSPECIFIED, COST_OPTIMIZED, RELIABILITY_OPTIMIZED.
tags
string
JSON string of custom key-value tags.
channel
string
JSON string of channel details.

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "data": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Data"
    }
  },
  "required": [
    "success"
  ],
  "title": "EditSqlWarehouseOutput",
  "type": "object"
}

Parameters

run_id
string
required
Identifier of the run to export.
views_to_export
string
Which views to export: CODE, DASHBOARDS, or ALL. Defaults to CODE.

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "data": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Data"
    }
  },
  "required": [
    "success"
  ],
  "title": "ExportRunOutput",
  "type": "object"
}

Parameters

endpoint_name
string
required
The name of the vector search endpoint.

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "data": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Data"
    }
  },
  "required": [
    "success"
  ],
  "title": "GetEndpointOutput",
  "type": "object"
}

Parameters

job_id
string
required
Identifier of the job.

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "data": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Data"
    }
  },
  "required": [
    "success"
  ],
  "title": "GetJobOutput",
  "type": "object"
}

Parameters

job_id
string
required
Identifier of the job.

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "data": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Data"
    }
  },
  "required": [
    "success"
  ],
  "title": "GetJobPermissionsOutput",
  "type": "object"
}

Parameters

run_id
string
required
Identifier of the run.
include_history
boolean
Whether to include the repair history in the response.
include_resolved_values
boolean
Whether to include resolved parameter values in the response.

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "data": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Data"
    }
  },
  "required": [
    "success"
  ],
  "title": "GetRunOutput",
  "type": "object"
}

Parameters

run_id
string
required
Identifier of the run.

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "data": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Data"
    }
  },
  "required": [
    "success"
  ],
  "title": "GetRunOutputOutput",
  "type": "object"
}

Parameters

warehouse_id
string
required
The ID of the SQL Warehouse.

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "data": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Data"
    }
  },
  "required": [
    "success"
  ],
  "title": "GetSqlWarehouseOutput",
  "type": "object"
}

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "data": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Data"
    }
  },
  "required": [
    "success"
  ],
  "title": "GetSqlWarehouseConfigOutput",
  "type": "object"
}

Parameters

warehouse_id
string
required
The ID of the SQL Warehouse.

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "data": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Data"
    }
  },
  "required": [
    "success"
  ],
  "title": "GetSqlWarehousePermissionsOutput",
  "type": "object"
}

Parameters

index_name
string
required
The name of the vector search index.

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "data": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Data"
    }
  },
  "required": [
    "success"
  ],
  "title": "GetVectorSearchIndexOutput",
  "type": "object"
}

Parameters

max_results
integer
Maximum number of endpoints to return. (Default: 100)

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "endpoints": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "title": "Endpoints",
      "type": "array"
    }
  },
  "required": [
    "success"
  ],
  "title": "ListEndpointsOutput",
  "type": "object"
}

Parameters

expand_tasks
boolean
Whether to include task and cluster details in the response.
name
string
Optional name to filter on.
max_requests
integer
Maximum number of API page requests to make (1-10).

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "jobs": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "title": "Jobs",
      "type": "array"
    }
  },
  "required": [
    "success"
  ],
  "title": "ListJobsOutput",
  "type": "object"
}

Parameters

job_id
string
Identifier of a job to filter runs.
active_only
boolean
Set to true to return only active runs.
max_results
integer
Maximum number of runs to return. (Default: 100)

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "runs": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "title": "Runs",
      "type": "array"
    }
  },
  "required": [
    "success"
  ],
  "title": "ListRunsOutput",
  "type": "object"
}

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "warehouses": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "title": "Warehouses",
      "type": "array"
    }
  },
  "required": [
    "success"
  ],
  "title": "ListSqlWarehousesOutput",
  "type": "object"
}

Parameters

endpoint_name
string
required
The name of the vector search endpoint.

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "indexes": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "title": "Indexes",
      "type": "array"
    }
  },
  "required": [
    "success"
  ],
  "title": "ListVectorSearchIndexesOutput",
  "type": "object"
}

Parameters

index_name
string
required
The name of the vector search index.
columns
string
required
JSON array of column names to include in the response.
query_text
string
Free-text query for semantic search.
query_vector
string
JSON array of floats representing the embedding vector.
filters_json
string
JSON string representing query filters.
num_results
integer
Number of results to return. (Default: 10)
include_embeddings
boolean
Whether to include embedding vectors in the results.

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "data": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Data"
    }
  },
  "required": [
    "success"
  ],
  "title": "QueryVectorSearchIndexOutput",
  "type": "object"
}

Parameters

run_id
string
required
Identifier of the run to repair.
rerun_tasks
string
JSON array of task keys to repair.
rerun_all_failed_tasks
boolean
If true, repair all failed tasks.
pipeline_params_full_refresh
boolean
Controls whether the pipeline should perform a full refresh.

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "repair_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Repair Id"
    }
  },
  "required": [
    "success"
  ],
  "title": "RepairRunOutput",
  "type": "object"
}

Parameters

job_id
string
required
Identifier of the job.
new_settings
string
required
JSON string of the new settings that fully replaces all existing job settings.

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    }
  },
  "required": [
    "success"
  ],
  "title": "ResetJobOutput",
  "type": "object"
}

Parameters

job_id
string
required
Identifier of the job to run.
jar_params
string
JSON array of parameters for jobs with JAR tasks.
notebook_params
string
JSON object of key-value pairs for notebook tasks.
python_params
string
JSON array of parameters for Python tasks.
spark_submit_params
string
JSON array of parameters for spark submit tasks.

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "run_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Run Id"
    },
    "number_in_job": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Number In Job"
    }
  },
  "required": [
    "success"
  ],
  "title": "RunJobNowOutput",
  "type": "object"
}

Parameters

index_name
string
required
The name of the vector search index.
last_primary_key
string
Primary key of the last entry returned in the previous scan. Leave empty to start from the beginning.
num_results
integer
Number of results to return. (Default: 10)

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "data": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Data"
    }
  },
  "required": [
    "success"
  ],
  "title": "ScanVectorSearchIndexOutput",
  "type": "object"
}

Parameters

job_id
string
required
Identifier of the job.
access_control_list
string
required
JSON string of permission objects with user_name/group_name/service_principal_name and permission_level.

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "data": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Data"
    }
  },
  "required": [
    "success"
  ],
  "title": "SetJobPermissionsOutput",
  "type": "object"
}

Parameters

instance_profile_arn
string
Instance profile ARN for IAM role (AWS).
google_service_account
string
Service account email for GCP workspaces.
security_policy
string
Security policy: NONE or DATA_ACCESS_CONTROL.
channel
string
JSON string of channel details.
enabled_warehouse_types
string
JSON array of enabled warehouse type objects.
config_param
string
JSON array of general config key/value pairs.
global_param
string
JSON array of global parameter key/value pairs.

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "data": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Data"
    }
  },
  "required": [
    "success"
  ],
  "title": "SetSqlWarehouseConfigOutput",
  "type": "object"
}

Parameters

warehouse_id
string
required
The ID of the SQL Warehouse.
access_control_list
string
required
JSON string of access control entries with user_name/group_name/service_principal_name and permission_level.

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "data": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Data"
    }
  },
  "required": [
    "success"
  ],
  "title": "SetSqlWarehousePermissionsOutput",
  "type": "object"
}

Parameters

warehouse_id
string
required
The ID of the SQL Warehouse to start.

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    }
  },
  "required": [
    "success"
  ],
  "title": "StartSqlWarehouseOutput",
  "type": "object"
}

Parameters

warehouse_id
string
required
The ID of the SQL Warehouse to stop.

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    }
  },
  "required": [
    "success"
  ],
  "title": "StopSqlWarehouseOutput",
  "type": "object"
}

Parameters

index_name
string
required
The name of the vector search index to synchronize.

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "data": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Data"
    }
  },
  "required": [
    "success"
  ],
  "title": "SyncVectorSearchIndexOutput",
  "type": "object"
}

Parameters

job_id
string
required
Identifier of the job to update.
new_settings
string
required
JSON string of updated job settings (only fields to change).
fields_to_remove
string
JSON array of field paths to remove from the job settings.

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    }
  },
  "required": [
    "success"
  ],
  "title": "UpdateJobOutput",
  "type": "object"
}

Parameters

index_name
string
required
The name of the vector search index.
inputs_json
string
required
JSON array of row objects to upsert.

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "data": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Data"
    }
  },
  "required": [
    "success"
  ],
  "title": "UpsertVectorSearchIndexDataOutput",
  "type": "object"
}

Limits & Quotas

  • Databricks API rate limits vary by endpoint and workspace tier. Consult your workspace admin for specific limits.
  • Jobs API: typically 30 requests/second per workspace.
  • Vector Search API: limits depend on endpoint configuration and provisioned capacity.
  • SQL Warehouses API: standard REST API limits apply.
  • Error model: non-2xx responses are caught and returned as success=False + error rather than raising.

Google Tag Manager

Microsoft Power BI

Mixpanel