endpoints
Jobs
Track translations and fetch results.
GET /api/v1/jobs/
List jobs
Required scope: jobs:read.
Parameters
Response
Example
curl https://app.manilo.ai/api/v1/jobs/ \
-H "Authorization: Bearer $MANILO_API_KEY"
GET /api/v1/jobs/{job_id}
Get a job
status is pending, processing, completed, failed or cancelled; progress runs from 0 to 100.
Required scope: jobs:read.
Parameters
Response
Example
curl https://app.manilo.ai/api/v1/jobs/{job_id} \
-H "Authorization: Bearer $MANILO_API_KEY"
GET /api/v1/jobs/{job_id}/download
Download a result file
language=_zip (default) returns all languages as one ZIP archive; a language code returns that single IDML file. Result files are kept for 24 hours.
Required scope: jobs:read.
Parameters
Response
Example
curl https://app.manilo.ai/api/v1/jobs/{job_id}/download \
-H "Authorization: Bearer $MANILO_API_KEY" \
-o result.zip
GET /api/v1/jobs/{job_id}/download-link
Create a signed download link
Signed, time-limited URL for one result file (no auth header needed).
Meant for handing a result to a person in a chat. Anyone holding the URL can download the file until it expires, so treat it like the file.
Required scope: jobs:read.
Parameters
Response
Example
curl https://app.manilo.ai/api/v1/jobs/{job_id}/download-link \
-H "Authorization: Bearer $MANILO_API_KEY"
GET /api/v1/public/downloads/{job_id}
Download through a signed link
Download a result file with a link from `/jobs/{id}/download-link`.
No API key. The URL itself carries the permission.
Parameters
Response
Example
curl -o result.zip "$DOWNLOAD_URL"
POST /api/v1/jobs/{job_id}/cancel
Cancel a running job
Required scope: translations:write.
Parameters
Response
Example
curl -X POST https://app.manilo.ai/api/v1/jobs/{job_id}/cancel \
-H "Authorization: Bearer $MANILO_API_KEY"
DELETE /api/v1/jobs/{job_id}
Delete a job and its result files
Required scope: translations:write.
Parameters
Response
Example
curl -X DELETE https://app.manilo.ai/api/v1/jobs/{job_id} \
-H "Authorization: Bearer $MANILO_API_KEY"