Menu

Expand
Rate this page:

Function Version

Function Versions are specific versions of JavaScript Node.js code that execute at a particular domain.

The steps to create Functions are as follows:

  1. Create a Function
  2. Create a Function Version (this resource) by making a POST request to https://serverless-upload.twilio.com

You will need the Function Version SID that the create request returns to include this Function in a Build.

Function Version properties

Resource Properties in REST API format
sid
sid<ZN> Not PII

The unique string that we created to identify the Function Version resource.

account_sid
sid<AC> Not PII

The SID of the Account that created the Function Version resource.

service_sid
sid<ZS> Not PII

The SID of the Service that the Function Version resource is associated with.

function_sid
sid<ZH> Not PII

The SID of the Function resource that is the parent of the Function Version resource.

path

The URL-friendly string by which the Function Version resource can be referenced. It can be a maximum of 255 characters. All paths begin with a forward slash ('/'). If a Function Version creation request is submitted with a path not containing a leading slash, the path will automatically be prepended with one.

visibility
enum:visibility Not PII

The access control that determines how the Function Version resource can be accessed. Can be: public, protected, or private.

date_created
date_time<iso8601> Not PII

The date and time in GMT when the Function Version resource was created specified in ISO 8601 format.

url
url Not PII

The absolute URL of the Function Version resource.

links
uri_map Not PII

Create a Function Version resource

Create a Function Version resource to upload the function body to a Function resource. The Function 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}/Functions/{FunctionSid}/Versions

The following example creates a Function Version resource using curl and an external file, file_name.js, which contains the function body.

curl -X POST "https://serverless-upload.twilio.com/v1/Services/{ServiceSid}/Functions/{FunctionSid}/Versions" \
-F "Content=@file_name.js; type=application/javascript" \
-F "Path=/hi" \
-F "Visibility=public" \
-u "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX:your_auth_token"

The create action is not supported by the helper libraries.

The create action accepts these parameters:

Parameter Description
Content The function code to upload.
FunctionSid The SID of the Function resource to upload this function code to.
Path The path to assign the function. Must be URL Friendly, without fragments, and ;,?:@+&$()' " are disallowed).
ServiceSid The SID of the Function's Service.
Visibility The visibility of the function. Can be public, protected, or private.

Fetch a FunctionVersion resource

get
https://serverless.twilio.com/v1/Services/{ServiceSid}/Functions/{FunctionSid}/Versions/{Sid}
Parameters
Parameters in REST API format
service_sid
Path
get sid_like<ZS> Not PII

The SID of the Service to fetch the Function Version resource from.

function_sid
Path
get sid<ZH> Not PII

The SID of the function that is the parent of the Function Version resource to fetch.

sid
Path
get sid<ZN> Not PII

The SID of the Function Version resource to fetch.

Example 1
        
        
        
        

        Read multiple FunctionVersion resources

        get
        https://serverless.twilio.com/v1/Services/{ServiceSid}/Functions/{FunctionSid}/Versions
        Parameters
        Parameters in REST API format
        service_sid
        Path
        get sid_like<ZS> Not PII

        The SID of the Service to read the Function Version resources from.

        function_sid
        Path
        get sid<ZH> Not PII

        The SID of the function that is the parent of the Function Version resources to read.

        Example 1
              
              
              
              
              Rate this page:

              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 browsing the Twilio tag on Stack Overflow.

                    
                    
                    

                    Thank you for your feedback!

                    We are always striving to improve our documentation quality, and your feedback is valuable to us. How could this documentation serve you better?

                    Sending your feedback...
                    🎉 Thank you for your feedback!
                    Something went wrong. Please try again.

                    Thanks for your feedback!

                    Refer us and get $10 in 3 simple steps!

                    Step 1

                    Get link

                    Get a free personal referral link here

                    Step 2

                    Give $10

                    Your user signs up and upgrade using link

                    Step 3

                    Get $10

                    1,250 free SMSes
                    OR 1,000 free voice mins
                    OR 12,000 chats
                    OR more