Reminder Config Repository
API Contract
REST
/api/v1/reminder-configs
6 endpoints
GET
/api/v1/reminder-configs/api/v1/reminder-configs
List reminder configs for all organisations
Public
Response Example
{
"data": [
{
"org_id": "org_03",
"org_name": "Oslo Volunteer Hub",
"reminder_days": 14,
"escalation_days": 21,
"updated_at": "2026-02-01T12:00:00Z"
}
],
"pagination": {
"page": 1,
"limit": 20,
"total": 8
}
}
GET
/api/v1/reminder-configs/api/v1/reminder-configs/:org_id
Get reminder configuration for a specific organisation
Public
Response Example
{
"org_id": "org_03",
"org_name": "Oslo Volunteer Hub",
"reminder_days": 14,
"escalation_days": 21,
"cron_schedule": "0 8 * * *",
"updated_at": "2026-02-01T12:00:00Z"
}
POST
/api/v1/reminder-configs/api/v1/reminder-configs
Create a reminder config for a new organisation
Public
Request Example
{
"org_id": "org_09",
"reminder_days": 10,
"escalation_days": 18
}
Response Example
{
"org_id": "org_09",
"reminder_days": 10,
"escalation_days": 18,
"created_at": "2026-03-26T10:00:00Z"
}
PUT
/api/v1/reminder-configs/api/v1/reminder-configs/:org_id
Update reminder thresholds for an organisation
Public
Request Example
{
"reminder_days": 7,
"escalation_days": 14
}
Response Example
{
"org_id": "org_03",
"reminder_days": 7,
"escalation_days": 14,
"updated_at": "2026-03-26T10:10:00Z"
}
DELETE
/api/v1/reminder-configs/api/v1/reminder-configs/:org_id
Delete a reminder config (reverts to system default)
Public
Response Example
{
"deleted": true,
"org_id": "org_09"
}
GET
/api/v1/reminder-configs/api/v1/reminder-configs/default
Get the system default reminder configuration
Public
Response Example
{
"reminder_days": 14,
"escalation_days": 21,
"source": "system_default"
}