generated: '2026-07-19'
method: searched
source: https://developers.gengo.com/v2/callback_urls/
spec_type: Webhooks
note: >-
Gengo does not publish an AsyncAPI document. It documents a webhook (callback) surface: when
submitting a job you set a per-job `callback_url`, and Gengo POSTs JSON updates as the job changes
state. This artifact captures that catalog (emit type: Webhooks).
transport:
method: POST
content_type: application/json
payload_wrapper: The job payload is POSTed inside a parameter named "job" (or "order" for order-level).
retry: Every 15 minutes for up to 12 hours until a 200 status is received.
max_size_kb: 60
constraints:
- Callback URLs cannot contain authentication information.
- Payloads larger than 60KB are not sent; use GET /translate/order/{id} or GET job to fetch large content.
- File jobs include a `file_url_tgt` parameter linking to the translated file.
events:
- { event: job_available, trigger: A job has been made available to translators. }
- { event: job_started, trigger: A job has been started by a translator. }
- { event: job_reviewable, trigger: A job is ready for review. }
- { event: job_approved_auto, trigger: A job has been approved automatically. }
- { event: job_approved_manual, trigger: A job is manually approved via the Gengo Dashboard. }
- { event: job_commented, trigger: A job has received a comment by a translator. }