Skip to content

Status

Job completion notification

Notify humans or systems about completed jobs automatically. Such notifications can be sent as an Email or HTTP POST request.

E-mail notifications

To receive an e-mail on Job completion, set notify parameter to:

"notify": "mailto:<email_address>"

For example:

{
    "tasks": [...],
    "notify": "mailto:user@example.com"
}

That Email will contain Job completion status, JobID and Job URL and will be sent to user@example.com.

HTTP POST request notification

By specifying a valid HTTP(S) URL, you can receive a POST request containing following JSON string:

{
    "job_id": "<job_id>",
    "job_url": "<job_url>",
    "status": "<status>"
}

For example:

{
    "tasks": [...],
    "notify": "https://example.com/api/job_callback"
}

HTTP POST with Digest Authentication request notification

By specifying a valid HTTPS URL prefixed with the word "digest:", you can receive a POST request containg following JSON string:

{
    "job_id": "<job_id>",
    "job_url": "<job_url>",
    "status": "<status>"
}

For example:

{
    "tasks": [...],
    "notify": "digest:https://user:password@example.com/api/job_callback"
}