Asset Version
Asset Versions are specific instances of static files that you can host at a particular domain in an Environment.
The steps to create Assets are as follows:
- Create an Asset
- Create an Asset Version (this resource)
You will need the Asset Version SID that the create request returns to include this Asset in a Build.
Asset Version properties
Resource Properties in REST API format | |
---|---|
sid
|
The unique string that we created to identify the Asset Version resource. |
account_sid
|
The SID of the Account that created the Asset Version resource. |
service_sid
|
The SID of the Service that the Asset Version resource is associated with. |
asset_sid
|
The SID of the Asset resource that is the parent of the Asset Version. |
path
|
The URL-friendly string by which the Asset Version can be referenced. It can be a maximum of 255 characters. All paths begin with a forward slash ('/'). If an Asset Version creation request is submitted with a path not containing a leading slash, the path will automatically be prepended with one. |
visibility
|
The access control that determines how the Asset Version resource can be accessed. Can be: |
date_created
|
The date and time in GMT when the Asset Version resource was created specified in ISO 8601 format. |
url
|
The absolute URL of the Asset Version resource. |
Create an Asset Version resource
Create an Asset Version resource to upload a file to an Asset resource. The Asset Version resource is created by making a POST request to a dedicated URL—a URL that is different from the URL used to read and fetch the resource.
https://serverless-upload.twilio.com/v1/Services/ {ServiceSid}/Assets/{AssetSid}/Versions
The following example creates an Asset Version resource using the language of your choice (or curl) and an external file, my-asset.png
, which contains the Asset to upload.
Note that the Serverless upload endpoint is on a different subdomain from the rest of the Serverless API (serverless-upload.twilio.com
instead of serverless.twilio.com
), and is not supported by the Twilio Helper Libraries at this time.
The create
action accepts these parameters:
Parameter | Description |
Content |
The asset to upload. |
AssetSid |
The SID of the Asset resource to upload this asset to. |
Path |
The path to assign the asset. Must be URL Friendly, without fragments, and ;,?:@+&$()' " are disallowed). |
ServiceSid |
The SID of the Asset's Service. |
Visibility |
The visibility of the asset. Can be public , protected , or private . |
Fetch an AssetVersion resource
https://serverless.twilio.com/v1/Services/{ServiceSid}/Assets/{AssetSid}/Versions/{Sid}
Parameters
Parameters in REST API format | |
---|---|
service_sid
Path
|
The SID of the Service to fetch the Asset Version resource from. |
asset_sid
Path
|
The SID of the Asset resource that is the parent of the Asset Version resource to fetch. |
sid
Path
|
The SID of the Asset Version resource to fetch. |
Example 1
Read multiple AssetVersion resources
https://serverless.twilio.com/v1/Services/{ServiceSid}/Assets/{AssetSid}/Versions
Parameters
Parameters in REST API format | |
---|---|
service_sid
Path
|
The SID of the Service to read the Asset Version resource from. |
asset_sid
Path
|
The SID of the Asset resource that is the parent of the Asset Version resources to read. |
Example 1
Need some help?
We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd by visiting Twilio's Stack Overflow Collective or browsing the Twilio tag on Stack Overflow.