---
title: "Test S3 connection"
method: POST
path: "/v1/integrations/s3/test"
tags: ["Integrations"]
---

# Test S3 connection

`POST /v1/integrations/s3/test`

Test S3 connection with stored credentials.

**Authentication:** API Key required (`x-api-key` header)

**Usage:** Verify your S3 configuration is working correctly. The test will:
1. Connect to the endpoint
2. Verify bucket access
3. Check write permissions by uploading a small test file

**Prerequisite:** S3 must be configured first using `POST /v1/integrations/s3`

**No credits consumed:** This is a diagnostic endpoint.

**Rate Limits:** 60 requests/min (free), 120 requests/min (paid). Headers included in response.

## Response `200`

Connection test successful

- S3TestResponse — Response for S3 connection test
  - `success` boolean, required — Whether the connection test succeeded
  - `message` string, required — Test result message

## Other responses

- `400` — Connection test failed
- `422` — Validation Error
- `429` — Rate limit exceeded

---

[API](https://skmtc.net/pdftemplateapi/apis/templatefox-api.md) · [All operations](https://skmtc.net/pdftemplateapi/apis/templatefox-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pdftemplateapi/templatefox-api/revisions/5673fc0d5fad/schema)