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

# Feedback Payload Schema

`POST /feedback/payload_schema`

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

---

[API](https://skmtc.net/wandb/apis/serverless-training.md) · [All operations](https://skmtc.net/wandb/apis/serverless-training/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/wandb/serverless-training/revisions/8d8d96fc0fd3/schema)