Destinations
Destinations define where uploaded images are delivered. Each project can have multiple destinations of different types.
Destination Types
Apertur supports several destination types for delivering images after upload.
| Type | Description |
|---|---|
| webhook | HTTP POST to your endpoint with the image payload |
| s3 | Upload to an Amazon S3 bucket |
| gcs | Upload to a Google Cloud Storage bucket |
| google_drive | Save to a Google Drive folder (OAuth required) |
| dropbox | Save to a Dropbox folder (OAuth required) |
List Destinations
GET
/api/v1/projects/:projectId/destinationsRetrieve all destinations configured for a project.
curl https://api.apertur.ca/api/v1/projects/proj_.../destinations \ -H "Authorization: Bearer aptr_live_xxxx"
Create a Destination
POST
/api/v1/projects/:projectId/destinationsAdd a new delivery destination to a project.
| Field | Type | Description |
|---|---|---|
| type | string | Destination type (webhook, s3, gcs, google_drive, dropbox) |
| name | string | Human-readable label for the destination |
| config | object | Type-specific configuration object (url, bucket, folder, etc.) |
curl -X POST https://api.apertur.ca/api/v1/projects/proj_.../destinations \
-H "Authorization: Bearer aptr_live_xxxx" \
-H "Content-Type: application/json" \
-d '{
"type": "webhook",
"name": "My Backend",
"config": {
"url": "https://api.example.com/photos",
"format": "json_base64"
}
}'Test, Update & Delete
Send a test delivery, toggle a destination on/off, or remove it entirely.
# Test a destination
curl -X POST https://api.apertur.ca/api/v1/projects/proj_.../destinations/dest_.../test \
-H "Authorization: Bearer aptr_live_xxxx"
# Update a destination
curl -X PATCH https://api.apertur.ca/api/v1/projects/proj_.../destinations/dest_... \
-H "Authorization: Bearer aptr_live_xxxx" \
-H "Content-Type: application/json" \
-d '{"isActive": false}'
# Delete a destination
curl -X DELETE https://api.apertur.ca/api/v1/projects/proj_.../destinations/dest_... \
-H "Authorization: Bearer aptr_live_xxxx"