# filesystem.put

Job to put contents to `path`.

This method is a job.

This job MUST be used with file upload. See Uploading a File.

Type: object

##

Type: array
No Additional Items

#### Tuple Validation

##### Parameter 1: path

#### path

Type: string

Path where the file should be written.

Must be at least `1` characters long

##### Parameter 2: options

#### options

Type: object Default: {"append": false, "mode": null}

Options controlling file writing behavior.

No Additional Properties

##

#### Append

Type: boolean Default: false

Whether to append to the file instead of overwriting.

##

#### Mode

Default: null

Unix permissions to set on the file or `null` to use default.

## Any of

Type: integer
Type: null

##

#### Result

Type: const

Returns `true` when the file is successfully written.

Specific value: `true`

Required roles: FULL_ADMIN