The pages.sr.ht API is a convenience wrapper around the GraphQL API and
allows one to easily publish a site with tools like curl
.
The following endpoints are available to users with an OAuth2 token valid for the specified scope.
Scopes: PAGES:RW
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. /publish/example.org/subdir
)
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 b345d3de11bc0e7dbf344de75c30cf7e3620fa7b Author: Conrad Hoffmann <ch@bitfehler.net> Date: 2022-05-12T10:04:02+02:00 Add link to package installation instructions Besides being a bit more convenient, it also adds a little emphasis to this specific bullet point :)