---
title: "Diagnose Data Pipeline"
method: GET
path: "/api/v1/system/diagnose"
tags: ["system"]
---

# Diagnose Data Pipeline

`GET /api/v1/system/diagnose`

## Request

- Base URL: `https://teraads.co` (the document declares no server; this is the origin it was published from)
- URL: `https://teraads.co/api/v1/system/diagnose`
- Auth: none declared

Diagnose why the dashboard might show no data.

Checks every step of the data pipeline:
1. User & brand exist
2. Platform tokens (OAuth) configured
3. Data sources configured
4. Sync jobs ran successfully
5. Data lake has rows
6. Campaign snapshots (dashboard source) has rows
7. Materialization status

## Query parameters

- `live` boolean: Run live Shopify/Meta/Google/storefront incident checks.
- `brand_id` string, required

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/teraads/apis/tera-ads-api.md) · [All operations](https://skmtc.dev/teraads/apis/tera-ads-api/llms.txt) · [OpenAPI document](https://skmtc.dev/teraads/apis/tera-ads-api/revisions/fb2526b5cf3c?raw)
