Skip to main content
GET
/
files
/
provider
/
{provider}
/
signed-url
/
{key}
curl -X GET "https://api.tktchurch.com/v1/files/provider/s3/signed-url/uploads/abc123.jpg?expires=30" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

https://storage.example.com/uploads/abc123.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=...
This endpoint requires authentication and the viewFiles permission.

​
Path Parameters

​
provider
string
required
The storage provider. One of:
  • s3: Amazon S3 storage
  • local: Local file storage
​
key
string
required
The storage key/path of the file

​
Query Parameters

​
expires
integer
Number of minutes until the signed URL expires (default: 60)

​
Response

Returns a string containing the signed URL that can be used to access the file.

​
Error Responses

​
error
object
Error details when the request fails
Common error cases:
  • 400 Bad Request: Invalid provider or key
  • 401 Unauthorized: Missing or invalid access token
  • 403 Forbidden: Missing required permission
  • 404 Not Found: File not found
curl -X GET "https://api.tktchurch.com/v1/files/provider/s3/signed-url/uploads/abc123.jpg?expires=30" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

https://storage.example.com/uploads/abc123.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=...