Skip to content

Bulk Delete Terms

Delete project-termbase entries by id. Up to 100 per call; sync response.

Endpoint

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

Authentication Headers

Same as Create Translation Task.

Body

ParamTypeRequiredDescription
idsstring[]YesTerm IDs, up to 100

Response

json
{
  "success": true,
  "code": 0,
  "msg": "ok",
  "trace_id": "...",
  "data": {
    "requested_count": 3,
    "deleted_count": 2,
    "invalid_ids": ["not-an-oid"],
    "not_found_ids": ["a0000000000000000000000b"]
  }
}
  • requested_count: total IDs you sent
  • deleted_count: rows actually removed
  • invalid_ids: IDs with an invalid format
  • not_found_ids: well-formed IDs that don't exist in the caller's project

A vector-sync delete is queued for each removed record (non-blocking).

Error Codes

codeDescription
400ids empty / > 100 / any non-string element
401Signature invalid / timestamp expired
404appKey unknown
500Internal error

Example

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

TIMESTAMP=$(date +%s)
BODY='{"ids":["69e9b99c04e32e3f20afbbdb","69e9b99c04e32e3f20afbbda"]}'
SIGN=$(printf '%s' "${TIMESTAMP}${BODY}${APP_SECRET}" | md5)

curl -s -X POST "${BASE_URL}/api/open/v1/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}"