Skip to main content
GET
/
v1
/
dashboards
List dashboards
curl --request GET \
  --url https://api.coval.dev/v1/dashboards \
  --header 'X-API-Key: <api-key>'
{
  "dashboards": [
    {
      "name": "dashboards/abc123def456ghi789jklm",
      "display_name": "Production Metrics",
      "create_time": "2025-10-14T12:00:00Z",
      "update_time": "2025-10-15T14:30:00Z"
    },
    {
      "name": "dashboards/xyz789abc012def345ghij",
      "display_name": "Voice Agent Quality",
      "create_time": "2025-10-13T08:00:00Z",
      "update_time": "2025-10-13T08:00:00Z"
    }
  ],
  "next_page_token": null
}

Authorizations

​
X-API-Key
string
header
required

API key for authentication

Query Parameters

​
page_size
integer
default:50

Maximum number of results per page

Required range: 1 <= x <= 100
​
page_token
string

Opaque pagination token from previous response

​
order_by
string

Sort field and direction. Prefix with - for descending (e.g. -create_time).

Example:

"-create_time"

Response

Dashboards retrieved successfully

​
dashboards
object[]
required
​
next_page_token
string | null

Token for fetching next page (null if no more results)