Upload a file to the authenticated application's storage
POST/v1/storage/files
Upload one file using multipart/form-data and a required Idempotency-Key. The API key determines the application and organization. Additional multipart fields, including organization, application and S3 location, are rejected. Content is deduplicated by verified SHA-256 within an organization; new references to existing bytes do not increase physical storage usage. Exact retries with the same key return the original reference; changing the file or filename conflicts. The returned media URL serves the file as an attachment. Generic upload does not guarantee that a communication channel accepts the file media type or size.
Request
Responses
- 200
- 201
- 400
- 401
- 402
- 409
- 413
- 503
Exact idempotent retry; returns the original reference.
New application reference created.
STORAGE_FILE_REQUIRED, STORAGE_FILE_INVALID or STORAGE_IDEMPOTENCY_KEY_INVALID.
API key is missing, invalid, expired or unavailable.
STORAGE_CREDIT_INSUFFICIENT.
STORAGE_IDEMPOTENCY_CONFLICT or STORAGE_UPLOAD_IN_PROGRESS.
STORAGE_FILE_TOO_LARGE; maximum 104857600 bytes.
STORAGE_UPLOAD_UNAVAILABLE.