Create file record

POST

/files

Create a file record after successful upload

After uploading a file using the signed URL, use this endpoint to create a file record
in the system. The file metadata will be automatically retrieved from storage.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.perfectworks.io/api/v0/files' \
--header 'Content-Type: application/json' \
--data-raw '{
    "objectKey": "document_4f2a1b3c.pdf",
    "filename": "document.pdf"
}'

Response Example

201 - Example 1

{
    "success": true,
    "message": "Operation completed successfully",
    "data": {
        "id": "123",
        "name": "Example"
    }
}

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/json

Examples

Responses

🟢201Created

application/json

File created successfully

Body

🟠400Bad Request

🟠401Unauthorized

🔴500Server Error

Modified at 2025-08-22 18:48:44

Generate signed upload URL

List files