Twilio - Serverless — Services

naftiko: 1.0.0-alpha2
info:
  label: Twilio - Serverless — Services
  description: 'Twilio - Serverless — Services. 39 operations. Lead operation: Services. Self-contained Naftiko capability
    covering one Twilio business surface.'
  tags:
  - Twilio
  - Services
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    TWILIO_API_KEY: TWILIO_API_KEY
capability:
  consumes:
  - type: http
    namespace: serverless-services
    baseUri: https://serverless.twilio.com
    description: Twilio - Serverless — Services business capability. Self-contained, no shared references.
    resources:
    - name: v1-Services
      path: /v1/Services
      operations:
      - name: listservice
        method: GET
        description: Retrieve a list of all Services.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: PageSize
          in: query
          type: integer
          description: How many resources to return in each list page. The default is 50, and the maximum is 1000.
        - name: Page
          in: query
          type: integer
          description: The page index. This value is simply for client state.
        - name: PageToken
          in: query
          type: string
          description: The page token. This is provided by the API.
      - name: createservice
        method: POST
        description: Create a new Service resource.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: v1-Services-ServiceSid-Assets
      path: /v1/Services/{ServiceSid}/Assets
      operations:
      - name: listasset
        method: GET
        description: Retrieve a list of all Assets.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: ServiceSid
          in: path
          type: string
          description: The SID of the Service to read the Asset resources from.
          required: true
        - name: PageSize
          in: query
          type: integer
          description: How many resources to return in each list page. The default is 50, and the maximum is 1000.
        - name: Page
          in: query
          type: integer
          description: The page index. This value is simply for client state.
        - name: PageToken
          in: query
          type: string
          description: The page token. This is provided by the API.
      - name: createasset
        method: POST
        description: Create a new Asset resource.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: ServiceSid
          in: path
          type: string
          description: The SID of the Service to create the Asset resource under.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: v1-Services-ServiceSid-Assets-AssetSid-Versions
      path: /v1/Services/{ServiceSid}/Assets/{AssetSid}/Versions
      operations:
      - name: listassetversion
        method: GET
        description: Retrieve a list of all Asset Versions.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: ServiceSid
          in: path
          type: string
          description: The SID of the Service to read the Asset Version resource from.
          required: true
        - name: AssetSid
          in: path
          type: string
          description: The SID of the Asset resource that is the parent of the Asset Version resources to read.
          required: true
        - name: PageSize
          in: query
          type: integer
          description: How many resources to return in each list page. The default is 50, and the maximum is 1000.
        - name: Page
          in: query
          type: integer
          description: The page index. This value is simply for client state.
        - name: PageToken
          in: query
          type: string
          description: The page token. This is provided by the API.
    - name: v1-Services-ServiceSid-Assets-AssetSid-Versions-Sid
      path: /v1/Services/{ServiceSid}/Assets/{AssetSid}/Versions/{Sid}
      operations:
      - name: fetchassetversion
        method: GET
        description: Retrieve a specific Asset Version.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: ServiceSid
          in: path
          type: string
          description: The SID of the Service to fetch the Asset Version resource from.
          required: true
        - name: AssetSid
          in: path
          type: string
          description: The SID of the Asset resource that is the parent of the Asset Version resource to fetch.
          required: true
        - name: Sid
          in: path
          type: string
          description: The SID of the Asset Version resource to fetch.
          required: true
    - name: v1-Services-ServiceSid-Assets-Sid
      path: /v1/Services/{ServiceSid}/Assets/{Sid}
      operations:
      - name: fetchasset
        method: GET
        description: Retrieve a specific Asset resource.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: ServiceSid
          in: path
          type: string
          description: The SID of the Service to fetch the Asset resource from.
          required: true
        - name: Sid
          in: path
          type: string
          description: The SID that identifies the Asset resource to fetch.
          required: true
      - name: deleteasset
        method: DELETE
        description: Delete an Asset resource.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: ServiceSid
          in: path
          type: string
          description: The SID of the Service to delete the Asset resource from.
          required: true
        - name: Sid
          in: path
          type: string
          description: The SID that identifies the Asset resource to delete.
          required: true
      - name: updateasset
        method: POST
        description: Update a specific Asset resource.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: ServiceSid
          in: path
          type: string
          description: The SID of the Service to update the Asset resource from.
          required: true
        - name: Sid
          in: path
          type: string
          description: The SID that identifies the Asset resource to update.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: v1-Services-ServiceSid-Builds
      path: /v1/Services/{ServiceSid}/Builds
      operations:
      - name: listbuild
        method: GET
        description: Retrieve a list of all Builds.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: ServiceSid
          in: path
          type: string
          description: The SID of the Service to read the Build resources from.
          required: true
        - name: PageSize
          in: query
          type: integer
          description: How many resources to return in each list page. The default is 50, and the maximum is 1000.
        - name: Page
          in: query
          type: integer
          description: The page index. This value is simply for client state.
        - name: PageToken
          in: query
          type: string
          description: The page token. This is provided by the API.
      - name: createbuild
        method: POST
        description: Create a new Build resource. At least one function version or asset version is required.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: ServiceSid
          in: path
          type: string
          description: The SID of the Service to create the Build resource under.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: v1-Services-ServiceSid-Builds-Sid
      path: /v1/Services/{ServiceSid}/Builds/{Sid}
      operations:
      - name: fetchbuild
        method: GET
        description: Retrieve a specific Build resource.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: ServiceSid
          in: path
          type: string
          description: The SID of the Service to fetch the Build resource from.
          required: true
        - name: Sid
          in: path
          type: string
          description: The SID of the Build resource to fetch.
          required: true
      - name: deletebuild
        method: DELETE
        description: Delete a Build resource.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: ServiceSid
          in: path
          type: string
          description: The SID of the Service to delete the Build resource from.
          required: true
        - name: Sid
          in: path
          type: string
          description: The SID of the Build resource to delete.
          required: true
    - name: v1-Services-ServiceSid-Builds-Sid-Status
      path: /v1/Services/{ServiceSid}/Builds/{Sid}/Status
      operations:
      - name: fetchbuildstatus
        method: GET
        description: Retrieve a specific Build resource.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: ServiceSid
          in: path
          type: string
          description: The SID of the Service to fetch the Build resource from.
          required: true
        - name: Sid
          in: path
          type: string
          description: The SID of the Build resource to fetch.
          required: true
    - name: v1-Services-ServiceSid-Environments
      path: /v1/Services/{ServiceSid}/Environments
      operations:
      - name: listenvironment
        method: GET
        description: Retrieve a list of all environments.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: ServiceSid
          in: path
          type: string
          description: The SID of the Service to read the Environment resources from.
          required: true
        - name: PageSize
          in: query
          type: integer
          description: How many resources to return in each list page. The default is 50, and the maximum is 1000.
        - name: Page
          in: query
          type: integer
          description: The page index. This value is simply for client state.
        - name: PageToken
          in: query
          type: string
          description: The page token. This is provided by the API.
      - name: createenvironment
        method: POST
        description: Create a new environment.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: ServiceSid
          in: path
          type: string
          description: The SID of the Service to create the Environment resource under.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: v1-Services-ServiceSid-Environments-EnvironmentSid-Deployments
      path: /v1/Services/{ServiceSid}/Environments/{EnvironmentSid}/Deployments
      operations:
      - name: listdeployment
        method: GET
        description: Retrieve a list of all Deployments.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: ServiceSid
          in: path
          type: string
          description: The SID of the Service to read the Deployment resources from.
          required: true
        - name: EnvironmentSid
          in: path
          type: string
          description: The SID of the Environment used by the Deployment resources to read.
          required: true
        - name: PageSize
          in: query
          type: integer
          description: How many resources to return in each list page. The default is 50, and the maximum is 1000.
        - name: Page
          in: query
          type: integer
          description: The page index. This value is simply for client state.
        - name: PageToken
          in: query
          type: string
          description: The page token. This is provided by the API.
      - name: createdeployment
        method: POST
        description: Create a new Deployment.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: ServiceSid
          in: path
          type: string
          description: The SID of the Service to create the Deployment resource under.
          required: true
        - name: EnvironmentSid
          in: path
          type: string
          description: The SID of the Environment for the Deployment.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: v1-Services-ServiceSid-Environments-EnvironmentSid-Deployments-Sid
      path: /v1/Services/{ServiceSid}/Environments/{EnvironmentSid}/Deployments/{Sid}
      operations:
      - name: fetchdeployment
        method: GET
        description: Retrieve a specific Deployment.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: ServiceSid
          in: path
          type: string
          description: The SID of the Service to fetch the Deployment resource from.
          required: true
        - name: EnvironmentSid
          in: path
          type: string
          description: The SID of the Environment used by the Deployment to fetch.
          required: true
        - name: Sid
          in: path
          type: string
          description: The SID that identifies the Deployment resource to fetch.
          required: true
    - name: v1-Services-ServiceSid-Environments-EnvironmentSid-Logs
      path: /v1/Services/{ServiceSid}/Environments/{EnvironmentSid}/Logs
      operations:
      - name: listlog
        method: GET
        description: Retrieve a list of all logs.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: ServiceSid
          in: path
          type: string
          description: The SID of the Service to read the Log resource from.
          required: true
        - name: EnvironmentSid
          in: path
          type: string
          description: The SID of the environment with the Log resources to read.
          required: true
        - name: FunctionSid
          in: query
          type: string
          description: The SID of the function whose invocation produced the Log resources to read.
        - name: StartDate
          in: query
          type: string
          description: The date/time (in GMT, ISO 8601) after which the Log resources must have been created. Defaults to
            1 day prior to current date/time.
        - name: EndDate
          in: query
          type: string
          description: The date/time (in GMT, ISO 8601) before which the Log resources must have been created. Defaults to
            current date/time.
        - name: PageSize
          in: query
          type: integer
          description: How many resources to return in each list page. The default is 50, and the maximum is 1000.
        - name: Page
          in: query
          type: integer
          description: The page index. This value is simply for client state.
        - name: PageToken
          in: query
          type: string
          description: The page token. This is provided by the API.
    - name: v1-Services-ServiceSid-Environments-EnvironmentSid-Logs-Sid
      path: /v1/Services/{ServiceSid}/Environments/{EnvironmentSid}/Logs/{Sid}
      operations:
      - name: fetchlog
        method: GET
        description: Retrieve a specific log.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: ServiceSid
          in: path
          type: string
          description: The SID of the Service to fetch the Log resource from.
          required: true
        - name: EnvironmentSid
          in: path
          type: string
          description: The SID of the environment with the Log resource to fetch.
          required: true
        - name: Sid
          in: path
          type: string
          description: The SID of the Log resource to fetch.
          required: true
    - name: v1-Services-ServiceSid-Environments-EnvironmentSid-Variables
      path: /v1/Services/{ServiceSid}/Environments/{EnvironmentSid}/Variables
      operations:
      - name: listvariable
        method: GET
        description: Retrieve a list of all Variables.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: ServiceSid
          in: path
          type: string
          description: The SID of the Service to read the Variable resources from.
          required: true
        - name: EnvironmentSid
          in: path
          type: string
          description: The SID of the Environment with the Variable resources to read.
          required: true
        - name: PageSize
          in: query
          type: integer
          description: How many resources to return in each list page. The default is 50, and the maximum is 1000.
        - name: Page
          in: query
          type: integer
          description: The page index. This value is simply for client state.
        - name: PageToken
          in: query
          type: string
          description: The page token. This is provided by the API.
      - name: createvariable
        method: POST
        description: Create a new Variable.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: ServiceSid
          in: path
          type: string
          description: The SID of the Service to create the Variable resource under.
          required: true
        - name: EnvironmentSid
          in: path
          type: string
          description: The SID of the Environment in which the Variable resource exists.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: v1-Services-ServiceSid-Environments-EnvironmentSid-Variables-Sid
      path: /v1/Services/{ServiceSid}/Environments/{EnvironmentSid}/Variables/{Sid}
      operations:
      - name: fetchvariable
        method: GET
        description: Retrieve a specific Variable.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: ServiceSid
          in: path
          type: string
          description: The SID of the Service to fetch the Variable resource from.
          required: true
        - name: EnvironmentSid
          in: path
          type: string
          description: The SID of the Environment with the Variable resource to fetch.
          required: true
        - name: Sid
          in: path
          type: string
          description: The SID of the Variable resource to fetch.
          required: true
      - name: updatevariable
        method: POST
        description: Update a specific Variable.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: ServiceSid
          in: path
          type: string
          description: The SID of the Service to update the Variable resource under.
          required: true
        - name: EnvironmentSid
          in: path
          type: string
          description: The SID of the Environment with the Variable resource to update.
          required: true
        - name: Sid
          in: path
          type: string
          description: The SID of the Variable resource to update.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
      - name: deletevariable
        method: DELETE
        description: Delete a specific Variable.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: ServiceSid
          in: path
          type: string
          description: The SID of the Service to delete the Variable resource from.
          required: true
        - name: EnvironmentSid
          in: path
          type: string
          description: The SID of the Environment with the Variables to delete.
          required: true
        - name: Sid
          in: path
          type: string
          description: The SID of the Variable resource to delete.
          required: true
    - name: v1-Services-ServiceSid-Environments-Sid
      path: /v1/Services/{ServiceSid}/Environments/{Sid}
      operations:
      - name: fetchenvironment
        method: GET
        description: Retrieve a specific environment.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: ServiceSid
          in: path
          type: string
          description: The SID of the Service to fetch the Environment resource from.
          required: true
        - name: Sid
          in: path
          type: string
          description: The SID of the Environment resource to fetch.
          required: true
      - name: deleteenvironment
        method: DELETE
        description: Delete a specific environment.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: ServiceSid
          in: path
          type: string
          description: The SID of the Service to delete the Environment resource from.
          required: true
        - name: Sid
          in: path
          type: string
          description: The SID of the Environment resource to delete.
          required: true
    - name: v1-Services-ServiceSid-Functions
      path: /v1/Services/{ServiceSid}/Functions
      operations:
      - name: listfunction
        method: GET
        description: Retrieve a list of all Functions.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: ServiceSid
          in: path
          type: string
          description: The SID of the Service to read the Function resources from.
          required: true
        - name: PageSize
          in: query
          type: integer
          description: How many resources to return in each list page. The default is 50, and the maximum is 1000.
        - name: Page
          in: query
          type: integer
          description: The page index. This value is simply for client state.
        - name: PageToken
          in: query
          type: string
          description: The page token. This is provided by the API.
      - name: createfunction
        method: POST
        description: Create a new Function resource.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: ServiceSid
          in: path
          type: string
          description: The SID of the Service to create the Function resource under.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: v1-Services-ServiceSid-Functions-FunctionSid-Versions
      path: /v1/Services/{ServiceSid}/Functions/{FunctionSid}/Versions
      operations:
      - name: listfunctionversion
        method: GET
        description: Retrieve a list of all Function Version resources.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: ServiceSid
          in: path
          type: string
          description: The SID of the Service to read the Function Version resources from.
          required: true
        - name: FunctionSid
          in: path
          type: string
          description: The SID of the function that is the parent of the Function Version resources to read.
          required: true
        - name: PageSize
          in: query
          type: integer
          description: How many resources to return in each list page. The default is 50, and the maximum is 1000.
        - name: Page
          in: query
          type: integer
          description: The page index. This value is simply for client state.
        - name: PageToken
          in: query
          type: string
          description: The page token. This is provided by the API.
    - name: v1-Services-ServiceSid-Functions-FunctionSid-Versions-Sid
      path: /v1/Services/{ServiceSid}/Functions/{FunctionSid}/Versions/{Sid}
      operations:
      - name: fetchfunctionversion
        method: GET
        description: Retrieve a specific Function Version resource.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: ServiceSid
          in: path
          type: string
          description: The SID of the Service to fetch the Function Version resource from.
          required: true
        - name: FunctionSid
          in: path
          type: string
          description: The SID of the function that is the parent of the Function Version resource to fetch.
          required: true
        - name: Sid
          in: path
          type: string
          description: The SID of the Function Version resource to fetch.
          required: true
    - name: v1-Services-ServiceSid-Functions-FunctionSid-Versions-Sid-Content
      path: /v1/Services/{ServiceSid}/Functions/{FunctionSid}/Versions/{Sid}/Content
      operations:
      - name: fetchfunctionversioncontent
        method: GET
        description: Retrieve a the content of a specific Function Version resource.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: ServiceSid
          in: path
          type: string
          description: The SID of the Service to fetch the Function Version content from.
          required: true
        - name: FunctionSid
          in: path
          type: string
          description: The SID of the Function that is the parent of the Function Version content to fetch.
          required: true
        - name: Sid
          in: path
          type: string
          description: The SID of the Function Version content to fetch.
          required: true
    - name: v1-Services-ServiceSid-Functions-Sid
      path: /v1/Services/{ServiceSid}/Functions/{Sid}
      operations:
      - name: fetchfunction
        method: GET
        description: Retrieve a specific Function resource.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: ServiceSid
          in: path
          type: string
          description: The SID of the Service to fetch the Function resource from.
          required: true
        - name: Sid
          in: path
          type: string
          description: The SID of the Function resource to fetch.
          required: true
      - name: deletefunction
        method: DELETE
        description: Delete a Function resource.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: ServiceSid
          in: path
          type: string
          description: The SID of the Service to delete the Function resource from.
          required: true
        - name: Sid
          in: path
          type: string
          description: The SID of the Function resource to delete.
          required: true
      - name: updatefunction
        method: POST
        description: Update a specific Function resource.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: ServiceSid
          in: path
          type: string
          description: The SID of the Service to update the Function resource from.
          required: true
        - name: Sid
          in: path
          type: string
          description: The SID of the Function resource to update.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: v1-Services-Sid
      path: /v1/Services/{Sid}
      operations:
      - name: fetchservice
        method: GET
        description: Retrieve a specific Service resource.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: Sid
          in: path
          type: string
          description: The `sid` or `unique_name` of the Service resource to fetch.
          required: true
      - name: deleteservice
        method: DELETE
        description: Delete a Service resource.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: Sid
          in: path
          type: string
          description: The `sid` or `unique_name` of the Service resource to delete.
          required: true
      - name: updateservice
        method: POST
        description: Update a specific Service resource.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: Sid
          in: path
          type: string
          description: The `sid` or `unique_name` of the Service resource to update.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    authentication:
      type: basic
      username: '{{env.TWILIO_USER}}'
      password: '{{env.TWILIO_PASS}}'
  exposes:
  - type: rest
    namespace: serverless-services-rest
 

# --- truncated at 32 KB (65 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/twilio/refs/heads/main/capabilities/serverless-services.yaml