Files

Create presigned URL for request file upload to S3

Changed on

Generates a presigned URL for uploading a file to S3. This endpoint handles deduplication by checking if a file with the same MD5 hash already exists.

post/api/v3.1/files/upload/request

Request

  • Base URL
    https://backend.composio.dev
  • URL
    https://backend.composio.dev/api/v3.1/files/upload/request
  • Auth
    API key in header x-api-key

Request body

toolkit_slugstring required

Slug of the app where this file belongs to. Example: "gmail", "slack", "github"

tool_slugstring required

Slug of the action where this file belongs to. Example: "GMAIL_SEND_EMAIL", "SLACK_UPLOAD_FILE"

filenamestring required

Name of the original file. Example: "quarterly_report.pdf"

mimetypestring required

Mime type of the original file. Example: "application/pdf", "image/png"

md5string required

MD5 hash of the file for deduplication and integrity verification. Example: "a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6"

Response

Successfully created upload URL for request file

idstring required

ID of the request file. Example: "req_file_9mZn4qR8sXwT"

keystring required

Object storage upload location. Example: "projects/pr_1a2b3c4d5e6f/requests/slack/SLACK_UPLOAD_FILE/document_9mZn4q.docx"

new_presigned_urlstring required

Presigned URL for upload. Example: "https://storage.composio.dev/projects/pr_1a2b3c4d5e6f/requests/slack/document_9mZn4q.docx?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Expires=3600..."

newPresignedUrlstring required

[DEPRECATED] Use new_presigned_url instead. Presigned URL for upload. Example: "https://storage.composio.dev/projects/pr_1a2b3c4d5e6f/requests/slack/document_9mZn4q.docx?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Expires=3600..."

type'new' required

[DEPRECATED] Indicates this is a new file that needs to be uploaded

Changes