ai.newnal.illi.home.uploadMyPhoto

Set the caller's photo in one home (family members; parents use parent.uploadProfileImage). The binary body accepts JPEG, PNG, WebP, HEIC or HEIF, at most 10 MB. The media service synchronously rotates upright, scales the longest side to at most 1024 px without enlargement and returns a metadata-free JPEG (no EXIF, GPS, XMP or ICC), at most 5,000,000 bytes. The Service Agent Node uploads this JPEG with the caller's session and writes the caller's My Data profile (ai.newnal.mydata.dev.profile, rkey self) in the home's family sphere. The photo is per home and replaces an earlier photo. Media failure writes nothing to the PDN or profile: UnsupportedMedia (415), MediaTooLarge (413), or MediaUnavailable (503, with Retry-After when supplied).

Details · procedure
Kindprocedure
Authorityhome.illi.newnal.ai
Indexed

Procedure

procedure · POST

Parameters

query string

homeId

requiredstring · tid

Input

*/*

Output

application/json

photoUrl

requiredstring · uri

Gated URL of the stored photo, readable by the home's members and its device.

Errors

NotMember

No description in schema.

HomeNotFound

No description in schema.

InvalidRequest

Parents set their photo with parent.uploadProfileImage.

UnsupportedMedia

No description in schema.

MediaTooLarge

No description in schema.

DelegationUnavailable

The caller's session the Service Agent Node holds is unavailable; sign in again.

PdsUnavailable

No description in schema.

ScopeMissing

The caller's session was issued before the family permission set included the profile record; sign in again.

MediaUnavailable

Photo processing is temporarily unavailable; no photo was uploaded. Retry-After is forwarded when supplied by media.

Similar lexicons

semantic match

Lexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.

  • Upload a profile photo to the PARENT's PDN with the parent's delegated session, after checking linkage, permission and delegation. Query homeId and slot name the parent. The binary body accepts JPEG, PNG, WebP, HEIC or HEIF, at most 5 MB. The media service synchronously rotates upright, scales the longest side to at most 1024 px without enlargement and returns a metadata-free JPEG (no EXIF, GPS, XMP or ICC), at most 5,000,000 bytes. The Service Agent Node uploads only that JPEG with the parent's

  • Upload one photo or video. multipart/form-data parts: homeId, file, timezone?, people? (JSON array of {name, relationship?}, at most 20 people), note? (at most 300 graphemes), takenAt? (offset-bearing timestamp). Unknown parts are ignored. A manual takenAt is queued after registration through updateUserInput. Otherwise capture time comes from file metadata, then upload time. Same-file content in one home returns the existing active original across uploaders, ignoring the new people/note/takenAt