Skip to content

Files

GET /projects/996424247/folders/130798955/files returns all files for the specified folder, including metadata and file details.
[
  {
    "id": 1254836,
    "name": "sample.png",
    "byte_size": 11830,
    "created_at": "2013-12-31T07:29:58+00:00",
    "updated_at": "2017-10-03T09:36:48+00:00",
    "source": "upload",
    "approved_by_me": false,
    "approved_count": 0,
    "file_type": "png",
    "proof_count": 0,
    "url": "https://companyurl.proofhub.com/files/thumb/user/image.png",
    "creator": {
      "id": 58956234
    }
  },
  {
    "id": 4512451,
    "name": "logo.png",
    "byte_size": 13598,
    "created_at": "2013-12-31T09:26:46+00:00",
    "updated_at": "2017-10-03T09:36:48+00:00",
    "source": "upload",
    "approved_by_me": false,
    "approved_count": 0,
    "file_type": "png",
    "proof_count": 0,
    "url": "https://companyurl.proofhub.com/files/thumb/user/image.png",
    "creator": {
      "id": 58956234
    }
  }
]
POST /projects/23423233/folders/13261847/files creates a new file entry in the specified project folder.

Creating a file requires an attachment ID. You must first upload the file using the Attachments API and then use the returned attachment ID when creating the file.

Request Body

{
  "attachments": [10966416]
}

Multiple attachment IDs can be provided in the attachments array.

201 Created is returned along with the file JSON if the record is created successfully. 403 Forbidden is returned if access is denied.

DELETE /projects/23423233/folders/13261847/files/10966416 deletes the specified file.

204 No Content is returned if the file is deleted successfully. 403 Forbidden is returned if access is denied.