Skip to main content

API Import

Programmatically upload files to your project using REST endpoints for automated document processing workflows.

Prerequisites​

API Key Setup​

Create an API key with appropriate permissions through your team's API Keys section. The key must include:

  • uploads.create - Required to create new uploads
  • uploads.view - Recommended for checking upload status
  • uploads.edit - Optional for modifying uploads
  • tasks.view - Recommended for task-level monitoring
  • tasks.edit - Optional for task manipulation

See API Keys documentation for detailed setup instructions.

Project Configuration​

Enable API access in your project settings:

  1. Navigate to Project Settings → Import
  2. Toggle "Allow import via API"
  3. Add your API key to the project

API Endpoints​

Base URL: https://api.send.ai/v2/{teamId}

Upload Files​

POST /upload
Authorization: Bearer YOUR_API_KEY
Content-Type: multipart/form-data

Check Upload Status​

GET /upload/{uploadId}
Authorization: Bearer YOUR_API_KEY

Authentication​

Include your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Rate Limits & Constraints​

  • Follows standard upload limits (40MB per file, 20MB per page, 100 files per batch)
  • API keys inherit team-level rate limits
  • Failed uploads return detailed error responses

Related Documentation​