---
title: "Get a file"
method: GET
path: "/v2/files/{file_id}"
tags: ["Files"]
---

# Get a file

`GET /v2/files/{file_id}`

Get a single file entry by ID.

This endpoint is in beta. We will aim to avoid breaking changes, but small updates may be made as we roll out to more users.

Required scopes: `file:read`, `object_configuration:read`, `record_permission:read`.

## Path parameters

- `file_id` string, uuid, required — A UUID which identifies the file entry.

## Response `200`

Success

- object — Success
  - `data` union, required
    - File
      - `id` object, required
        - `workspace_id` string, uuid, required — The ID of the workspace the file belongs to.
        - `file_id` string, uuid, required — The ID of the file entry.
      - `object_id` string, uuid, required — The ID of the object the record belongs to.
      - `object_slug` string, required — The slug of the object the record belongs to.
      - `record_id` string, uuid, required — The ID of the record the file is linked to.
      - `storage_provider` 'attio' | 'dropbox' | 'box' | 'google-drive' | 'microsoft-onedrive', required — The storage provider for this file entry.
      - `created_by_actor` object, required — The actor that created this file entry.
        - `id` string, nullable — An ID to identify the actor.
        - `type` 'api-token' | 'workspace-member' | 'system' | 'app', nullable — The type of actor. [Read more information on actor types here](/docs/actors).
      - `created_at` string, required — Timestamp representing when the file entry was created.
      - `file_type` 'file', required — The type of file entry.
      - `name` string, required — The name of the file.
      - `content_type` string, nullable, required — The content type of the file.
      - `content_size` number, nullable, required — The size of the file in bytes.
      - `parent_folder_id` string, uuid, nullable, required — The ID of the parent folder, or null if this is a top-level file.
    - object
      - `id` object, required
        - `workspace_id` string, uuid, required — The ID of the workspace the file belongs to.
        - `file_id` string, uuid, required — The ID of the file entry.
      - `object_id` string, uuid, required — The ID of the object the record belongs to.
      - `object_slug` string, required — The slug of the object the record belongs to.
      - `record_id` string, uuid, required — The ID of the record the file is linked to.
      - `storage_provider` 'attio' | 'dropbox' | 'box' | 'google-drive' | 'microsoft-onedrive', required — The storage provider for this file entry.
      - `created_by_actor` object, required — The actor that created this file entry.
        - `id` string, nullable — An ID to identify the actor.
        - `type` 'api-token' | 'workspace-member' | 'system' | 'app', nullable — The type of actor. [Read more information on actor types here](/docs/actors).
      - `created_at` string, required — Timestamp representing when the file entry was created.
      - `file_type` 'folder', required — The type of file entry.
      - `name` string, required — The name of the folder.
      - `parent_folder_id` string, uuid, nullable, required — The ID of the parent folder, or null if this is a top-level folder.
      - `has_children` boolean, required — Whether the folder contains any child entries.
    - ConnectedFile
      - `id` object, required
        - `workspace_id` string, uuid, required — The ID of the workspace the file belongs to.
        - `file_id` string, uuid, required — The ID of the file entry.
      - `object_id` string, uuid, required — The ID of the object the record belongs to.
      - `object_slug` string, required — The slug of the object the record belongs to.
      - `record_id` string, uuid, required — The ID of the record the file is linked to.
      - `storage_provider` 'attio' | 'dropbox' | 'box' | 'google-drive' | 'microsoft-onedrive', required — The storage provider for this file entry.
      - `created_by_actor` object, required — The actor that created this file entry.
        - `id` string, nullable — An ID to identify the actor.
        - `type` 'api-token' | 'workspace-member' | 'system' | 'app', nullable — The type of actor. [Read more information on actor types here](/docs/actors).
      - `created_at` string, required — Timestamp representing when the file entry was created.
      - `file_type` 'connected-file', required — The type of file entry.
      - `external_provider_file_id` string, required — The file ID in the external storage provider.
      - `microsoft_drive_id` string, nullable, required — Microsoft drive ID. This field is only populated for `microsoft-onedrive` entries.
    - ConnectedFolder
      - `id` object, required
        - `workspace_id` string, uuid, required — The ID of the workspace the file belongs to.
        - `file_id` string, uuid, required — The ID of the file entry.
      - `object_id` string, uuid, required — The ID of the object the record belongs to.
      - `object_slug` string, required — The slug of the object the record belongs to.
      - `record_id` string, uuid, required — The ID of the record the file is linked to.
      - `storage_provider` 'attio' | 'dropbox' | 'box' | 'google-drive' | 'microsoft-onedrive', required — The storage provider for this file entry.
      - `created_by_actor` object, required — The actor that created this file entry.
        - `id` string, nullable — An ID to identify the actor.
        - `type` 'api-token' | 'workspace-member' | 'system' | 'app', nullable — The type of actor. [Read more information on actor types here](/docs/actors).
      - `created_at` string, required — Timestamp representing when the file entry was created.
      - `file_type` 'connected-folder', required — The type of file entry.
      - `external_provider_file_id` string, required — The file ID in the external storage provider.
      - `microsoft_drive_id` string, nullable, required — Microsoft drive ID. This field is only populated for `microsoft-onedrive` entries.

## Other responses

- `404` — Not Found

---

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