Skip to content

PPC2-4815: update upload doc#288

Merged
reach-at-brijesh merged 8 commits intomainfrom
PPC2-4815
Apr 9, 2025
Merged

PPC2-4815: update upload doc#288
reach-at-brijesh merged 8 commits intomainfrom
PPC2-4815

Conversation

@reach-at-brijesh
Copy link
Contributor

@reach-at-brijesh reach-at-brijesh commented Apr 3, 2025

JIRA PPC2-4815

Update API documentation to reflect use of upload_id.

This PR updates the API documentation to fully document the upload_id approach for file uploads.
This aligns with our broader effort to migrate away from NFS-based file uploads to the more performant, reliable S3 direct upload methodology.

Changes

  • Added documentation for using upload_id with various endpoints (Action Plans, Meeting Topics)
  • Added examples showing proper usage of upload_id in API requests and responses
  • Included migration recommendations for developers still using legacy approaches
  • Emphasized performance and reliability improvements with the upload_id approach

Files Changed

  • Added new documentation section explaining the upload_id concept and implementation
  • Added specific examples showing proper request and response formats

Screenshots.

image

image

image

Copilot AI review requested due to automatic review settings April 3, 2025 17:26
@reach-at-brijesh reach-at-brijesh self-assigned this Apr 3, 2025
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull Request Overview

This PR updates the tutorials upload documentation to clarify the file splitting command and improve the presentation of API request and response examples, including new instructions on using the upload UUID.

  • Clarifies the explanation for the split command by explicitly stating the segment size requirement.
  • Updates and formats the Create Upload API endpoint request body as a JSON code block.
  • Adds a new section explaining how to use the upload_id in various API requests with detailed examples.

@sandeep-at-procore sandeep-at-procore changed the title PPC2-4815: update uplaod doc PPC2-4815: update upload doc Apr 8, 2025
@reach-at-brijesh reach-at-brijesh requested a review from a team April 8, 2025 07:12
@reach-at-brijesh reach-at-brijesh requested review from a team and sandeep-at-procore April 9, 2025 05:53
@reach-at-brijesh reach-at-brijesh requested a review from greenny April 9, 2025 09:33
@reach-at-brijesh reach-at-brijesh merged commit cfa9c47 into main Apr 9, 2025
5 checks passed
@reach-at-brijesh reach-at-brijesh deleted the PPC2-4815 branch April 9, 2025 13:45
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants