1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75# Update File
<span class="request">`PUT` **/api/1.1/files/_[id]_**</span>
<span class="description">Update a file (and its metadata) within the Directus File Library</span>
<span class="arguments">Name</span> | Value | Description
--------|-----|------------
**id** _Integer_ | <span class="required">Required</span> | The `id` of the file you wish to update
<span class="custom">**Data**</span> _File Object_ | | <span class="custom">This data and its architecture is based on Directus files's schema.</span>
**active** _Integer_ | | File's status `1=active, 2=inactive, 3=deleted`
**name** _String_ | | File name
**title** _String_ | | File's title
**location** _String_ | | Location of where the picture was taken, if any
**type** _String_ | | File mime type
**url** _String_ | | File url relativity to Directus base url
**tags** _String_ | | Comma separated tags
**caption** _String_ | | File caption (description)
**width** _Integer_ | | File width
**height** _Integer_ | | File height
**size** _Integer_ | | File size in bytes
**embed_id** _String_ | | ID of the embedded file. Ex Youtube ID
**user** _Integer_ | | File owner (who uploaded the file)
**date_uploaded** _String_ | | File uploaded date. **TODO** It should be an DateTime object
**storage_adapter** _String_ | | Storage adapter used to upload the file
### Example Request
```php
$file = $client->updateFile(2, [
'title' => 'My New File Name'
]);
```
```javascript
client.updateFile(2, {
title: 'My New File Name'
});
```
### Response
<span class="attributes">Attribute</span> | Description
--------|------------
**meta** _Meta Object_ | The Directus system metadata object that provides useful information not contained within the dataset itself [**Meta Object**: View Nested Attributes](/overview/objects-model.md#meta-object)
**data** _File Object_ | <span class="custom">This data and its architecture is based on the Directus file schema and can be extended with additional custom columns</span> [**File Object**: View Nested Attributes](/overview/objects-model.md#file-object)
```json
{
"meta": {
"table": "directus_files",
"type": "item"
},
"data": {
"id": 2,
"active": 1,
"name": "2a05d2300cf0a8bf1a3f6567366affed.jpg",
"url": null,
"title": "My New File Name",
"location": "",
"caption": "",
"type": "image\/jpg",
"charset": "binary",
"tags": "",
"width": 594,
"height": 447,
"size": 52155,
"embed_id": null,
"user": 1,
"date_uploaded": "2013-11-15 04:30:52 UTC",
"storage_adapter": "local"
}
}
```