Sequin Proxy URLs for Airtable attachments
You might have already noticed
https://proxy.sequin.io/attachment/* URLs in your Sequin database. While Airtable's attachment URLs expire every two hours,1 these proxy URLs do not expire.
Resolving attachment URLs
Authenticate requests for attachments through Sequin's proxy according to Airtable's API Authentication guidelines, providing your Airtable personal access token:
$ curl https://proxy.sequin.io/attachment/▒▒▒▒▒▒▒▒▒ \
-H "Authorization: Bearer key▒▒▒▒▒▒▒▒▒"
A successful request receives a
302 Found redirect to the attachment's Airtable-provided temporary address.
Because resolving a current expiring URL requires retrieving the attachment's parent record, each request will consume an API call from your quota.
Because this impacts the general availability of attachments, and because your Airtable account API token is secret, this behavior may be unsuitable for some applications — e.g. embedding attachments in a public static page. Airtable discourages using their system as a CDN.2
401 Not Authorizedresponse indicates Sequin couldn't find an
Authorizationheader in your request.
403 Forbiddenerror indicates the provided key lacks API access to the Airtable record with the requested attachment.
If you're having trouble using attachment URLs, send us a note! Please include a valid attachment URL from your sync table and a description of how you're making requests.
How attachment URLs work
Each proxy attachment URL:
Requires you provide an Airtable
Bearertoken in your requests.
Bearertoken to fetch an expiring attachment URL from Airtable.
Responds to you request with a
302 Foundredirect to the expiring URL.
If you change an attachment in Airtable, the change in Airtable's unique attachment ID (of the form
att▒▒▒▒▒▒▒▒▒▒▒▒▒▒) leads Sequin to update the proxy URL in the corresponding Postgres row.
Like Airtable, we do not consider the attachment URL formatting part of our compatibility surface, so users should not attempt to parse or interpret attachment field URLs.
Changes to Airtable attachments.. From "What's changing:"
Any attachment URLs obtained via the Airtable Web API and the CSV export functionality will expire after a few hours.
"Changes to Airtable attachments." From the FAQ:
I use APIs to obtain an URL to an Airtable attachment, and this usage is integrated with other tools, e.g. Zapier. It seems the URLs will expire. What should I do?
If you or a third party integration are using API processes to obtain attachment URLs from Airtable, then it’s important to note that the URLs obtained will only be active for a short period of time (~2 hours). Using Airtable as a CDN has been and continues to be discouraged in line with this change.