---
title: "Feedback Payload Schema"
method: POST
path: "/feedback/payload_schema"
tags: ["Feedback"]
---

# Feedback Payload Schema

`POST /feedback/payload_schema`

## 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/feedback/payload_schema`
- Auth: none declared

Discover feedback payload schema (paths and types) from sample rows.

## Request body

- FeedbackPayloadSchemaReq: Request for feedback payload schema discovery.
  - `project_id` string, required
  - `start` string, date-time, required: Inclusive start time (UTC, ISO 8601).
  - `end` string, date-time, nullable: Exclusive end time (UTC, ISO 8601). Defaults to now if omitted.
  - `feedback_type` string, nullable: Filter by feedback_type.
  - `trigger_ref` string, nullable: Filter by trigger_ref (exact or prefix match for all-versions).
  - `sample_limit` integer: Max distinct trigger_refs to sample when discovering the payload schema. Each distinct trigger_ref (monitor/source) typically has a fixed payload structure, so sampling one payload per ref is usually enough to see the full schema. 2 000 covers virtually all real-world projects while keeping the query fast; the hard cap of 5 000 prevents runaway scans.

## Response `200`

Successful Response

- FeedbackPayloadSchemaRes: Response with discovered feedback payload paths and types.
  - `paths` FeedbackPayloadPath[]: Discovered leaf paths with inferred value types.
    - `json_path` string, required: Dot path into payload (e.g. 'output.score').
    - `value_type` 'numeric' | 'boolean' | 'categorical': Inferred type of value at path.

## Other responses

- `422`: Validation Error

## Changes

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

[Operation history](https://skmtc.dev/wandb/apis/fastapi/changes/feedback/payload_schema/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)