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 
# .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.