---
title: "Gives feedback on whether a task setup follows the task design rules, before anything is created."
method: POST
path: "/job/task-feedback"
tags: ["Job"]
---

# Gives feedback on whether a task setup follows the task design rules, before anything is created.

`POST /job/task-feedback`

## Request

- Base URL: `https://api.rapidata.ai`
- URL: `https://api.rapidata.ai/job/task-feedback`
- Auth: OpenID Connect (`https://auth.rapidata.ai/.well-known/openid-configuration`, scopes: `job:task-feedback`)

Send a few sample datapoints once per setup, not the whole dataset. Returns 429 past the organization's hourly limit and 503 when the review is unavailable; go ahead without feedback then.

## Request body

- ReviewTaskSetupEndpointInput: A task setup as it would be sent to create a job definition.
  - `taskType` 'classify' | 'compare' | 'locate' | 'draw' | 'selectWords' | 'freeText' | 'ranking', required: The type of task the job definition creates.
  - `instruction` string, required: The question the annotators answer.
  - `answerOptions` string[], nullable: The answer options; classify tasks only.
  - `datapoints` ReviewTaskSetupEndpointInputDatapoint[], required: One to ten sample datapoints, not the whole dataset, each with assets (public URLs or asset file names; exactly 2 for compare, 2 or more for ranking) or a text, and an optional context.
    - `assets` string[], nullable
    - `text` string, nullable
    - `context` string, nullable

## Response `200`

OK

- ReviewTaskSetupEndpointOutput: Feedback on a task setup.
  - `passes` boolean, required: True when no finding was raised.
  - `findings` ReviewTaskSetupEndpointOutputFinding[], required: The design problems found, most likely first.
    - `kind` 'severalThings' | 'expertKnowledge' | 'unclear' | 'untranslatable' | 'contextOffTopic' | 'tooSlowToAnswer' | 'positionReference', required
    - `probability` number, double, required
    - `message` string, required
    - `datapointIndex` integer, nullable

## Other responses

- `400`: Bad Request
- `401`: Unauthenticated
- `403`: Forbidden
- `429`: Too Many Requests
- `503`: Service Unavailable

## Changes

- **2026-11-17** `8505bf8ce59d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/rapidata/apis/rapidata-api/changes/job/task-feedback/post.md)

---

[API](https://skmtc.dev/rapidata/apis/rapidata-api.md) - [All operations](https://skmtc.dev/rapidata/apis/rapidata-api/llms.txt) - [OpenAPI document](https://skmtc.dev/rapidata/apis/rapidata-api/revisions/dd09bb9f2be8?raw)
