---
title: "Returns all files of the user with the specified id."
method: GET
path: "/users/{userId}/files"
tags: ["userFiles"]
---

# Returns all files of the user with the specified id.

`GET /users/{userId}/files`

Returns all file metadata of the user with the specified id.

<Check title="Required Permissions" icon="key">Any authenticated user.</Check>

## Path parameters

- `userId` string, uuid, required

## Query parameters

- `page` integer
- `pageSize` integer
- `orderby` string
- `filterby` string

## Headers

- `Authorization` string, required

## Response `200`

OK

- FileInfo[]
  - `name` string, nullable — The user-specified name of the file.
  - `description` string, nullable — The description of the file.
  - `id` string, uuid — The id of the file info.
  - `entityId` string, uuid, nullable — Deprecated. The id of the linked entity derived from entity specific owner ids.
  - `projectId` string, uuid, nullable
  - `projectTemplateId` string, uuid, nullable
  - `companyId` string, uuid, nullable
  - `taskId` string, uuid, nullable
  - `taskTemplateId` string, uuid, nullable
  - `userId` string, uuid, nullable
  - `documentId` string, uuid, nullable
  - `fileName` string, nullable — The name of the file.
  - `entityType` string, nullable — The name of the linked entity type.
  - `mimeType` string, nullable — The MIME type of the file.
  - `createdOn` string, date-time — The date this file was created.
  - `createdBy` string, uuid — The id of the user who created this file.
  - `updatedOn` string, date-time — The date this file was last modified.
  - `updatedBy` string, uuid — The id of the user who last modified this file.
  - `fileVersions` FileVersion[], nullable — List of all versions.
    - `id` string, uuid — The id of the file version.
    - `fileInfoId` string, uuid — The id of the file this version belongs to.
    - `version` number, double — The version of the file.
    - `size` integer — The size of the file, in bytes.
    - `width` number, double, nullable — The width if this is an image file.
    - `height` number, double, nullable — The height if this is an image file.
    - `createdOn` string, date-time — The date this file version was created.
    - `createdBy` string, uuid — The id of the user who created this file version.
    - `updatedOn` string, date-time — The date this file version was last modified.
    - `updatedBy` string, uuid — The id of the user who last modified this file version.
  - `isCommentFile` boolean — Whether the file is related to a comment.
  - `externalProvider` string, nullable — The external provider for the file. Like 'google' or 'onedrive'.
  - `externalFileUrl` string, nullable — The file url of the external provider.
  - `isHiddenForConnectUsers` boolean — Whether the file is hidden for connect users.

---

[API](https://skmtc.net/awork-io/apis/api-v1-reference.md) · [All operations](https://skmtc.net/awork-io/apis/api-v1-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/awork-io/api-v1-reference/versions/f784a53f60df/schema)