> ## Documentation Index > Fetch the complete documentation index at: https://docs.thefaithapp.com/llms.txt > Use this file to discover all available pages before exploring further. # Update Pastoral Care Preferences > Updates one or more member-controlled consent and contact settings. Reminder and Care Radar consent are disabled by default. Disabling a consent also closes related pending follow-up signals. ## OpenAPI ````yaml /api-reference/openapi.json put /v1/care-life-moments/preferences openapi: 3.1.0 info: title: TheFaithApp Partner API version: 1.0.0 description: >- The v1 API for third-party apps that sign in TheFaithApp members and access church-scoped content and workflows. contact: name: TheFaithApp Support email: support@thefaithapp.com servers: - url: https://api.thefaithapp.com description: Production security: - apiKeyAuth: [] bearerAuth: [] tags: - name: Hosted Auth description: Sign members in through the hosted TheFaithApp authentication flow. - name: Core Experience description: Load member context and the personalized home experience. - name: Content description: >- Read sermons, media, YouTube videos, devotionals, and streaming configuration. - name: Engagement description: Manage member favorites and devotional bookmarks. - name: Churches description: Read church profiles, public directory records, and branch information. - name: Events & Volunteers description: >- Browse events and volunteer opportunities, then manage registrations and commitments. - name: Notifications & Bulletins description: Read church and member notifications and published bulletins. - name: Prayer description: Submit a prayer request for the authenticated member. - name: Pastoral Care description: >- Manage the authenticated member’s confidential care requests, consent-based follow-up preferences, private life moments, and quiet days. - name: Member Connections description: Manage the member’s campus and ministry connections. - name: Community Groups description: >- Discover groups and manage membership, feeds, attendance, study guides, and leader notes. - name: Community Preferences & Research description: >- Manage community preferences, summaries, and consent-based research participation. - name: Resource Sharing description: Offer shared resources and manage member loan requests and transitions. - name: Mutual Aid description: >- Manage needs and offers, private responses, safety reports, and member activity. - name: Analytics description: Record product analytics events and retrieve aggregate metrics. - name: Notification Analytics description: Record and summarize notification delivery, open, and click events. paths: /v1/care-life-moments/preferences: put: tags: - Pastoral Care summary: Update Pastoral Care Preferences description: >- Updates one or more member-controlled consent and contact settings. Reminder and Care Radar consent are disabled by default. Disabling a consent also closes related pending follow-up signals. operationId: putCareLifeMomentsPreferences requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/CarePreferenceInput' example: reminders_enabled: true grief_follow_up_enabled: true hard_anniversary_follow_up_enabled: true care_radar_enabled: false group_participation_follow_up_enabled: false contact_preference: text acknowledgment_style: ask_first responses: '200': description: Pastoral Care preferences were updated. content: application/json: schema: $ref: '#/components/schemas/CarePreferenceResponse' example: status: Success message: Your pastoral care preferences were updated. data: preferences: reminders_enabled: true birthday_follow_up_enabled: false grief_follow_up_enabled: true illness_follow_up_enabled: false crisis_follow_up_enabled: false hard_anniversary_follow_up_enabled: true care_radar_enabled: false group_participation_follow_up_enabled: false contact_preference: text acknowledgment_style: ask_first consented_at: '2026-07-25T09:30:00.000000Z' care_radar_consented_at: null '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' '422': $ref: '#/components/responses/ValidationError' '500': $ref: '#/components/responses/ServerError' components: schemas: CarePreferenceInput: type: object additionalProperties: false properties: reminders_enabled: type: boolean description: Enable or disable all life-moment reminders. birthday_follow_up_enabled: type: boolean description: Enable or disable birthday follow-up. grief_follow_up_enabled: type: boolean description: Enable or disable grief follow-up. illness_follow_up_enabled: type: boolean description: Enable or disable illness follow-up. crisis_follow_up_enabled: type: boolean description: Enable or disable crisis follow-up. hard_anniversary_follow_up_enabled: type: boolean description: Enable or disable hard-anniversary follow-up. care_radar_enabled: type: boolean description: Enable or disable Care Radar consent. group_participation_follow_up_enabled: type: boolean description: Enable or disable Community Group participation follow-up consent. contact_preference: $ref: '#/components/schemas/CareContactPreference' acknowledgment_style: type: string description: Preferred acknowledgment style. enum: - gentle - ask_first - no_contact CarePreferenceResponse: type: object required: - status - data properties: status: type: string description: Request result. example: Success message: type: string description: Member-facing result message. data: type: object required: - preferences properties: preferences: $ref: '#/components/schemas/CarePreference' CareContactPreference: type: string description: How the member prefers to be contacted. enum: - in_app - phone - text - email example: phone CarePreference: type: object required: - reminders_enabled - birthday_follow_up_enabled - grief_follow_up_enabled - illness_follow_up_enabled - crisis_follow_up_enabled - hard_anniversary_follow_up_enabled - care_radar_enabled - group_participation_follow_up_enabled - contact_preference - acknowledgment_style properties: reminders_enabled: type: boolean description: Master consent for life-moment follow-up reminders. birthday_follow_up_enabled: type: boolean description: Allow birthday follow-up. grief_follow_up_enabled: type: boolean description: Allow grief-anniversary follow-up. illness_follow_up_enabled: type: boolean description: Allow illness check-ins. crisis_follow_up_enabled: type: boolean description: Allow crisis follow-up. hard_anniversary_follow_up_enabled: type: boolean description: Allow hard-anniversary follow-up. care_radar_enabled: type: boolean description: Allow consent-backed Care Radar participation. group_participation_follow_up_enabled: type: boolean description: >- Allow Community Group participation follow-up when Care Radar is also enabled. contact_preference: $ref: '#/components/schemas/CareContactPreference' acknowledgment_style: type: string description: Preferred acknowledgment style. enum: - gentle - ask_first - no_contact example: ask_first consented_at: type: - string - 'null' description: When reminder consent was recorded. format: date-time care_radar_consented_at: type: - string - 'null' description: When Care Radar consent was recorded. format: date-time ErrorResponse: type: object description: >- Error response. Validation failures also include an `errors` object keyed by field name. properties: status: type: string example: Error message: type: string example: The request could not be completed. error: type: - string - 'null' example: null error_message: type: - string - 'null' example: null errors: type: object additionalProperties: true responses: BadRequest: description: The request is not valid for the current resource state. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' Unauthorized: description: >- The API key or member bearer token is missing, invalid, expired, or belongs to another church. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' Forbidden: description: The member is authenticated but cannot perform this action. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' NotFound: description: The requested resource was not found in the authenticated church. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' ValidationError: description: One or more request fields failed validation. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' ServerError: description: >- The request could not be completed because of an unexpected server error. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' securitySchemes: apiKeyAuth: type: apiKey in: header name: X-API-Key description: >- Client API key copied from Developer Access in the TheFaithApp dashboard. bearerAuth: type: http scheme: bearer bearerFormat: Sanctum description: Member access token returned by `POST /v1/auth/token`. ````