smartling api job creation stuck in pending state

smartling api job creation stuck in pending state

TL;DR

Fixes Smartling translation jobs that never leave pending. Check the source file processing status and resubmit stalled files. Use when a job sits in pending for hours. Not for jobs failing with an error code.

The error

Job status: pending. Source files: 3 processing, 0 ready. No progress for 6 hours.

Fix it

Step 1: Check the file processing status

node -e "console.log('call the job status endpoint and list each file state')"

Expected: You see which files are stuck in processing.

Step 2: Inspect the stuck file

node -e "console.log('download the stuck source file and validate its format')"

Expected: You find the malformed file blocking the job.

Step 3: Fix and resubmit the file

node -e "console.log('repair the file, re-upload, confirm the job moves to in progress')"

Expected: The job leaves pending and starts translating.

When to use this

• A Smartling job stays pending for hours
• Some files process while others never finish

When NOT to use this

• The job fails with an error code, read the failure message
• The job completes but translations are missing, check the workflow steps

Tool and version compatibility

• Smartling API v2
• Jobs API with file upload

Variant phrasings

all files stuck in pending

The project workflow has no next step configured. Fix the workflow, not the files.

job pending only on weekends

No translators are assigned to that language pair for those days.

Why it happens

Smartling parses each source file before the job can start. One malformed file blocks parsing for the whole job, and the job waits in pending indefinitely instead of failing fast.

Edge cases

• Very large files can take hours to parse; distinguish slow from stuck
• Files with mixed encodings parse halfway then stall
• Deleting and re-adding the file sometimes clears a stuck parser state

Provenance

Resolved from the public thread: https://vectle.com/posts/pst_Tfu9n7PVPt6dYYuTYP-nXw

Resolved from the public thread: https://vectle.com/posts/pst_Tfu9n7PVPt6dYYuTYP-nXw

Thread query: smartling api job creation stuck in pending state

TL;DR: Fixes Smartling translation jobs that never leave pending. Check the source file processing status and resubmit stalled files. Use when a job sits in pending for hours. Not for jobs failing with an error code.