docs: update sandbox file upload to use blob URLs

[sweetmantech]

Summary

• Replace multipart form data with JSON body containing blob URLs for POST /api/sandboxes/files
• Files are uploaded to temporary blob storage (e.g., Vercel Blob) first, then URLs are passed to the API
• API downloads from blob URL, commits to GitHub, and deletes the blob after
• This bypasses Vercel's 4.5MB serverless function body size limit

Test plan

• Verify OpenAPI spec renders correctly in Mintlify
• Verify endpoint description matches the new flow

🤖 Generated with Claude Code

Summary by CodeRabbit

Documentation

• Updated API documentation for the sandbox file upload endpoint. File uploads now use JSON format with file URL and name properties, replacing the previous multipart form-data approach.

[coderabbitai]

Warning

Rate limit exceeded

@sweetmantech has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 18 minutes and 36 seconds before requesting another review.

Your organization is not enrolled in usage-based pricing. Contact your admin to enable usage-based pricing to continue reviews beyond the rate limit, or try again in 18 minutes and 36 seconds.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

ℹ️ Review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 5018d697-a4fc-4994-ad54-802d8f3b59e4

📥 Commits

Reviewing files that changed from the base of the PR and between 4184f4c and a259b32.

📒 Files selected for processing (1)

• api-reference/openapi.json

📝 Walkthrough

Walkthrough

The OpenAPI specification for the POST /api/sandboxes/files endpoint is updated to change the file upload mechanism from multipart/form-data with binary files to application/json accepting an array of URL and name pairs.

Changes

Cohort / File(s)	Summary
File Upload API Specification api-reference/openapi.json	Updated POST /api/sandboxes/files endpoint request content type from multipart/form-data to application/json. Changed UploadSandboxFilesRequest.files schema from array<string(binary)> to array<object> with required properties url (URI string) and name (string). Applied formatting/structure normalization to OpenAPI object serialization and minor description text refinements.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

Possibly related PRs

• docs: POST /api/sandboxes/files - OpenAPI spec + MDX page #83: Directly related as it previously introduced the multipart/form-data file upload structure for the same endpoint, which this PR replaces with a JSON-based URL reference approach.

Poem

🐰 From binary burrows to JSON streams,
Files as URLs now dance in dreams,
No multipart mazes to navigate through,
Just links and names—so clean and true! ✨

🚥 Pre-merge checks | ✅ 3

✅ Passed checks (3 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title accurately summarizes the main change: updating the sandbox file upload endpoint documentation from multipart form data to JSON blob URLs.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch feature/sandbox-upload-blob-urls

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}