---
title: "Submit feedback for a search job"
method: POST
path: "/search/{jobId}/feedback"
tags: ["Search", "Feedback"]
---

# Submit feedback for a search job

`POST /search/{jobId}/feedback`

## Path parameters

- `jobId` string, uuid, required

## Request body

- SearchFeedbackRequest — For 'good', include valuableSources. For 'partial', include valuableSources or missingContent. For 'bad', include missingContent or querySuggestions.
  - `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

## 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` — Search not found for this team
- `409` — Feedback cannot be recorded for this search
- `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)
