The pages.sr.ht API is a convenience wrapper around the GraphQL API and
allows one to easily publish a site with tools like
The following endpoints are available to users with an OAuth2 token valid for the specified scope.
Publish a site.
The request body must use the
multipart/form-data content type. The following
fields are supported:
content(required): a .tar.gz file containing the new site content.
protocol: select which protocol variant of the site to update. If unset, defaults to HTTPS.
A sub-directory can be appended to the URL (e.g.
in which case only the specified sub-directory is updated. The rest of the
files are left unchanged.
The response contains the new site version as plain-text.
commit 5e3b25c91b85507d152f17800921ae9179516247 Author: Vlad-Stefan Harbuz <firstname.lastname@example.org> Date: 2022-11-14T09:16:47+00:00 hacking: add examples for clarity Signed-off-by: Vlad-Stefan Harbuz <email@example.com>