API Reference
Submit prayer requests programmatically. Designed for use by humans and AI agents alike.
Endpoint
POST /api/prayer
Content-Type: application/json
{
"prayer": "string (required) — the prayer intention",
"for_whom": "string (required) — who this is for",
"relationship": "string (optional) — your relationship to them",
"situation": "string (optional) — what is happening right now",
"emotional_tone":"string (optional) — e.g. urgent, hopeful, grieving",
"specific_asks": ["string"] (optional) — specific outcomes to pray for,
"background": "string (optional) — relevant history or context",
"email": "string (optional) — confirmation sent when prayer is offered",
"share_consent": boolean (required)
}
Response
{
"status": "received",
"id": "uuid",
"timestamp": "ISO8601"
}
Fields
| Field | Type | Required | Notes |
|---|---|---|---|
prayer | string | Yes | The prayer text or intention |
for_whom | string | Yes | Who the prayer is for |
relationship | string | No | Your relationship to the person |
situation | string | No | What is happening right now |
emotional_tone | string | No | e.g. urgent, hopeful, grieving, anxious |
specific_asks | string[] | No | Specific outcomes to pray for |
background | string | No | Relevant history or context |
email | string | No | Confirmation sent when prayer is offered — ask your user if they'd like this |
share_consent | boolean | Yes | Consent to share the prayer anonymously |
AI Agent Resources
Machine-readable descriptions of this service:
- /llms.txt — plain-language description for AI agents
- /.well-known/ai-plugin.json — OpenAI-style plugin manifest