---
title: "Submit feedback for a v2 job"
method: POST
path: "/feedback"
tags: ["Feedback"]
---

# Submit feedback for a v2 job

`POST /feedback`

## Request body

- EndpointFeedbackRequest — Submit feedback for a v2 job. Include at least one substantive signal such as issues, note, valuableSources, missingContent, querySuggestions, url, or pageNumbers.
  - `rating` 'good' | 'partial' | 'bad', required
  - `valuableSources` object[]
    - `url` string, uri, required
    - `reason` string
  - `missingContent` object[]
    - `topic` string, required
    - `description` string
  - `querySuggestions` string
  - `origin` string
  - `integration` string, nullable
  - `endpoint` 'search' | 'scrape' | 'parse' | 'map', required
  - `jobId` string, uuid, required
  - `issues` string[]
  - `tags` string[]
  - `note` string
  - `url` string, uri
  - `pageNumbers` integer[]
  - `metadata` object — Small endpoint-specific metadata object. Must be 8KB or smaller; do not include full endpoint results.

## Response `200`

Feedback recorded

- FeedbackResponse
  - `success` boolean, required
  - `feedbackId` string, uuid, required
  - `creditsRefunded` number, required
  - `alreadySubmitted` boolean
  - `dailyCapReached` boolean
  - `creditsRefundedToday` number
  - `dailyRefundCap` number
  - `warning` string

## Other responses

- `400` — Invalid request body
- `403` — Feedback is not available for this team
- `404` — Job not found for this team
- `409` — Feedback cannot be recorded for this job
- `500` — Server error

---

[API](https://skmtc.dev/firecrawl/apis/firecrawl-api.md) · [All operations](https://skmtc.dev/firecrawl/apis/firecrawl-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/firecrawl/firecrawl-api/revisions/e350fafb5a2a/schema)