Test

[sweetmantech]

Summary by cubic

Adds POST /api/connectors/files to stage an image (by public URL) into Composio storage and return a { name, mimetype, s3key } descriptor for use in file_uploadable connector actions (e.g., LinkedIn/X post images).

• New Features
  • POST /api/connectors/files: accepts { url, toolSlug }, uploads via Composio, and returns { success, name, mimetype, s3key }.
  • Auth required via x-api-key or Authorization: Bearer; no account_id is used.
  • Derives toolkitSlug from the action toolSlug to scope the upload correctly.
  • Status codes: 200 on success; 400 for invalid/malformed body; 401 for unauthenticated; 502 when the upstream fetch/store fails.

^{Written for commit cdb34d0. Summary will update on new commits.}

Summary by CodeRabbit

• New Features
  • Added API endpoint for uploading connector files via URL
  • Supports CORS requests and requires authentication
  • Performs comprehensive request validation on upload parameters
  • Returns uploaded file metadata and detailed error responses

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
api	Ready	Preview	Jun 20, 2026 10:19pm

[coderabbitai]

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: aee3d37c-44f6-4fba-acf0-563b88b26f92

📥 Commits

Reviewing files that changed from the base of the PR and between 2f1847b and cdb34d0.

⛔ Files ignored due to path filters (5)

• lib/composio/connectors/__tests__/deriveToolkitSlug.test.ts is excluded by !**/*.test.*, !**/__tests__/** and included by lib/**
• lib/composio/connectors/__tests__/uploadConnectorFile.test.ts is excluded by !**/*.test.*, !**/__tests__/** and included by lib/**
• lib/composio/connectors/__tests__/uploadConnectorFileHandler.test.ts is excluded by !**/*.test.*, !**/__tests__/** and included by lib/**
• lib/composio/connectors/__tests__/validateUploadConnectorFileBody.test.ts is excluded by !**/*.test.*, !**/__tests__/** and included by lib/**
• lib/composio/connectors/__tests__/validateUploadConnectorFileRequest.test.ts is excluded by !**/*.test.*, !**/__tests__/** and included by lib/**

📒 Files selected for processing (6)

• app/api/connectors/files/route.ts
• lib/composio/connectors/deriveToolkitSlug.ts
• lib/composio/connectors/uploadConnectorFile.ts
• lib/composio/connectors/uploadConnectorFileHandler.ts
• lib/composio/connectors/validateUploadConnectorFileBody.ts
• lib/composio/connectors/validateUploadConnectorFileRequest.ts

---

📝 Walkthrough

Walkthrough

A new POST /api/connectors/files Next.js route is added, along with its full supporting library stack. The endpoint authenticates the request, validates a url and toolSlug body via Zod, derives a Composio toolkit slug from the tool slug, uploads the file to Composio storage, and returns the resulting file descriptor (name, mimetype, s3key). An OPTIONS handler provides CORS preflight support.

Changes

Connector File Upload Endpoint

Layer / File(s)	Summary
Request body schema and validation lib/composio/connectors/validateUploadConnectorFileBody.ts, lib/composio/connectors/validateUploadConnectorFileRequest.ts	Zod schema enforces url (valid URL) and toolSlug (non-empty); validateUploadConnectorFileBody returns a 400 NextResponse with CORS headers on failure or typed data on success. validateUploadConnectorFileRequest chains auth via validateAuthContext, JSON parsing via safeParseJson, and body validation, returning early NextResponse errors or UploadConnectorFileParams.
Toolkit slug derivation and Composio file upload lib/composio/connectors/deriveToolkitSlug.ts, lib/composio/connectors/uploadConnectorFile.ts	deriveToolkitSlug lowercases the first underscore-delimited segment of the action slug. uploadConnectorFile obtains a Composio client, calls composio.files.upload, and returns the UploadedConnectorFile descriptor (name, mimetype, s3key).
Handler orchestration and route entry point lib/composio/connectors/uploadConnectorFileHandler.ts, app/api/connectors/files/route.ts	uploadConnectorFileHandler applies CORS headers, validates the request, calls uploadConnectorFile, returns a 200 success JSON payload, and catches unexpected errors returning a 502 with CORS headers. The route module exports OPTIONS for preflight and POST delegating to the handler.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Poem

📁 A URL and a slug walk into a route,
The validator checks them — no room for doubt.
The toolkit slug splits on the underscore line,
Composio stores it, returns fields just fine.
200 OK — the file's in the cloud,
Clean, single-responsibility, standing proud. ✨

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch test

---

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.}