Skip to main content
GET
https://sandbox.getcollate.io/api
/
v1
/
services
/
dashboardServices
/
name
/
{fqn}
/
export
GET /v1/services/dashboardServices/name/{fqn}/export
from metadata.sdk import configure
import requests

configure(
    host="https://your-company.getcollate.io/api",
    jwt_token="your-jwt-token"
)

# Synchronous export
response = requests.get(
    "https://your-company.getcollate.io/api/v1/services/dashboardServices/name/sample_looker/export",
    headers={"Authorization": "Bearer your-jwt-token"}
)
csv_data = response.text
print(csv_data)

# Async export
response = requests.get(
    "https://your-company.getcollate.io/api/v1/services/dashboardServices/name/sample_looker/exportAsync",
    headers={"Authorization": "Bearer your-jwt-token"}
)
print(f"Export job: {response.json()}")

# Import CSV (dry run first)
response = requests.put(
    "https://your-company.getcollate.io/api/v1/services/dashboardServices/name/sample_looker/import?dryRun=true",
    headers={
        "Authorization": "Bearer your-jwt-token",
        "Content-Type": "text/plain"
    },
    data=csv_data
)
print(f"Dry run result: {response.json()}")

# Apply the import
response = requests.put(
    "https://your-company.getcollate.io/api/v1/services/dashboardServices/name/sample_looker/import?dryRun=false",
    headers={
        "Authorization": "Bearer your-jwt-token",
        "Content-Type": "text/plain"
    },
    data=csv_data
)
"name,displayName,description,owner,tags,domain\ndeck.gl Demo,deck.gl Demo,Dashboard for deck.gl visualizations,team:data-engineering,Tier.Tier1,,"

Import & Export

Export dashboard service metadata (dashboards, charts, owners, tags) to CSV and import changes back. Supports both synchronous and asynchronous operations.

Export to CSV

GET /v1/services/dashboardServices/name/{fqn}/export
fqn
string
required
Fully qualified name of the dashboard service (e.g., sample_looker).

Export Async

GET /v1/services/dashboardServices/name/{fqn}/exportAsync Returns a job ID for large exports that can be polled for completion.

Import from CSV

PUT /v1/services/dashboardServices/name/{fqn}/import
fqn
string
required
Fully qualified name of the dashboard service.
dryRun
boolean
default:"true"
If true, validates the CSV without applying changes. Set to false to apply.

Import Async

PUT /v1/services/dashboardServices/name/{fqn}/importAsync For large imports, use the async variant which returns a job ID.
GET /v1/services/dashboardServices/name/{fqn}/export
from metadata.sdk import configure
import requests

configure(
    host="https://your-company.getcollate.io/api",
    jwt_token="your-jwt-token"
)

# Synchronous export
response = requests.get(
    "https://your-company.getcollate.io/api/v1/services/dashboardServices/name/sample_looker/export",
    headers={"Authorization": "Bearer your-jwt-token"}
)
csv_data = response.text
print(csv_data)

# Async export
response = requests.get(
    "https://your-company.getcollate.io/api/v1/services/dashboardServices/name/sample_looker/exportAsync",
    headers={"Authorization": "Bearer your-jwt-token"}
)
print(f"Export job: {response.json()}")

# Import CSV (dry run first)
response = requests.put(
    "https://your-company.getcollate.io/api/v1/services/dashboardServices/name/sample_looker/import?dryRun=true",
    headers={
        "Authorization": "Bearer your-jwt-token",
        "Content-Type": "text/plain"
    },
    data=csv_data
)
print(f"Dry run result: {response.json()}")

# Apply the import
response = requests.put(
    "https://your-company.getcollate.io/api/v1/services/dashboardServices/name/sample_looker/import?dryRun=false",
    headers={
        "Authorization": "Bearer your-jwt-token",
        "Content-Type": "text/plain"
    },
    data=csv_data
)
"name,displayName,description,owner,tags,domain\ndeck.gl Demo,deck.gl Demo,Dashboard for deck.gl visualizations,team:data-engineering,Tier.Tier1,,"

Returns

Export returns CSV text with headers and rows for each child entity. Import returns a summary of changes applied (or validation results for dry run).

Error Handling

CodeError TypeDescription
401UNAUTHORIZEDInvalid or missing authentication token
403FORBIDDENUser lacks permission for import/export
404NOT_FOUNDDashboard service with given FQN does not exist
400BAD_REQUESTInvalid CSV format or content