Rippling: Create a new file — request body — body

API reference · Contract 2026-10-28

SDK schema: Create a new file — request body — body

Field	Type	Presence	Description and constraints
$	object	Root	Response DTO for “POST /files/“ and “GET /files/{id}“.
content_type	string	Optional	MIME type supplied by the client at create time
display_name	string	Optional	Human-readable label for the file
status	string	Required within parent	Lifecycle status: awaiting_upload | uploaded | active | infected
upload_fields	object	Optional	Required form fields to include in the multipart POST to S3 alongside the file binary
upload_url	string	Optional	S3 endpoint URL — POST your multipart form here to upload the file. Present only in the create response.
url_data	object	Optional	URLs for accessing the uploaded file after a successful upload
url_data.preview_url	string	Optional	CDN URL for previewing the uploaded file after upload completes
url_data.s3_url	string	Optional	S3 URL where the file is accessible after upload