Report whether an answer worked

POST https://api.noptcha.com/v1/tasks/{id}/feedback

Native API (v1). Guide. Operation ID sendTaskFeedback.

Tells us whether a solved task's answer was accepted by the target site. Accepted for solved tasks within 10 minutes after completion; only the first report per task counts, later ones still return 200. Feedback is recorded as a quality signal; it does not refund the task. A task that is not solved (processing or failed) is 409 task_not_solved. reason is optional and is not stored.

Request

Authentication: Authorization: Bearer <key> (Keys).

Parameter	In	Description
`id` required	path	Task ID (decimal digits; the same number as the compatibility API's `taskId`). string · pattern: ^[0-9]{1,16}$ · e.g. 7259140378796032

Body (application/json, required):

Field	Type	Description
`correct` required	`boolean`	Whether the answer was accepted by the target site.
`reason` optional	`string`	Optional free text; not stored.

Responses

200

Recorded.

Headers: Noptcha-Request-Id.

Content: application/json

Field	Type	Description
`accepted` required	`const true`
`id` required	`string`	pattern: ^[0-9]+$

400

invalid_request: the body is not valid JSON or misses a field, a parameter is wrong, callback_url is not a string, the result would be too large (usage). unsupported_type: the task type does not exist or is not available.

Headers: Noptcha-Request-Id, RateLimit (optional), RateLimit-Policy (optional).

Content: application/problem+json

Field	Type	Description
`code` required	`string`	Machine-readable error code (see the table).
`detail` optional	`string`	Human-readable explanation of this occurrence.
`request_id` required	`string`	Same as the `Noptcha-Request-Id` header.
`status` required	`integer`	The HTTP status code.
`title` required	`string`
`type` required	`string`	format: uri

401

unauthorized: the key is malformed, unknown, revoked or expired.

Headers: Noptcha-Request-Id, RateLimit (optional), RateLimit-Policy (optional).

Content: application/problem+json

Field	Type	Description
`code` required	`string`	Machine-readable error code (see the table).
`detail` optional	`string`	Human-readable explanation of this occurrence.
`request_id` required	`string`	Same as the `Noptcha-Request-Id` header.
`status` required	`integer`	The HTTP status code.
`title` required	`string`
`type` required	`string`	format: uri

403

forbidden: the key lacks the scope this endpoint needs, the client IP is not in the key's allowlist, the key may not use this task type, or the organization is suspended (detail says which). Also returned, without detail, when the request did not pass through our edge network.

Headers: Noptcha-Request-Id, RateLimit (optional), RateLimit-Policy (optional).

Content: application/problem+json

Field	Type	Description
`code` required	`string`	Machine-readable error code (see the table).
`detail` optional	`string`	Human-readable explanation of this occurrence.
`request_id` required	`string`	Same as the `Noptcha-Request-Id` header.
`status` required	`integer`	The HTTP status code.
`title` required	`string`
`type` required	`string`	format: uri

404

not_found: no such task, it expired (results are kept 10 minutes after completion) or it belongs to another organization; or the task created with this Idempotency-Key has expired.

Headers: Noptcha-Request-Id, RateLimit (optional), RateLimit-Policy (optional).

Content: application/problem+json

Field	Type	Description
`code` required	`string`	Machine-readable error code (see the table).
`detail` optional	`string`	Human-readable explanation of this occurrence.
`request_id` required	`string`	Same as the `Noptcha-Request-Id` header.
`status` required	`integer`	The HTTP status code.
`title` required	`string`
`type` required	`string`	format: uri

409

idempotency_conflict: the Idempotency-Key was used with a different body, or the first request with it is still being processed (retry shortly). task_not_solved: feedback for a task that is not solved (still processing, or failed).

Headers: Noptcha-Request-Id, RateLimit (optional), RateLimit-Policy (optional).

Content: application/problem+json

Field	Type	Description
`code` required	`string`	Machine-readable error code (see the table).
`detail` optional	`string`	Human-readable explanation of this occurrence.
`request_id` required	`string`	Same as the `Noptcha-Request-Id` header.
`status` required	`integer`	The HTTP status code.
`title` required	`string`
`type` required	`string`	format: uri

413

request_too_large: the body exceeds the limit (1 MB for image types, 64 KB otherwise). Any request with a body over 1 MB gets this, GET requests included.

Headers: Noptcha-Request-Id, RateLimit (optional), RateLimit-Policy (optional).

Content: application/problem+json

Field	Type	Description
`code` required	`string`	Machine-readable error code (see the table).
`detail` optional	`string`	Human-readable explanation of this occurrence.
`request_id` required	`string`	Same as the `Noptcha-Request-Id` header.
`status` required	`integer`	The HTTP status code.
`title` required	`string`
`type` required	`string`	format: uri

429

rate_limited: too many tasks created per second by this key, the same task polled too often, the sandbox's per-organization rate, usage queried too often, the catalog fetched too often from this IP, or this IP sent too many invalid keys. concurrency_limited: the organization has too many tasks in flight for this captcha family (or, with a test key, too many sandbox tasks still processing). Wait Retry-After seconds.

Headers: Noptcha-Request-Id, RateLimit (optional), RateLimit-Policy (optional), Retry-After.

Content: application/problem+json

Field	Type	Description
`code` required	`string`	Machine-readable error code (see the table).
`detail` optional	`string`	Human-readable explanation of this occurrence.
`request_id` required	`string`	Same as the `Noptcha-Request-Id` header.
`status` required	`integer`	The HTTP status code.
`title` required	`string`
`type` required	`string`	format: uri

500

internal: an error on our side.

Headers: Noptcha-Request-Id, RateLimit (optional), RateLimit-Policy (optional).

Content: application/problem+json

Field	Type	Description
`code` required	`string`	Machine-readable error code (see the table).
`detail` optional	`string`	Human-readable explanation of this occurrence.
`request_id` required	`string`	Same as the `Noptcha-Request-Id` header.
`status` required	`integer`	The HTTP status code.
`title` required	`string`
`type` required	`string`	format: uri

503

service_unavailable: no capacity right now (all solvers busy or failing, the gateway is overloaded, a dependency is unavailable). For POST /v1/tasks nothing was created or charged. Wait Retry-After.

Headers: Noptcha-Request-Id, RateLimit (optional), RateLimit-Policy (optional), Retry-After.

Content: application/problem+json

Field	Type	Description
`code` required	`string`	Machine-readable error code (see the table).
`detail` optional	`string`	Human-readable explanation of this occurrence.
`request_id` required	`string`	Same as the `Noptcha-Request-Id` header.
`status` required	`integer`	The HTTP status code.
`title` required	`string`
`type` required	`string`	format: uri

Header descriptions and every schema: Schemas. Machine-readable: openapi.json, openapi.yaml.