ai.newnal.illi.media.uploadItem

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 without another record or media registration. Originals and derivatives are stored on their original uploader PDN.

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

Procedure

procedure · POST

Input

multipart/form-data

Output

application/json

Errors

UnsupportedMedia

No description in schema.

MediaTooLarge

No description in schema.

UploadThrottled

No description in schema.

ScopeMissing

No description in schema.

NotAllowed

No description in schema.

PdsUnavailable

No description in schema.

Similar lexicons

semantic match

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

  • One original photo or video in the home's content bank. The original and its sidecar are blobs on the author's PDN; the thumbnail, display rendition, poster, dimensions and capture time are produced by the media service and uploaded by the Service Agent Node to the same PDN after the item was created, so a freshly created item may carry only the original and its upload-time content hash for exact deduplication.

  • Only the uploader updates people, note and the manual capture time. takenAt sets a capture time with an offset; clearTakenAt true clears the correction; sending both, or takenAt null, is InvalidRequest; omitting both keeps it. Works already composed keep their composition; the saved values reach the media service for later works. AI fields cannot be edited.

  • 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, rk