Guide5 min readUpdated Jun 4, 2026

Adding Photos And Attachments To Inspections

Inspection attachments are submitted with the inspection record itself. The portal no longer needs a separate upload-first step for KS inspection submissions.

BYBy Team BYLT

How attachments are saved

When you submit or update a KS inspection, the portal sends the JSON inspection payload and selected files together in one multipart request. File answers point to the uploaded files by their position in the request.

  • Single-file fields should receive one file.
  • Multi-file fields can receive multiple files when the form allows it.
  • Non-file fields should not receive attachments.
  • Each uploaded file should belong to exactly one answer field.
  • Saved answers return attachment metadata with a temporary signed URL.

Adding files during an inspection

  1. 1
    Use the upload field in the form

    Attach photos or files only to the question that asks for that evidence.

  2. 2
    Check required file fields

    If a file upload field is required, add the required number of files before submitting.

  3. 3
    Submit once with the inspection

    The files are saved together with the inspection record.

  4. 4
    Open the saved record

    Review the inspection detail to confirm filenames, image previews, and attachment links are present.

Do not rely on old pre-upload behavior

For KS inspection create and update, attachments should go through the inspection create/update request. Older upload-first endpoints may exist but are not the intended inspection submission flow.

Editing attachments later

  • On edit, attachments you keep must be retained by their stable attachment key.
  • If a file field is submitted without retained keys or new files, that field can be cleared.
  • Signed URLs are temporary; if a preview link expires, reopen or refetch the inspection detail.