---
title: "Get the status of public dashboard links"
method: GET
path: "/api/{org_id}/public_dashboards/status"
tags: ["Public Dashboards"]
---

# Get the status of public dashboard links

`GET /api/{org_id}/public_dashboards/status`

## Request

- Base URL: `https://api.openobserve.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.openobserve.ai/api/{org_id}/public_dashboards/status`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/openobserve/apis/openobserve-api-http/docs/api/:org_id/public_dashboards/status/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `org_id` string, required

## Query parameters

- `ids` string

## Response `200`

Success

- LinkStatusList
  - `list` LinkStatusReport[], required
    - `access_count` integer, required
    - `last_accessed_at` integer, nullable
    - `link_id` string, required
    - `ranges` RangeStatus[], required
      - `built_at` integer, nullable
      - `incomplete_count` integer, required
      - `key` string, required
      - `last_error` string, nullable
      - `next_retry_at` integer, nullable: When the next build may start after a failure; absent from a querier that predates it.
      - `sources` object, nullable: Panel id to the typed streams its data was read from; left out of the batch call.
      - `state` 'cached' | 'not_cached' | 'building' | 'needs_attention', required: One range's result on the querier that owns the link, as the publisher's status call reports.
      - `unavailable_count` integer, required
      - `withheld_panels` WithheldPanel[], required
        - `panel_id` string, required
        - `reason` 'unauthorized' | 'unsupported' | 'no_query' | 'too_large' | 'too_many_panels' | 'truncated' | 'build_error' | 'too_old' | 'changed', required: Why a panel is withheld; deliberately generic, it never names a stream on the public plane.

---

[API](https://skmtc.dev/openobserve/apis/openobserve-api-http.md) - [All operations](https://skmtc.dev/openobserve/apis/openobserve-api-http/llms.txt) - [OpenAPI document](https://skmtc.dev/openobserve/apis/openobserve-api-http/revisions/0529b8a10252?raw)