Files

To add a file to a project, first we need to upload it:

Response: HTTP 200, application/json (Hide)

POST /upload-files

Files:

1
2
3
4
5
6
[
    [
        "ac.png",
        "image\/png"
    ]
]

Response:

1
2
3
4
5
6
7
8
9
[
    {
        "code": "4N6RJUa0v9kNCrDYNxwgZ6vba8BxktfI1aHk9RYA",
        "name": "ac.png",
        "mime_type": "image\/png",
        "size": 1927,
        "thumbnail_url": "http:\/\/feather.dev\/proxy.php?proxy=forward_thumbnail&module=system&v=current&b=DEV&context=upload&name=2015-04%2FAS5i3kyuNDrRY7ZuAM9lrFh1vw6JDCI5kBbbLAwo&original_file_name=ac.png&width=--WIDTH--&height=--HEIGHT--&ver=1927&scale=--SCALE--"
    }
]

Now that we have uploaded a file, and got file's code, lets add it to the project:

Response: HTTP 200, application/json (Hide)

POST /projects/1/files

Payload:

1
2
3
4
{
    "uploaded_file_code": "4N6RJUa0v9kNCrDYNxwgZ6vba8BxktfI1aHk9RYA",
    "is_hidden_from_clients": true
}

Response:

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
{
    "single": {
        "id": 1,
        "class": "File",
        "url_path": "\/projects\/1\/files\/1",
        "name": "ac.png",
        "is_trashed": false,
        "trashed_on": null,
        "trashed_by_id": 0,
        "project_id": 1,
        "is_hidden_from_clients": true,
        "mime_type": "image\/png",
        "size": 1927,
        "md5": null,
        "download_url": "http:\/\/feather.dev\/projects\/1\/files\/1\/download",
        "thumbnail_url": "http:\/\/feather.dev\/proxy.php?proxy=forward_thumbnail&module=system&v=current&b=DEV&context=upload&name=2015-04%2FAS5i3kyuNDrRY7ZuAM9lrFh1vw6JDCI5kBbbLAwo&original_file_name=ac.png&width=--WIDTH--&height=--HEIGHT--&ver=1927&scale=--SCALE--",
        "file_meta": {
            "kind": "image",
            "dimensions": {
                "width": 50,
                "height": 50
            }
        },
        "created_on": 1430164134,
        "created_by_id": 1,
        "updated_on": 1430164134,
        "updated_by_id": 1
    }
}

Lets check if we got everything uploaded properly:

Response: HTTP 200, image/png (Hide)

GET /projects/1/files/1/download

Response:

1
2
3
4
5
6
7
8
9
10
�PNG


IHDR22?��tEXtSoftwareAdobe ImageReadyq�e&lt;)IDATx��Zyl�i�}�L[��F[��JQ�M�L�A$D�+B	��HlD&quot;�%D6�8&quot;�c���T��&quot;�Qm��S�c(�L��f��~�ᛯs�m�I_M�y���&gt;���R�m��Ǐ�Q�p��o�a��P�a_�C:��gg4?�I�@��Hۚ)���o���h4-&lt;��� ��al	(��i�
�[bo��:B&amp;ȏ��l�4` �l�87
1ե�RR�[�v��&lt;}�z�E]c�q�S����^�ѽ;�!�n}y9��Ũ��C�۷�z9Pyĵq�H]��'&quot;&lt;=���OkjkQ��
*sr`:q�.��1h���2&quot;:t@ʢEh?{6�23!��5ڳ�dB�իx}�0*n���q)(�3����85�w�@�y�۴	�{�/��ƍx���'��l�nߎ0�	�g;Pr�
6l@MI���h�H��H=5q�H�;yR�@��TU��ʕ(:vL���+����&amp;���s�.]
sv�'��vM�h���0b�?�$������Q�-^�z�ͅ�.(h��p�d���jhz:�t��G�/����n�FDgϣJU~&gt;�ݿ�:Ʋ1.m��G������^]�L����7�:~&lt;�2�$��^���(�r��Ju5&quot;32�0v,�x�Z)ܻ�֮��(C�Qq%d�]�&lt;����
�n�?Lf[M���ű�����I�ܾ#��&quot;s�~��
��	\��H7�[�����TV�{��n��޳G�j/&quot;w�j�	/�����4��]H��*�!��3V�Z��$�.@�w��]��^2��&gt;riӧ���3g�C�.S�b4�{�3��y��]����u@���&lt;H7�Q+�@�С����l&gt;�7�kǘ֊��-�3��CW�}�}��&gt;��Z!
h�
!;w�A�^�ͥ.��m�G}���؁ѩSCr��cׄ�#���ùе8�=#&quot;ͽױÖ��H���Tl^�B`fx��
{Pc^	�N0��#ƶm!19�RͰ�����ۗ:���]nn#�
*�h'5*:.割��i��&amp;q�ӖBڢ��Ei&quot;��%��E6n������UO�Lɠ^����k���=�^�B-�Z+�k%������Ά��kjB��MC�b���I��5��Me}l[�V���4:@�M��nl��¨����!�_/Q,$k֠FsXo*�Dw��j������|~�t��'mD\��\�H�aw6MqXo�w�6t#��q����z�7ԑ�q��a�@|�&gt;*0��~Ď���*b��U�#�Y$C�
�Y?+eY�&amp;�U4āB���o�z�طr����1t&amp;#טIy��l���9`�Ϝ��Ǐ#��+����ԩ0	N��e:��~�@šRɛ�_���$�X^�F!o�
1�H7��A��Y������3����Y�Eu�d�L!K 	���Or�2�5�)�A/����Va	������X���XȴϓuTp��:ꊅ�&quot;�9�ܽ��nZ���z��(
o����M�c�᳘{e|�x�w�)��F���,�3I�ÇhG��&amp;11��k�f�⨛CΥ�*���/^DUq�j+4&amp;&amp;��,�ky���x��5x�#�ү~fv�3g&quot;�p�-B/jb�~#���fOϞE.�w��g��I:[���Ș?=��EBf&amp;B����dC�@��YYȣGM��	n�E��DK�EE	c�I4I,�1�]�����@�$�U�߫�� c8����6I�w6�^������L��K{���^�-�� ^�9t�X;m���&amp;�25����)� ���1*����ַ�_Id��Vkh}5 R�!	 -�+�4��Ss�;�j� ӗ~���I`�(����Ohx�7/��&gt;[��I��_�ςܥ���IEND�B`�

There is also a way to upload a batch of files. First, lets upload them:

Response: HTTP 200, application/json (Hide)

POST /upload-files

Files:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
[
    [
        "ac.png",
        "image\/png"
    ],
    [
        "profile.png",
        "image\/png"
    ],
    [
        "sketch.png",
        "image\/png"
    ]
]

Response:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
[
    {
        "code": "wMRRbvIbm9FllQmfvLPAlHzMAbB7GMris0kO9SPk",
        "name": "ac.png",
        "mime_type": "image\/png",
        "size": 1927,
        "thumbnail_url": "http:\/\/feather.dev\/proxy.php?proxy=forward_thumbnail&module=system&v=current&b=DEV&context=upload&name=2015-04%2Fs41bOyN4v2gGvAPsGQnzE0okb6PyJfL30B4NZGFk&original_file_name=ac.png&width=--WIDTH--&height=--HEIGHT--&ver=1927&scale=--SCALE--"
    },
    {
        "code": "OwmXxivAFZ0EKPVtFPeo2s9cxHXzsPdP21c0kCEA",
        "name": "profile.png",
        "mime_type": "image\/png",
        "size": 68914,
        "thumbnail_url": "http:\/\/feather.dev\/proxy.php?proxy=forward_thumbnail&module=system&v=current&b=DEV&context=upload&name=2015-04%2FQkv22I8liMMuia7IcxEJ0VRqU26RJJ2oUmfKUcV4&original_file_name=profile.png&width=--WIDTH--&height=--HEIGHT--&ver=68914&scale=--SCALE--"
    },
    {
        "code": "WmPFHVbqimdknRpnEVRrShMTr1uY5K6PXJkttlKB",
        "name": "sketch.png",
        "mime_type": "image\/png",
        "size": 616656,
        "thumbnail_url": "http:\/\/feather.dev\/proxy.php?proxy=forward_thumbnail&module=system&v=current&b=DEV&context=upload&name=2015-04%2F9JeS3Kx2OLS8IUufGUxkXcbNeYGDX8BvbjnMGeqh&original_file_name=sketch.png&width=--WIDTH--&height=--HEIGHT--&ver=616656&scale=--SCALE--"
    }
]

Now that we have uploaded files and have their codes, we can add them by sending a POST request to /projects/:project_id/files/batch path:

Response: HTTP 200, application/json (Hide)

POST /projects/1/files/batch

Payload:

1
2
3
4
5
6
{
    "file_1": "wMRRbvIbm9FllQmfvLPAlHzMAbB7GMris0kO9SPk",
    "file_2": "OwmXxivAFZ0EKPVtFPeo2s9cxHXzsPdP21c0kCEA",
    "file_3": "WmPFHVbqimdknRpnEVRrShMTr1uY5K6PXJkttlKB",
    "is_hidden_from_clients": true
}

Response:

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
76
77
78
79
80
81
82
83
[
    {
        "id": 2,
        "class": "File",
        "url_path": "\/projects\/1\/files\/2",
        "name": "ac-1.png",
        "is_trashed": false,
        "trashed_on": null,
        "trashed_by_id": 0,
        "project_id": 1,
        "is_hidden_from_clients": true,
        "mime_type": "image\/png",
        "size": 1927,
        "md5": null,
        "download_url": "http:\/\/feather.dev\/projects\/1\/files\/2\/download",
        "thumbnail_url": "http:\/\/feather.dev\/proxy.php?proxy=forward_thumbnail&module=system&v=current&b=DEV&context=upload&name=2015-04%2Fs41bOyN4v2gGvAPsGQnzE0okb6PyJfL30B4NZGFk&original_file_name=ac-1.png&width=--WIDTH--&height=--HEIGHT--&ver=1927&scale=--SCALE--",
        "file_meta": {
            "kind": "image",
            "dimensions": {
                "width": 50,
                "height": 50
            }
        },
        "created_on": 1430164135,
        "created_by_id": 1,
        "updated_on": 1430164135,
        "updated_by_id": 1
    },
    {
        "id": 3,
        "class": "File",
        "url_path": "\/projects\/1\/files\/3",
        "name": "profile.png",
        "is_trashed": false,
        "trashed_on": null,
        "trashed_by_id": 0,
        "project_id": 1,
        "is_hidden_from_clients": true,
        "mime_type": "image\/png",
        "size": 68914,
        "md5": null,
        "download_url": "http:\/\/feather.dev\/projects\/1\/files\/3\/download",
        "thumbnail_url": "http:\/\/feather.dev\/proxy.php?proxy=forward_thumbnail&module=system&v=current&b=DEV&context=upload&name=2015-04%2FQkv22I8liMMuia7IcxEJ0VRqU26RJJ2oUmfKUcV4&original_file_name=profile.png&width=--WIDTH--&height=--HEIGHT--&ver=68914&scale=--SCALE--",
        "file_meta": {
            "kind": "image",
            "dimensions": {
                "width": 586,
                "height": 438
            }
        },
        "created_on": 1430164135,
        "created_by_id": 1,
        "updated_on": 1430164135,
        "updated_by_id": 1
    },
    {
        "id": 4,
        "class": "File",
        "url_path": "\/projects\/1\/files\/4",
        "name": "sketch.png",
        "is_trashed": false,
        "trashed_on": null,
        "trashed_by_id": 0,
        "project_id": 1,
        "is_hidden_from_clients": true,
        "mime_type": "image\/png",
        "size": 616656,
        "md5": null,
        "download_url": "http:\/\/feather.dev\/projects\/1\/files\/4\/download",
        "thumbnail_url": "http:\/\/feather.dev\/proxy.php?proxy=forward_thumbnail&module=system&v=current&b=DEV&context=upload&name=2015-04%2F9JeS3Kx2OLS8IUufGUxkXcbNeYGDX8BvbjnMGeqh&original_file_name=sketch.png&width=--WIDTH--&height=--HEIGHT--&ver=616656&scale=--SCALE--",
        "file_meta": {
            "kind": "image",
            "dimensions": {
                "width": 1800,
                "height": 400
            }
        },
        "created_on": 1430164135,
        "created_by_id": 1,
        "updated_on": 1430164135,
        "updated_by_id": 1
    }
]

Lets check project files listing now:

Response: HTTP 200, application/json (Hide)

GET /projects/1/files

Response:

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
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
{
    "files": [
        {
            "id": 4,
            "class": "File",
            "url_path": "\/projects\/1\/files\/4",
            "name": "sketch.png",
            "is_trashed": false,
            "trashed_on": null,
            "trashed_by_id": 0,
            "project_id": 1,
            "is_hidden_from_clients": true,
            "mime_type": "image\/png",
            "size": 616656,
            "md5": null,
            "download_url": "http:\/\/feather.dev\/projects\/1\/files\/4\/download",
            "thumbnail_url": "http:\/\/feather.dev\/proxy.php?proxy=forward_thumbnail&module=system&v=current&b=DEV&context=upload&name=2015-04%2F9JeS3Kx2OLS8IUufGUxkXcbNeYGDX8BvbjnMGeqh&original_file_name=sketch.png&width=--WIDTH--&height=--HEIGHT--&ver=616656&scale=--SCALE--",
            "file_meta": {
                "kind": "image",
                "dimensions": {
                    "width": 1800,
                    "height": 400
                }
            },
            "created_on": 1430164135,
            "created_by_id": 1,
            "updated_on": 1430164135,
            "updated_by_id": 1
        },
        {
            "id": 3,
            "class": "File",
            "url_path": "\/projects\/1\/files\/3",
            "name": "profile.png",
            "is_trashed": false,
            "trashed_on": null,
            "trashed_by_id": 0,
            "project_id": 1,
            "is_hidden_from_clients": true,
            "mime_type": "image\/png",
            "size": 68914,
            "md5": null,
            "download_url": "http:\/\/feather.dev\/projects\/1\/files\/3\/download",
            "thumbnail_url": "http:\/\/feather.dev\/proxy.php?proxy=forward_thumbnail&module=system&v=current&b=DEV&context=upload&name=2015-04%2FQkv22I8liMMuia7IcxEJ0VRqU26RJJ2oUmfKUcV4&original_file_name=profile.png&width=--WIDTH--&height=--HEIGHT--&ver=68914&scale=--SCALE--",
            "file_meta": {
                "kind": "image",
                "dimensions": {
                    "width": 586,
                    "height": 438
                }
            },
            "created_on": 1430164135,
            "created_by_id": 1,
            "updated_on": 1430164135,
            "updated_by_id": 1
        },
        {
            "id": 2,
            "class": "File",
            "url_path": "\/projects\/1\/files\/2",
            "name": "ac-1.png",
            "is_trashed": false,
            "trashed_on": null,
            "trashed_by_id": 0,
            "project_id": 1,
            "is_hidden_from_clients": true,
            "mime_type": "image\/png",
            "size": 1927,
            "md5": null,
            "download_url": "http:\/\/feather.dev\/projects\/1\/files\/2\/download",
            "thumbnail_url": "http:\/\/feather.dev\/proxy.php?proxy=forward_thumbnail&module=system&v=current&b=DEV&context=upload&name=2015-04%2Fs41bOyN4v2gGvAPsGQnzE0okb6PyJfL30B4NZGFk&original_file_name=ac-1.png&width=--WIDTH--&height=--HEIGHT--&ver=1927&scale=--SCALE--",
            "file_meta": {
                "kind": "image",
                "dimensions": {
                    "width": 50,
                    "height": 50
                }
            },
            "created_on": 1430164135,
            "created_by_id": 1,
            "updated_on": 1430164135,
            "updated_by_id": 1
        },
        {
            "id": 1,
            "class": "File",
            "url_path": "\/projects\/1\/files\/1",
            "name": "ac.png",
            "is_trashed": false,
            "trashed_on": null,
            "trashed_by_id": 0,
            "project_id": 1,
            "is_hidden_from_clients": true,
            "mime_type": "image\/png",
            "size": 1927,
            "md5": null,
            "download_url": "http:\/\/feather.dev\/projects\/1\/files\/1\/download",
            "thumbnail_url": "http:\/\/feather.dev\/proxy.php?proxy=forward_thumbnail&module=system&v=current&b=DEV&context=upload&name=2015-04%2FAS5i3kyuNDrRY7ZuAM9lrFh1vw6JDCI5kBbbLAwo&original_file_name=ac.png&width=--WIDTH--&height=--HEIGHT--&ver=1927&scale=--SCALE--",
            "file_meta": {
                "kind": "image",
                "dimensions": {
                    "width": 50,
                    "height": 50
                }
            },
            "created_on": 1430164134,
            "created_by_id": 1,
            "updated_on": 1430164134,
            "updated_by_id": 1
        }
    ],
    "attachment_parents": []
}

Sleeping for 1 seconds

Response: HTTP 200, application/json (Hide)

POST /upload-files

Files:

1
2
3
4
5
6
[
    [
        "ac.png",
        "image\/png"
    ]
]

Response:

1
2
3
4
5
6
7
8
9
[
    {
        "code": "KiX0qxzqvDMAqCApHv7MrbDEPhTCPGcXsbdQAua5",
        "name": "ac.png",
        "mime_type": "image\/png",
        "size": 1927,
        "thumbnail_url": "http:\/\/feather.dev\/proxy.php?proxy=forward_thumbnail&module=system&v=current&b=DEV&context=upload&name=2015-04%2FazXr4uAVM5dXLyiLBa9dveX2af7Re7f3n0lOTYHX&original_file_name=ac.png&width=--WIDTH--&height=--HEIGHT--&ver=1927&scale=--SCALE--"
    }
]

and attach it to a task:

Response: HTTP 200, application/json (Hide)

PUT /projects/1/tasks/1

Payload:

1
2
3
4
5
{
    "attach_uploaded_files": [
        "KiX0qxzqvDMAqCApHv7MrbDEPhTCPGcXsbdQAua5"
    ]
}

Response:

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
{
    "single": {
        "id": 1,
        "class": "Task",
        "url_path": "\/projects\/1\/tasks\/1",
        "name": "Task #1",
        "assignee_id": 0,
        "delegated_by_id": 0,
        "completed_on": null,
        "completed_by_id": null,
        "is_completed": false,
        "comments_count": 0,
        "attachments": [
            {
                "id": 1,
                "name": "ac.png",
                "mime_type": "image\/png",
                "size": 1927,
                "disposition": "attachment",
                "thumbnail_url": "http:\/\/feather.dev\/proxy.php?proxy=forward_thumbnail&module=system&v=current&b=DEV&context=upload&name=2015-04%2FazXr4uAVM5dXLyiLBa9dveX2af7Re7f3n0lOTYHX&original_file_name=ac.png&width=--WIDTH--&height=--HEIGHT--&ver=1927&scale=--SCALE--"
            }
        ],
        "labels": [],
        "is_trashed": false,
        "trashed_on": null,
        "trashed_by_id": 0,
        "project_id": 1,
        "is_hidden_from_clients": true,
        "body": "",
        "body_formatted": "",
        "created_on": 1430164134,
        "created_by_id": 1,
        "updated_on": 1430164136,
        "updated_by_id": 1,
        "task_number": 1,
        "task_list_id": 0,
        "position": 1,
        "is_important": false,
        "due_on": null,
        "estimate": 0,
        "job_type_id": 0,
        "total_subtasks": 0,
        "completed_subtasks": 0,
        "open_subtasks": 0
    },
    "subscribers": [
        1
    ],
    "comments": [],
    "reminders": [],
    "subtasks": [],
    "task_list": null,
    "tracked_time": 0,
    "tracked_expenses": 0
}

Now when we try to load project files, we will see that attachment that we just uploaded is listed:

Response: HTTP 200, application/json (Hide)

GET /projects/1/files

Response:

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
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
{
    "files": [
        {
            "id": 1,
            "class": "Attachment",
            "url_path": "\/attachments\/1",
            "name": "ac.png",
            "parent_type": "Task",
            "parent_id": 1,
            "mime_type": "image\/png",
            "size": 1927,
            "md5": "1e3cd308a17a60b22c61493dcb3af0b0",
            "download_url": "http:\/\/feather.dev\/attachments\/1\/download",
            "thumbnail_url": "http:\/\/feather.dev\/proxy.php?proxy=forward_thumbnail&module=system&v=current&b=DEV&context=upload&name=2015-04%2FazXr4uAVM5dXLyiLBa9dveX2af7Re7f3n0lOTYHX&original_file_name=ac.png&width=--WIDTH--&height=--HEIGHT--&ver=1927&scale=--SCALE--",
            "file_meta": {
                "kind": "image",
                "dimensions": {
                    "width": 50,
                    "height": 50
                }
            },
            "created_on": 1430164136,
            "created_by_id": 1,
            "disposition": "attachment",
            "project_id": 1,
            "is_hidden_from_clients": true
        },
        {
            "id": 4,
            "class": "File",
            "url_path": "\/projects\/1\/files\/4",
            "name": "sketch.png",
            "is_trashed": false,
            "trashed_on": null,
            "trashed_by_id": 0,
            "project_id": 1,
            "is_hidden_from_clients": true,
            "mime_type": "image\/png",
            "size": 616656,
            "md5": null,
            "download_url": "http:\/\/feather.dev\/projects\/1\/files\/4\/download",
            "thumbnail_url": "http:\/\/feather.dev\/proxy.php?proxy=forward_thumbnail&module=system&v=current&b=DEV&context=upload&name=2015-04%2F9JeS3Kx2OLS8IUufGUxkXcbNeYGDX8BvbjnMGeqh&original_file_name=sketch.png&width=--WIDTH--&height=--HEIGHT--&ver=616656&scale=--SCALE--",
            "file_meta": {
                "kind": "image",
                "dimensions": {
                    "width": 1800,
                    "height": 400
                }
            },
            "created_on": 1430164135,
            "created_by_id": 1,
            "updated_on": 1430164135,
            "updated_by_id": 1
        },
        {
            "id": 3,
            "class": "File",
            "url_path": "\/projects\/1\/files\/3",
            "name": "profile.png",
            "is_trashed": false,
            "trashed_on": null,
            "trashed_by_id": 0,
            "project_id": 1,
            "is_hidden_from_clients": true,
            "mime_type": "image\/png",
            "size": 68914,
            "md5": null,
            "download_url": "http:\/\/feather.dev\/projects\/1\/files\/3\/download",
            "thumbnail_url": "http:\/\/feather.dev\/proxy.php?proxy=forward_thumbnail&module=system&v=current&b=DEV&context=upload&name=2015-04%2FQkv22I8liMMuia7IcxEJ0VRqU26RJJ2oUmfKUcV4&original_file_name=profile.png&width=--WIDTH--&height=--HEIGHT--&ver=68914&scale=--SCALE--",
            "file_meta": {
                "kind": "image",
                "dimensions": {
                    "width": 586,
                    "height": 438
                }
            },
            "created_on": 1430164135,
            "created_by_id": 1,
            "updated_on": 1430164135,
            "updated_by_id": 1
        },
        {
            "id": 2,
            "class": "File",
            "url_path": "\/projects\/1\/files\/2",
            "name": "ac-1.png",
            "is_trashed": false,
            "trashed_on": null,
            "trashed_by_id": 0,
            "project_id": 1,
            "is_hidden_from_clients": true,
            "mime_type": "image\/png",
            "size": 1927,
            "md5": null,
            "download_url": "http:\/\/feather.dev\/projects\/1\/files\/2\/download",
            "thumbnail_url": "http:\/\/feather.dev\/proxy.php?proxy=forward_thumbnail&module=system&v=current&b=DEV&context=upload&name=2015-04%2Fs41bOyN4v2gGvAPsGQnzE0okb6PyJfL30B4NZGFk&original_file_name=ac-1.png&width=--WIDTH--&height=--HEIGHT--&ver=1927&scale=--SCALE--",
            "file_meta": {
                "kind": "image",
                "dimensions": {
                    "width": 50,
                    "height": 50
                }
            },
            "created_on": 1430164135,
            "created_by_id": 1,
            "updated_on": 1430164135,
            "updated_by_id": 1
        },
        {
            "id": 1,
            "class": "File",
            "url_path": "\/projects\/1\/files\/1",
            "name": "ac.png",
            "is_trashed": false,
            "trashed_on": null,
            "trashed_by_id": 0,
            "project_id": 1,
            "is_hidden_from_clients": true,
            "mime_type": "image\/png",
            "size": 1927,
            "md5": null,
            "download_url": "http:\/\/feather.dev\/projects\/1\/files\/1\/download",
            "thumbnail_url": "http:\/\/feather.dev\/proxy.php?proxy=forward_thumbnail&module=system&v=current&b=DEV&context=upload&name=2015-04%2FAS5i3kyuNDrRY7ZuAM9lrFh1vw6JDCI5kBbbLAwo&original_file_name=ac.png&width=--WIDTH--&height=--HEIGHT--&ver=1927&scale=--SCALE--",
            "file_meta": {
                "kind": "image",
                "dimensions": {
                    "width": 50,
                    "height": 50
                }
            },
            "created_on": 1430164134,
            "created_by_id": 1,
            "updated_on": 1430164134,
            "updated_by_id": 1
        }
    ],
    "attachment_parents": {
        "Task": {
            "1": {
                "id": 1,
                "class": "Task",
                "url_path": "\/projects\/1\/tasks\/1",
                "name": "Task #1",
                "assignee_id": 0,
                "delegated_by_id": 0,
                "completed_on": null,
                "completed_by_id": null,
                "is_completed": false,
                "comments_count": 0,
                "attachments": [
                    {
                        "id": 1,
                        "name": "ac.png",
                        "mime_type": "image\/png",
                        "size": 1927,
                        "disposition": "attachment",
                        "thumbnail_url": "http:\/\/feather.dev\/proxy.php?proxy=forward_thumbnail&module=system&v=current&b=DEV&context=upload&name=2015-04%2FazXr4uAVM5dXLyiLBa9dveX2af7Re7f3n0lOTYHX&original_file_name=ac.png&width=--WIDTH--&height=--HEIGHT--&ver=1927&scale=--SCALE--"
                    }
                ],
                "labels": [],
                "is_trashed": false,
                "trashed_on": null,
                "trashed_by_id": 0,
                "project_id": 1,
                "is_hidden_from_clients": true,
                "body": "",
                "body_formatted": "",
                "created_on": 1430164134,
                "created_by_id": 1,
                "updated_on": 1430164136,
                "updated_by_id": 1,
                "task_number": 1,
                "task_list_id": 0,
                "position": 1,
                "is_important": false,
                "due_on": null,
                "estimate": 0,
                "job_type_id": 0,
                "total_subtasks": 0,
                "completed_subtasks": 0,
                "open_subtasks": 0
            }
        }
    }
}

System allows update of file's visibility, but other properties are lcoked. If we try to updated them, we will get Bad Request error:

Response: HTTP 400, text/html

PUT /projects/1/files/1

Payload:

1
2
3
{
    "name": "New Name 123"
}

But update of visibility flag will work just fine:

Response: HTTP 200, application/json (Hide)

PUT /projects/1/files/1

Payload:

1
2
3
{
    "is_hidden_from_clients": true
}

Response:

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
{
    "single": {
        "id": 1,
        "class": "File",
        "url_path": "\/projects\/1\/files\/1",
        "name": "ac.png",
        "is_trashed": false,
        "trashed_on": null,
        "trashed_by_id": 0,
        "project_id": 1,
        "is_hidden_from_clients": true,
        "mime_type": "image\/png",
        "size": 1927,
        "md5": null,
        "download_url": "http:\/\/feather.dev\/projects\/1\/files\/1\/download",
        "thumbnail_url": "http:\/\/feather.dev\/proxy.php?proxy=forward_thumbnail&module=system&v=current&b=DEV&context=upload&name=2015-04%2FAS5i3kyuNDrRY7ZuAM9lrFh1vw6JDCI5kBbbLAwo&original_file_name=ac.png&width=--WIDTH--&height=--HEIGHT--&ver=1927&scale=--SCALE--",
        "file_meta": {
            "kind": "image",
            "dimensions": {
                "width": 50,
                "height": 50
            }
        },
        "created_on": 1430164134,
        "created_by_id": 1,
        "updated_on": 1430164137,
        "updated_by_id": 1
    }
}

Lets move a file to trash:

Response: HTTP 200, text/html

DELETE /projects/1/files/1