Skip to main content
GET
https://sandbox.getcollate.io/api
/
v1
/
dashboards
GET /v1/dashboards
from metadata.sdk import configure
from metadata.sdk.entities import Dashboards

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

# List first page
dashboards = Dashboards.list(limit=50)
for d in dashboards.data:
    print(f"{d.fullyQualifiedName}")

# List all with auto-pagination
for d in Dashboards.list_all():
    print(f"{d.fullyQualifiedName}")

# Filter by service
dashboards = Dashboards.list(
    service="sample_superset",
    fields=["owners", "tags", "charts"],
    limit=50
)

for d in dashboards.data:
    print(f"{d.fullyQualifiedName}")
    if d.owners:
        print(f"  Owners: {[o.name for o in d.owners]}")
    if d.tags:
        print(f"  Tags: {[t.tagFQN for t in d.tags]}")
{
  "data": [
    {
      "id": "03fb5cc3-de48-423f-9926-8e192e5de59d",
      "name": "10",
      "displayName": "deck.gl Demo",
      "fullyQualifiedName": "sample_superset.10",
      "description": "",
      "version": 0.1,
      "updatedAt": 1769982666437,
      "updatedBy": "admin",
      "sourceUrl": "http://localhost:808/superset/dashboard/10/",
      "service": {
        "id": "b1e6a71d-7f47-4e5f-8ce0-e6e8a88ec97a",
        "type": "dashboardService",
        "name": "sample_superset",
        "fullyQualifiedName": "sample_superset",
        "deleted": false
      },
      "serviceType": "Superset",
      "href": "http://localhost:8585/api/v1/dashboards/03fb5cc3-de48-423f-9926-8e192e5de59d",
      "deleted": false,
      "owners": [],
      "tags": [],
      "followers": [],
      "votes": {
        "upVotes": 0,
        "downVotes": 0
      },
      "domains": [],
      "charts": [
        {
          "id": "chart-id",
          "type": "chart",
          "name": "114",
          "displayName": "# of Games"
        }
      ]
    }
  ],
  "paging": {
    "after": "...",
    "total": 5
  }
}

List Dashboards

List all dashboards with optional filtering and pagination.

Query Parameters

service
string
Filter by dashboard service fully qualified name.
limit
integer
default:"10"
Maximum number of results to return (max: 1000000).
before
string
Cursor for backward pagination.
after
string
Cursor for forward pagination.
fields
string
Comma-separated list of fields to include: owners, tags, followers, votes, extension, domains, charts, sourceHash. See Supported Fields below.
include
string
default:"non-deleted"
Include all, deleted, or non-deleted entities.
GET /v1/dashboards
from metadata.sdk import configure
from metadata.sdk.entities import Dashboards

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

# List first page
dashboards = Dashboards.list(limit=50)
for d in dashboards.data:
    print(f"{d.fullyQualifiedName}")

# List all with auto-pagination
for d in Dashboards.list_all():
    print(f"{d.fullyQualifiedName}")

# Filter by service
dashboards = Dashboards.list(
    service="sample_superset",
    fields=["owners", "tags", "charts"],
    limit=50
)

for d in dashboards.data:
    print(f"{d.fullyQualifiedName}")
    if d.owners:
        print(f"  Owners: {[o.name for o in d.owners]}")
    if d.tags:
        print(f"  Tags: {[t.tagFQN for t in d.tags]}")
{
  "data": [
    {
      "id": "03fb5cc3-de48-423f-9926-8e192e5de59d",
      "name": "10",
      "displayName": "deck.gl Demo",
      "fullyQualifiedName": "sample_superset.10",
      "description": "",
      "version": 0.1,
      "updatedAt": 1769982666437,
      "updatedBy": "admin",
      "sourceUrl": "http://localhost:808/superset/dashboard/10/",
      "service": {
        "id": "b1e6a71d-7f47-4e5f-8ce0-e6e8a88ec97a",
        "type": "dashboardService",
        "name": "sample_superset",
        "fullyQualifiedName": "sample_superset",
        "deleted": false
      },
      "serviceType": "Superset",
      "href": "http://localhost:8585/api/v1/dashboards/03fb5cc3-de48-423f-9926-8e192e5de59d",
      "deleted": false,
      "owners": [],
      "tags": [],
      "followers": [],
      "votes": {
        "upVotes": 0,
        "downVotes": 0
      },
      "domains": [],
      "charts": [
        {
          "id": "chart-id",
          "type": "chart",
          "name": "114",
          "displayName": "# of Games"
        }
      ]
    }
  ],
  "paging": {
    "after": "...",
    "total": 5
  }
}

Returns

Returns a paginated list of dashboard objects. By default, only basic fields are included. Use the fields parameter to request additional data.

Response

data
array
Array of dashboard objects.
paging
object
Pagination information.

Supported Fields

The following fields can be requested via the fields query parameter:
FieldDescription
ownersOwner references (users and teams)
tagsClassification tags
followersUsers following the dashboard
votesUser votes and ratings
extensionCustom property values
domainsDomain assignments for governance
chartsCharts associated with the dashboard
sourceHashHash for change detection

Error Handling

CodeError TypeDescription
401UNAUTHORIZEDInvalid or missing authentication token
403FORBIDDENUser lacks permission to list dashboards