Add webhook to "manually" start a plan

[zaggash]

Describe the solution you'd like
Rather than starting a plan out of a cron, would be nice to trigger it from an API endpoint as a webhook.
This would allow other apps to trigger the backup when this other process is ending.

Additional context
I'm thinking of backing up immich when the Postgres backup is done and moved to the upload folder.
My DB backup script can curl the webhook to trigger the backrest plan.

[zaggash]

Not exactly the same as #143 because here it would involve external services/scripts.

IIUC #143 is talking about plans order

[garethgeorge]

Hmm, I don't think backrest has a stable enough public API as of yet to expose anything explicit / make any promises on the API contract (and there are likely major refactors coming as I work towards multi-host management and am generally cleaning up tech debt). The workaround for this use case would be using restic directly and using the "Index Snapshots" button in the backrest UI to load your recent backup runs (but you lose out on Backrest's automatic prunes / notifications in that case).

If you do want to code something to Backrest's API it's specified in the Backrest service https://github.com/garethgeorge/backrest/blob/main/proto/v1/service.proto#L32-L33 and you're welcome to codegen a library using connectrpc to call backrest's endpoints https://connectrpc.com/. You can see how the webui initializes it's transport here https://github.com/garethgeorge/backrest/blob/main/webui/src/api.ts#L1.

[asitemade4u]

I am also interested in the feature

[asitemade4u]

BTW, at one point @garethgeorge , you mentioned the Index Snapshots. Where can I find it?

[garethgeorge]

An Index Snapshots button is at the top of the repo overview e.g. on my install --

[garethgeorge]

Documented workaround at #275 .