Skip to main content

Runtime Service

Source: services/runtime/DOCS.md

Purpose: deploy repository archives, execute webhook handlers, and broker plugin runtime calls.

Public base: https://<org>.w7s.cloud/*

Key endpoints:

  • POST /_deploy or POST /<repo>/_deploy
  • POST /_invoke
  • GET /<repo>/_account/* (proxy to account service)
  • POST /<repo>/_db/* (DB control proxy)

Auth:

  • Deploy requires Authorization: Bearer <github-token> and GitHub metadata headers.
  • Runtime webhooks can be auth: none or auth: jwt based on w7s.json.

Example deploy:

curl -X POST "https://<org>.w7s.cloud/<repo>/_deploy?artifact=source" \
  -H "Authorization: Bearer $GITHUB_TOKEN" \
  -H "x-github-repository: <org>/<repo>" \
  -H "x-github-sha: <sha>" \
  -H "x-github-branch: <branch>" \
  -H "content-type: application/zip" \
  --data-binary "@repo.zip"

Notes:

  • If frontend/dist exists, the runtime can publish static assets.
  • Custom domains are declared in backend/CNAME and frontend/CNAME.