Table of Contents

  1. email
  2. webhook
  3. others?

At the end of a job or a job group, you can execute triggers based on the outcome of the job.

triggers:
  - action: trigger type
    condition: when to execute this trigger
    ...action-specific configuration...

Condition may be one of the following:

  • always: execute the trigger after every build
  • failure: execute the trigger after a failed build
  • success: execute the trigger after a successful build

The following actions are available:

email

Sends an email summarizing the build results.

Configuration

  • to: The value of the "To" header in the outgoing email, e.g. your email address or e.g. Jim Jimson <jim@example.org>, Bob Bobson <bob@example.org>. Required.
  • cc: The value of the "Cc" header in the outgoing email. Optional.
  • in_reply_to: The value of the "In-Reply-To" header in the outgoing email. Optional.

webhook

Submits the final job status as a POST request to a specified URL.

Configuration

  • url: The URL to submit the HTTP request to

The JSON payload POSTed to the provided URL looks something like this:

{
  "id": integer,
  "status": string,
  "setup_log": url,
  "note": string or null,
  "runner": string or null,
  "owner": {
    "canonical_name": "~example",
    "name": "example"
  },
  "tasks": [
    {
      "name": string,
      "status": string,
      "log": url
    },
    ...
  ]
}

others?

Patches welcome!

About this wiki

commit 0b2cece8723735483503b97574b18741d0710998
Author: fardog <nat@fardog.io>
Date:   2026-01-07T20:47:09Z

terms: fix language around content deletion

This supersedes [#66048][], as I named the incorrect project name in the
subject, which caused the build to fail. Original email is quoted below:

[#66048]: https://lists.sr.ht/~sircmpwn/sr.ht-dev/patches/66048

A very small typo I noted in the terms of service; alternatively it
could be corrected as "will not [be] displayed", but either one reads
fine to me. No worries if the terms need more ceremony to be changed;
was as easy to submit as a patch as it would've been to raise in the
mailing list.
Clone this wiki ("master" branch)
https://git.sr.ht/~sircmpwn/sr.ht-docs (read-only)
git@git.sr.ht:~sircmpwn/sr.ht-docs (read/write)