API reference

Everything the app does, you can do from the API with a bearer key — the same endpoints, the same behavior.

Authentication

Create a key in Settings → API keys (it's shown once). Send it as a bearer token on every request:

curl https://layoutlock-api.velniq.ai/v1/me \
  -H "Authorization: Bearer llk_your_key_here"

Quickstart

Upload a file, start a job, poll until it's done, and download the translated file:

# 1. Create a key in Settings -> API keys, then:
export KEY="llk_your_key_here"
export API="https://layoutlock-api.velniq.ai"

# 2. Register an upload (returns a fileId + a presigned PUT url)
UP=$(curl -s -X POST "$API/v1/uploads" -H "Authorization: Bearer $KEY" \
  -H "content-type: application/json" \
  -d '{"filename":"report.xlsx","bytes":'$(wc -c < report.xlsx)'}')
FILE_ID=$(echo "$UP" | jq -r .fileId)
PUT_URL=$(echo "$UP" | jq -r .uploadUrl)

# 3. Upload the bytes, then confirm
curl -s -X PUT "$PUT_URL" --data-binary @report.xlsx
curl -s -X POST "$API/v1/uploads/$FILE_ID/confirm" -H "Authorization: Bearer $KEY"

# 4. Start a translation into English
JOB=$(curl -s -X POST "$API/v1/jobs" -H "Authorization: Bearer $KEY" \
  -H "content-type: application/json" -d '{"fileId":"'$FILE_ID'","tgt":"en"}')
JOB_ID=$(echo "$JOB" | jq -r .jobId)

# 5. Poll until done, then download the translated file
while [ "$(curl -s "$API/v1/jobs/$JOB_ID" -H "Authorization: Bearer $KEY" | jq -r .status)" != "done" ]; do
  sleep 2
done
curl -s "$API/v1/jobs/$JOB_ID/download" -H "Authorization: Bearer $KEY" -o report.en.xlsx

Endpoints