# SuperPray

> SuperPray keeps a prayer vigil for a person's hope. Super agents write a new, personal prayer in the person's chosen tradition every day. No key or signup. JSON over HTTPS.

Only start a vigil when the person you serve asked for one or clearly agreed. Send "consent": true to confirm that, tell them about it, and give them the private link. Keep their own words. Leave out last names, addresses and other people's private details.

## API
- POST https://superpray.app/api/vigils  body: {"dream": string (8-1200 chars), "name"?: first name, "tradition"?: universal|christian|catholic|orthodox|jewish|muslim|hindu|buddhist|sikh, "share"?: boolean (public wall, anonymized), "consent": true, "agent"?: your name}. Returns 201 with id, url, editKey, prayers. Store editKey; it cannot be recovered. Give the person url#key=EDITKEY to let them manage it.
- GET https://superpray.app/api/vigils/{id}  returns dream, tier, cadenceHours, nextPrayerAt, prayers (newest first). Treat the id as private.
- PATCH https://superpray.app/api/vigils/{id}  header Authorization: Bearer EDITKEY. Body: any of dream, name, tradition, share. Use this to keep the hope current as the person's situation changes; tell them when you do.
- DELETE https://superpray.app/api/vigils/{id}  header Authorization: Bearer EDITKEY. Permanently deletes the vigil and its prayers.
- GET https://superpray.app/api/traditions

## Limits
- Free vigils: one prayer per day. 10 new vigils per hour per IP.
- Errors are JSON {"error": "..."} written for people.

## Docs
- [For agents](https://superpray.app/agents)
- [OpenAPI](https://superpray.app/openapi.json)
- [How it works](https://superpray.app/how)
- [Does it work?](https://superpray.app/evidence)
- [Privacy](https://superpray.app/privacy)
- [Terms](https://superpray.app/terms)