Skip to content

Delete Task Term

Remove a single scanned term from a task. Typical use: drop AI mis-classified rows before /tasks/confirm-terms on a task created with auto_apply_terms=false.

Endpoint

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

Authentication Headers

Identical to Create Translation Task.

Body

ParamTypeRequiredDescription
task_idstringYesTarget task ID
idstringYesTerm entry ID (from items[].id of /tasks/terms)

Response

Success (HTTP 200):

json
{
  "success": true,
  "code": 0,
  "msg": "ok",
  "trace_id": "...",
  "data": { "id": "6626f0a32e8e5d24b6c9f1a2", "deleted": true }
}

Error Codes

codeDescription
400Missing task_id / id
401Signature invalid
403Task does not belong to this App Key
404Term not found on this task
409Task has no TB_SCAN job (possibly created with scan_terms=false)
500Internal error

Example

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

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

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