Skip to content
Survey Coder Pro Survey Coder Pro

ALREADY_CODING — Question is mid-coding

Summary

Section titled “Summary”

The question already has a coding job in flight. Survey Coder Pro serializes coding per-question to avoid race conditions on the same response set.

HTTP status

Section titled “HTTP status”

409 Conflict. Standard envelope.

Example response

Section titled “Example response”
{
  "success": false,
  "error": {
    "code": "ALREADY_CODING",
    "message": "Question q_01HXJZK... is already being coded by job job_01HXJZK....",
    "request_id": "req_01HXJZK4ABCDEF",
    "doc_url": "https://docs.surveycoder.io/errors/already-coding"
  }
}

Why this happens

Section titled “Why this happens”
  • A previous async coding job is still running.
  • A retry kicked off before the original POST /v1/code completed (and our idempotency cache missed it).
  • Two team members triggered coding from the dashboard at the same time.

How to fix it

Section titled “How to fix it”
  1. The error message includes the running job_id. Poll GET /v1/jobs/{id} until it finishes.
  2. Wait for status: completed or failed, then retry your request.
  3. Use idempotency keys on coding requests so genuine retries don’t trigger this.
  4. If the running job is stuck (older than 30 minutes with no progress), cancel it with DELETE /v1/jobs/{id} and start fresh.
Section titled “Related”