Generate signed upload URL

POST

/files/upload-url

Generate a signed upload URL for file upload

This endpoint generates a pre-signed URL that allows direct upload to cloud storage.
The client should use this URL to upload the file directly, then call the create file endpoint
to register the file in the system.

Request Example

Shell

JavaScript

Java

Swift

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

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

Signed upload URL generated successfully

Body

🟠400Bad Request

🟠401Unauthorized

🔴500Server Error

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

Permanently delete organization

Create file record