---
title: "Dataset Sources Query"
method: POST
path: "/dataset_sources/query"
tags: ["Dataset Sources"]
---

# Dataset Sources Query

`POST /dataset_sources/query`

## Request

- Base URL: `https://trace.wandb.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://trace.wandb.ai/dataset_sources/query`
- Auth: none declared

Forward provenance lookup: dataset (+ optional row digests) -> sources.

## Request body

- DatasetSourcesQueryReq: Forward query: dataset -> sources.
  - `project_id` string, required
  - `dataset_object_id` string, required
  - `row_digests` string[], nullable
  - `source_kinds` SourceKind[], nullable
  - `include_deleted` boolean
  - `limit` integer, nullable
  - `offset` integer, nullable
  - `wb_user_id` string, nullable: Do not set directly. Server will automatically populate this field.

## Response `200`

Successful Response

- DatasetSourcesQueryRes: Response from the forward dataset -> sources query.
  - `links` DatasetSourceLinkSchema[], required
    - `id` string, required
    - `row_digest` string, required
    - `source_kind` 'call' | 'span' | 'conversation', required
    - `source_id` string, required
    - `source_trace_id` string, required
    - `source_started_at` string, date-time, required
    - `source_display_name` string, required
    - `link_metadata` object, nullable, required
    - `added_by` string, nullable, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `deleted_at` string, date-time, nullable, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-16** `dd89fadfe4e4`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/wandb/apis/fastapi/changes/dataset_sources/query/post.md)

---

[API](https://skmtc.dev/wandb/apis/fastapi.md) - [All operations](https://skmtc.dev/wandb/apis/fastapi/llms.txt) - [OpenAPI document](https://skmtc.dev/wandb/apis/fastapi/revisions/f7643c49bf2e?raw)