Skip to main content
GET
Get AWS Private Connections

Overview

This endpoint retrieves a list of all AWS S3 private connections you have configured for your Pictory account. Use this to view your existing connections, check their status, and get connection IDs for use in video creation requests.
You need a valid API key to use this endpoint. Get your API key from the API Access page in your Pictory dashboard.

Use Cases

View All Connections

See all your configured AWS S3 connections in one place

Get Connection IDs

Retrieve connection IDs to use in video creation requests

Check Status

Verify which connections are currently enabled or disabled

Audit Configuration

Review your AWS account IDs and regions

API Endpoint


Request Parameters

Headers

string
required
API key for authentication (starts with pictai_)
Get your API key from the API Access page in your Pictory dashboard.

Response

Returns an array of AWS connection objects in the Items field. If no connections are configured, returns an empty array.

Response Examples


Code Examples

Replace YOUR_API_KEY with your actual API key that starts with pictai_

Common Use Cases

Find Connection ID for Video Creation

When creating videos with private S3 assets, you need to provide the awsConnectionId. Use this endpoint to retrieve it:

Check if Connections are Enabled

List All Regions


Next Steps

Create AWS Connection

Set up a new AWS S3 private connection

Use in Videos

Learn how to use connection IDs in video creation

Get API Key

Access your API key from your Pictory dashboard

Troubleshooting

Common issues and solutions