---
title: "Copies the specified file to another company."
method: POST
path: "/companies/{companyId}/files/{fileId}/copy"
tags: ["companyFiles"]
---

# Copies the specified file to another company.

`POST /companies/{companyId}/files/{fileId}/copy`

## Request

- Base URL: `https://api.awork.com/api/v1`
- URL: `https://api.awork.com/api/v1/companies/{companyId}/files/{fileId}/copy`
- Auth: HTTP bearer

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

## Path parameters

- `companyId` string, uuid, required
- `fileId` string, uuid, required

## Request body

- FileCopyForm
  - `entityId` string, uuid, required: The id of the entity the file should be linked to.
  - `entityType` string, required: The type of the linked entity.

## Response `200`

OK

- FileInfo: The file model.
  - `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.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `404`: Not Found

## Changes

- **2026-09-20** `5332322ffca3`: 4 info
  - api operation id `companyFiles_CopyToCompany` removed and replaced with `companyFiles_PostFilesCopyByCompanyNameAndCompanyIdAndFileId`
  - added the non-success response with the status `400`
  - added the non-success response with the status `401`
  - added the non-success response with the status `404`
- **2026-09-17** `1556e0487867`: 1 warning, 1 info
  - deleted the `header` request parameter `Authorization`
  - the endpoint scheme security `oauth2` was added to the API
- **2026-09-12** `8e46cf415581`: 1 info
  - api operation id `CopyToCompany` removed and replaced with `companyFiles_CopyToCompany`
- **2026-08-21** `a13e7c704262`: 1 breaking, 1 info
  - the `entityType` request property's minLength was increased from `0` to `1`
  - response property `entityId` deprecated

[Operation history](https://skmtc.dev/awork-io/apis/api-v1-reference/changes/companies/:companyId/files/:fileId/copy/post.md)

---

[API](https://skmtc.dev/awork-io/apis/api-v1-reference.md) · [All operations](https://skmtc.dev/awork-io/apis/api-v1-reference/llms.txt) · [OpenAPI document](https://skmtc.dev/awork-io/apis/api-v1-reference/revisions/81151fac7e79?raw)