# Register an uploaded S3 object as a file (internal)

**POST /common/file/add**

Desktop plumbing: registers an object already in the user-data bucket as a file record (name from the key, content type from `type` or from S3) and returns it; a key that is already registered returns the existing record. Returns 404 when the key is not in the bucket. Keys in folders the API writes itself (email bodies, certificates, statements, exports, logs, device backups) cannot be registered (403).


## Servers
- http://api.example.com: http://api.example.com ()


## Authentication methods
- Access token


## Parameters



### Body: application/json (object)

- **fileKey** (string)
  S3 file key (path in bucket)

- **type** (string)
  Override content type (e.g. "application/pdf"). If not provided, uses the content type from S3.



## Responses
### 201


#### Body: application/json (object)
- **data** (object)

- **statusCode** (number)

- **timestamp** (string(date-time))



[Powered by Bump.sh](https://bump.sh)