Skip to main content

Postman

Postman is a popular HTTP client. It supports AWS Signature v4 natively, so you can send authenticated S3 requests to Filebase without writing any code.

Configure AWS Signature​

For each request:

  1. Open the Authorization tab.
  2. Set Type to AWS Signature.
  3. Fill in:
FieldValue
Access KeyYour Filebase access key
Secret KeyYour Filebase secret key
AWS Regionauto
Service Names3

To save time, configure these values once at the Collection level — every request inherits them.

Request URLs​

Filebase accepts both path-style and virtual-host URL formats. Path-style is generally easier in Postman because the bucket and key live in the URL path:

https://s3.filebase.io/<bucket-name>/<object-key>

For example:

OperationMethodURL
List bucketsGEThttps://s3.filebase.io/
List objectsGEThttps://s3.filebase.io/my-bucket/?list-type=2
Head objectHEADhttps://s3.filebase.io/my-bucket/photo.jpg
Get objectGEThttps://s3.filebase.io/my-bucket/photo.jpg
Put objectPUThttps://s3.filebase.io/my-bucket/photo.jpg
Delete objectDELETEhttps://s3.filebase.io/my-bucket/photo.jpg

Upload an object​

  1. Set method to PUT, URL to https://s3.filebase.io/my-bucket/photo.jpg.
  2. Body tab → binary → choose your local file.
  3. Headers tab → add Content-Type: image/jpeg (or whatever's appropriate).
  4. Authorization tab → AWS Signature, configured as above.
  5. Send.

A 200 OK with an ETag response header means success.

Pre-signed URL via Postman​

You can use Postman's pre-request scripts to compute pre-signed URLs without an SDK:

Pre-request Script
// In a Collection variable, set: filebaseKey, filebaseSecret, bucket, key, expiresIn
const accessKey = pm.collectionVariables.get('filebaseKey');
const secretKey = pm.collectionVariables.get('filebaseSecret');
// ... compute SigV4 signature ...
// Set as a request URL or environment variable

For one-off pre-signing the AWS CLI is faster. For repeated automation use the AWS SDK in your preferred language.

Generated SDK code​

Postman's Code Snippet feature can export your request as code in many languages — useful for translating an exploratory Postman session into application code.

What's next​