Registers a new file in a directory and returns a presigned S3-compatible PUT URL to upload the file bytes. If dir_id is omitted, a new temporary directory is created automatically (24h TTL). File names are case-sensitive and must be unique per directory. The returned upload URL is valid for 1 hour and may include headers that you must send with the PUT request.
Your secret API key. Format: Bearer <key>
The file record was created successfully and a presigned PUT URL was issued. Use the provided upload.url, upload.method (always PUT), and upload.headers when uploading the raw file bytes. The URL expires after upload.expiresInSeconds.