Skip to main content
DELETE
Delete AWS Private Connection

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.
This action is permanent and cannot be undone. Before deleting a connection, ensure:
  • No active video projects are using this connection
  • You have documented the connection settings if you may need them again
  • Consider disabling the connection temporarily instead of deleting it

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

connectionid
string
required
The unique identifier of the AWS connection you want to delete. This is the connectionId value returned when you created the connection.

Headers

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

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

Replace YOUR_API_KEY with your actual API key that starts with pictai_Replace YOUR_CONNECTION_ID with the actual connection ID you want to delete

Common Use Cases

Safe Deletion with Confirmation

Delete After Migration

Bulk Cleanup

Delete with Audit Trail


Error Handling

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
Cause: Invalid or missing API keySolution:
  • Verify your API key is correct and starts with pictai_
  • Check the Authorization header is properly formatted: YOUR_API_KEY
  • Ensure your API key hasn’t expired
  • Get a new API key from the API Access page
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
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

Before Deleting a Connection
  1. Check for active usage: Ensure no videos are currently being processed with this connection
  2. Document settings: Save the AWS Account ID, Region, and IAM role configuration if you may need to recreate it
  3. Update workflows: Modify any automated workflows that reference this connection ID
  4. Consider disabling: Use the Update endpoint to disable instead of delete
Alternative to DeletionInstead of permanently deleting a connection, consider:
  • Disabling it: Set enabled: false using 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
When to Delete vs DisableDelete when:
  • AWS account has been closed
  • Connection was created for testing only
  • Security requires removing all traces of the connection
Disable when:
  • Temporarily pausing usage
  • May need to re-enable later
  • Want to preserve configuration for reference

Deletion Impact

When you delete an AWS connection:
  1. Immediate Effects:
    • Connection ID becomes invalid immediately
    • Cannot be used in new video creation requests
    • Connection appears in no API listings
  2. Video Projects:
    • Existing videos remain accessible
    • New videos cannot be created using this connection
    • In-progress videos using this connection may fail
  3. 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