# add

Add a file or directory to IPFS.

Request

```bash
curl "https://ipfs.krypc.io:5001/api/v0/add?recursive=false&quiet=<value>&quieter=<value>&silent=<value>&progress=<value>&trickle=<value>&only-hash=<value>&wrap-with-directory=<value>&hidden=<value>&chunker=<value>&pin=true&raw-leaves=<value>&nocopy=<value>&fscache=<value>&cid-version=0&hash=sha2-256" \
    -X POST \
    -u "<API_KEY>:<API_KEY_SECRET>" \
    -H "Content-Type: multipart/form-data" \
    -F file=@"<file>"
```

**REQUEST PARAMS**

* `file` *\[Required]* - The path to a file to be added to IPFS.
* `quiet` *\[Optional]* - Write minimal output.
* `quieter` *\[Optional]* - Write only final hash.
* `silent` *\[Optional]* - Write no output.
* `progress` *\[Optional]* - Stream progress data.
* `trickle` *\[Optional]* - Use trickle-dag format for dag `generation`.
* `only-hash` *\[Optional]* - Only chunk and hash - do not write to disk.
* `wrap-with-directory` *\[Optional]* - Wrap files with a directory object.
* `pin` *\[Optional]* - Pin this object when adding. The default is `true`.
* `raw-leaves` *\[Optional]* - Use raw blocks for leaf nodes. (Experimental)
* `nocopy` *\[Optional]* - Add the file using filestore. (Experimental)
* `fscache` *\[Optional]* - Check the filestore for pre-existing blocks. (Experimental)
* `cid-version` *\[Optional]*: Cid version. Non-zero value changes the default of `raw-leaves` to `true`. The default is `0`. (Experimental)
* `hash` *\[Optional]*: Hash function to use. Sets `cid-version` to `1` if used. The default is `sha2-256`. (Experimental)

#### RESPONSE <a href="#response" id="response"></a>

On success, the call to this endpoint will return with 200 and the following body:

```
{
  "Name": "sample-result.json",
  "Hash": "QmSTkR1kkqMuGEeBS49dxVJjgHRMH6cUYa7D3tcHDQ3ea3",
  "Size": "2120"
}
```

**RESULT FIELDS**

* `Name` - Name of the object.
* `Hash` - Hash of the uploaded object.
* `Size` - Integer indication size in bytes.
*