---
name: "WebCommon.incomingFile"
section: "3kaya"
platform: "linux"
package: "kaya"
version: "0.4.4-6.2"
release: "Debian 8 (Jessie)"
platforms: ["linux"]
url: "https://new.carta.tech/WebCommon.incomingFile"
---

# WebCommon.incomingFile(3kaya)

Return the first file uploaded with a particular key name

## NAME

WebCommon::incomingFile - Return the first file uploaded with a particular key name

## SYNOPSIS

**Uploaded incomingFile(** *String key* **)**

## ARGUMENTS

**key** The key to return files for

## DESCRIPTION

Returns an **WebCommon.Uploaded (3kaya)** for the first user-uploaded file with the specified key, or throws a **WebCommon.NotIncoming (3kaya)** Exception if these are not present.

This is generaly easier than using **WebCommon.incomingFiles (3kaya)** if you are expecting multiple files.

## AUTHORS

Kaya standard library by Edwin Brady, Chris Morris and others (kaya@kayalang.org). For further information see http://kayalang.org/

## LICENSE

The Kaya standard library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License (version 2.1 or any later version) as published by the Free Software Foundation.

## RELATED

**WebCommon.allowFileUploads (3kaya)**

**WebCommon.incomingFileExists (3kaya)**

**WebCommon.incomingFileKeys (3kaya)**

**WebCommon.incomingFiles (3kaya)**

**WebCommon.incomingValue (3kaya)**