How-to Guide

Troubleshoot file upload

Resolve requirements upload failures.

Objective

Resolve requirements upload failures.

Prerequisites

  • Failed upload attempt

Procedure

Check file size

Ensure document is within documented limits.

Navigation: Quality → Tests, Coverage, or Test Health. Link work to a project when validating generation or traceability.

Verification: Confirm organization and team context in the Console header before making changes.

Verify file type

Use supported formats: PDF, DOC, DOCX, PNG, JPG.

Navigation: Quality → Tests, Coverage, or Test Health. Link work to a project when validating generation or traceability.

Verification: Note project, run, or agent IDs if you may need support escalation.

Retry on stable network

Retry upload; contact admin if storage configuration issue.

Navigation: Quality → Tests, Coverage, or Test Health. Link work to a project when validating generation or traceability.

Verification: Confirm UI state matches your runbook. Retry once on transient errors before opening a ticket.

Verification checklist

  • Confirm expected UI state or API response after each critical step
  • Document run ID, project ID, or agent ID for support escalation if needed
  • Notify stakeholders if the workflow affects release gates or production validation

Expected result

Upload succeeds or issue escalated with error details.

Was this page helpful?

Troubleshoot file upload | Zof AI Documentation