Skip to content
Sanmopia Modernization

Grant reservation-scoped care-history read authority to a family member

Switch to Zen Mode
POST
/family-accounts/{familyAccountId}/reservation-care-history-access-grants
curl --request POST \
  --url https://example.com/family-accounts/example/reservation-care-history-access-grants \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: example' \
  --data '{ "granteeMemberId": "example", "reservationBookingId": "example", "scopes": [ "summary" ], "expiresAt": "2026-04-15T12:00:00Z" }'

Authenticated mother is derived by backend; grant never authorizes review or rating mutation.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
familyAccountId
required
string
>= 1 characters

Header Parameters

Section titled “Header Parameters”
Idempotency-Key
required
string
>= 1 characters

Request Bodyrequired

Section titled “Request Bodyrequired”
Media typeapplication/json
GrantReservationCareHistoryAccessRequest

Grant reservation-scoped care-history read authority to one family member.

object
granteeMemberId
required
string
>= 1 characters
reservationBookingId
required
string
>= 1 characters
scopes
required
Array<string>
>= 1 items unique items
Allowed values: summary daily_reports caregiver_notes full_care_history
expiresAt
required
string format: date-time
key
additional properties

Responses

Section titled “Responses”

201

Section titled “201”

Reservation care-history access granted at revision one

Media typeapplication/json
ReservationCareHistoryAccessGrantResponse

Reservation-scoped care-history read authority. This grant does not authorize review or rating mutation.

object
reservationCareHistoryAccessGrantId
required
string
>= 1 characters
granteeMemberId
required
string
>= 1 characters
motherMemberId
required
string
>= 1 characters
reservationBookingId
required
string
>= 1 characters
scopes
required
Array<string>
>= 1 items unique items
Allowed values: summary daily_reports caregiver_notes full_care_history
grantedByMemberId
required
string
>= 1 characters
grantedAt
required
string format: date-time
expiresAt
required
string format: date-time
revokedAt
required
string | null format: date-time
revision
required
integer
>= 1
authorityEvidence
required
Array<string>
>= 1 items unique items
revokedByMemberId
required
string | null
>= 1 characters
revocationReasonCode
required
string | null
>= 1 characters
key
additional properties

401

Section titled “401”

Supabase bearer token is required

403

Section titled “403”

Authenticated actor cannot grant family authority

404

Section titled “404”

Family account, grantee, or reservation booking was not found

409

Section titled “409”

Grant scope, overlap, expiry, or idempotency facts conflict

503

Section titled “503”

Reservation care-history access command store is unavailable