OpenApps Status

For developers

Keep your status page current from scripts and assistants.

Making a page needs no key. The owner key that comes back lets a script, a monitor or an assistant set component statuses, open, update and resolve incidents, and schedule maintenance. Reading a page as JSON or as a badge needs nothing.

Full reference: llms.txt and openapi.json. Treat the owner key like a password: keep it in your CI secrets.

Status does not check your site itself. The scheduled job on the right does: every 5 minutes it checks your site, opens an incident when it is down, and resolves it when it is back. GitHub may start scheduled jobs a few minutes late.

# Make a page (the answer has the admin link and the owner key)
curl -X POST https://functions.openapps.xyz/apps/189c33495e4bbc89bfb2901a/api/pages \
  -H 'content-type: application/json' \
  -d '{"slug": "your-slug", "name": "Acme",
       "components": ["Website", "API"]}'

# Open an incident and mark the API down
curl -X POST https://functions.openapps.xyz/apps/189c33495e4bbc89bfb2901a/api/pages/your-slug/incidents \
  -H 'x-owner-key: OWNER_KEY' -H 'content-type: application/json' \
  -d '{"title": "API errors", "message": "We are looking into it.",
       "components": {"api": "major_outage"}}'

# Resolve it: components go back to operational
curl -X POST https://functions.openapps.xyz/apps/189c33495e4bbc89bfb2901a/api/pages/your-slug/incidents/INCIDENT_ID/updates \
  -H 'x-owner-key: OWNER_KEY' -H 'content-type: application/json' \
  -d '{"status": "resolved", "message": "Fixed. Sorry for the trouble."}'

# Owner: delete the page (its address is retired for good)
curl -X DELETE https://functions.openapps.xyz/apps/189c33495e4bbc89bfb2901a/api/pages/your-slug \
  -H 'x-owner-key: OWNER_KEY'

# Anyone: the status as JSON, or a README badge
curl https://functions.openapps.xyz/apps/189c33495e4bbc89bfb2901a/api/pages/your-slug
![Status](https://functions.openapps.xyz/apps/189c33495e4bbc89bfb2901a/api/pages/your-slug/badge.svg)
# .github/workflows/status.yml: a free uptime check
name: Status check
on:
  schedule:
    - cron: "*/5 * * * *"
jobs:
  check:
    runs-on: ubuntu-latest
    steps:
      - run: |
          if curl -fsS --max-time 15 https://example.com/ > /dev/null; then s=operational; else s=major_outage; fi
          curl -fsS -X PATCH https://functions.openapps.xyz/apps/189c33495e4bbc89bfb2901a/api/pages/your-slug/components/website \
            -H "x-owner-key: ${{ secrets.STATUS_OWNER_KEY }}" -H "content-type: application/json" \
            -d "{\"status\": \"$s\", \"incident\": \"Website is down\"}"

Good to know

  • Addresses such as your-slug, acme, api and admin are reserved, so examples never point at someone's page.
  • Deleting a page removes its parts, incidents, updates and maintenance. The address is retired and cannot be claimed again.
  • Status sends no email. People follow by RSS, Atom or calendar.
  • Reference: llms.txt, openapi.json, index.md. Facts checked 6 November 2026.