Delete AWS Private Connection
AWS Integration
Delete AWS Private Connection
Permanently remove an AWS S3 private connection
DELETE
Delete AWS Private Connection
Documentation Index
Fetch the complete documentation index at: https://docs.pictory.ai/llms.txt
Use this file to discover all available pages before exploring further.
Overview
This endpoint allows you to permanently delete an AWS S3 private connection from your Pictory account. Once deleted, the connection cannot be recovered and any video creation workflows using this connection will fail.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
Remove Unused Connections
Clean up connections that are no longer needed
Security Cleanup
Remove connections for decommissioned AWS accounts
Connection Migration
Delete old connections after migrating to new AWS infrastructure
Account Cleanup
Remove test or development connections
API Endpoint
Request Parameters
Path Parameters
The unique identifier of the AWS connection you want to delete. This is the
connectionId value returned when you created the connection.Headers
API key for authentication (starts with Get your API key from the API Access page in your Pictory dashboard.
pictai_)Response
Success Response
A successful deletion returns 204 No Content with an empty response body. This is the standard HTTP status code for successful deletions. Status Code:204 No Content
Response Body: None (empty)
Response Examples
Code Examples
Common Use Cases
Safe Deletion with Confirmation
Delete After Migration
Bulk Cleanup
Delete with Audit Trail
Error Handling
404 Not Found
404 Not Found
Cause: The connection ID does not exist or has already been deletedSolution:
- Verify the connection ID is correct
- Use the Get AWS Connections endpoint to list all available connections
- Check if the connection was already deleted
401 Unauthorized
401 Unauthorized
403 Forbidden
403 Forbidden
Cause: You do not have permission to delete this connectionSolution:
- Verify the connection belongs to your account
- Check that your API key has the necessary permissions
- Contact support if you believe you should have access
409 Conflict - Connection In Use
409 Conflict - Connection In Use
Cause: The connection is currently being used by active video projectsSolution:
- Check for active videos using this connection
- Wait for ongoing video rendering to complete
- Update video projects to use a different connection
- Disable the connection instead of deleting it
Important Considerations
Alternative to DeletionInstead of permanently deleting a connection, consider:
- Disabling it: Set
enabled: falseusing the Update endpoint - Renaming it: Add “DEPRECATED” to the name to mark it as inactive
- This preserves the configuration for future reference while preventing its use
Deletion Impact
When you delete an AWS connection:-
Immediate Effects:
- Connection ID becomes invalid immediately
- Cannot be used in new video creation requests
- Connection appears in no API listings
-
Video Projects:
- Existing videos remain accessible
- New videos cannot be created using this connection
- In-progress videos using this connection may fail
-
Cannot Be Undone:
- Deleted connections cannot be recovered
- Must create a new connection to restore access
- New connection will have a different connection ID
Next Steps
List All Connections
View all connections before deleting
Get Connection Details
Verify connection details before deletion
Get API Key
Access your API key from your Pictory dashboard
Create New Connection
Set up a replacement connection
