Update Task Term

Modify a single scanned term on a task. Typical use: adjust AI mis-classifications (category / translations / judgment) before calling /tasks/confirm-terms on a task created with auto_apply_terms=false.

Endpoint

POST {BASE_URL}/api/open/v1/tasks/terms/update

Authentication Headers

Identical to Create Translation Task.

Body

Param	Type	Required	Description
task_id	string	Yes	Target task ID
id	string	Yes	Term entry ID (from items[].id of /tasks/terms)
term	string	No	New term text
category	string	No	New category (e.g. Character / Item / Attributes / ...)
judgment	string	No	AI judgment (may be replaced with a manual note)
glossary_score	number	No	Importance score 0–10
translations	object	No	Partial update. Keys are language codes (hyphen format such as en / zh-cn); values are translations. Only languages you want to overwrite need to be present; empty string clears that language's translation

At least one optional field should be supplied, otherwise the call is a no-op.

Response

Success (HTTP 200) — returns the full updated row:

{
  "success": true,
  "code": 0,
  "msg": "ok",
  "trace_id": "...",
  "data": {
    "id": "6626f0a32e8e5d24b6c9f1a2",
    "term": "战斗力",
    "content": "总战斗力的构成...",
    "source_language": "zh-cn",
    "category": "Attributes",
    "glossary_score": 5,
    "judgment": "...",
    "translation_source": "ai",
    "translations": {
      "en": "Combat Power",
      "ja": "戦闘力"
    },
    "updated_at": "2026-04-22T11:30:00.000Z"
  }
}

Error Codes

code	Description
400	Missing task_id / id; glossary_score not numeric; translations not an object; unsupported language code
401	Signature invalid
403	Task does not belong to this App Key
404	Term not found on this task
409	Task has no TB_SCAN job (possibly created with scan_terms=false)
500	Internal error

Example

APP_KEY="5685414646a54423c891d87194d87f3f"
APP_SECRET="<your App Secret>"
BASE_URL="https://api.loxily.com"

TIMESTAMP=$(date +%s)
BODY='{"task_id":"68a12cb7e1f9a88b4ea23c77","id":"6626f0a32e8e5d24b6c9f1a2","category":"Attributes","translations":{"en":"Combat Power"}}'
SIGN=$(printf '%s' "${TIMESTAMP}${BODY}${APP_SECRET}" | md5)

curl -s -X POST "${BASE_URL}/api/open/v1/tasks/terms/update" \
  -H "Content-Type: application/json" \
  -H "X-Loxily-AppKey: ${APP_KEY}" \
  -H "X-Loxily-Timestamp: ${TIMESTAMP}" \
  -H "X-Loxily-Sign: ${SIGN}" \
  --data "${BODY}"