> Fetch clean Markdown by appending `.md` to any page URL under https://signalwire.com/docs or requesting it with the HTTP header `Accept: text/markdown`. The root index at https://signalwire.com/docs/llms.txt lists the available documentation indexes.
# Update a cXML Script
POST https://YOUR_SPACE.signalwire.com/api/laml/2010-04-01/Accounts/{AccountSid}/LamlBins/{Sid}
Content-Type: application/x-www-form-urlencoded
Changes the name or stored cXML document of a LamlBin by SID. The change is also visible through [Update cXML Script](/docs/apis/rest/cxml-scripts/update-cxml-script), because both operations manage the same script; server-backed [cXML Webhooks](/docs/apis/rest/cxml-webhook/update-cxml-webhook) are separate resources.
#### Permissions
The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Voice_ or _Messaging_ or _Fax_.
[Learn more about API scopes](/docs/platform/your-signalwire-api-space).
Reference: https://signalwire.com/docs/compatibility-api/rest/cxml-scripts/update-cxml-script
## Authentication
- `Authorization` header (basic auth, required) — SignalWire Basic Authentication using Project ID and API Token. The client sends HTTP requests with the Authorization header containing the word Basic followed by a space and a base64-encoded string of project_id:token. The project ID will be used as the username and the API token as the password. Example: ``` Authorization: Basic base64(project_id:token) ```
## Request
### Path parameters
- `AccountSid` (string, required) — The unique identifier for the account this script is associated with.
- `Sid` (string, required) — The unique identifier of the cXML script.
### Body (application/x-www-form-urlencoded)
This endpoint expects an UpdateCxmlScriptRequest.
- `Name` (string, required) — A friendly name given to the cXML script. Required.
- `Contents` (string, optional) — The cXML contents of the script. Must be valid XML with proper Mustache syntax if templates are used.
## Response
### 200
The request has succeeded.
- `sid` (string, required) — The unique identifier of the cXML script on SignalWire.
- `date_created` (string, required) — The date and time, in ISO 8601 format, the script was created.
- `date_updated` (string, required) — The date and time, in ISO 8601 format, the script was updated.
- `date_last_accessed` (string, required, nullable) — The date and time, in ISO 8601 format, the script was last accessed, or null if never accessed.
- `account_sid` (string, required) — The unique identifier for the account this script is associated with.
- `name` (string, required) — A friendly name given to the cXML script.
- `contents` (string, required) — The contents of the cXML script.
- `request_url` (string, required) — The unique URL to the raw contents of the cXML script.
- `num_requests` (integer, required) — The number of times this cXML script has been accessed.
- `api_version` (string, required) — The version of the SignalWire API.
- `uri` (string, required) — The URL of this resource.
## Errors
### 400 Bad Request Error
The request was invalid or cannot be processed. Check the error details for more information.
- `code` (integer, required) — Error code.
- `message` (string, required) — Error message.
- `more_info` (string, required) — URL for more information about the error.
- `status` (integer, required) — HTTP status code.
### 401 Unauthorized Error
Authentication failed. Please verify your credentials and try again.
- `code` (integer, required) — Error code.
- `message` (string, required) — Error message.
- `more_info` (string, required) — URL for more information about the error.
- `status` (integer, required) — HTTP status code.
### 404 Not Found Error
The requested resource was not found. Please verify the resource identifier.
- `code` (integer, required) — Error code.
- `message` (string, required) — Error message.
- `more_info` (string, required) — URL for more information about the error.
- `status` (integer, required) — HTTP status code.
### 422 Unprocessable Entity Error
The request could not be processed due to validation errors. Check the error details for more information.
- `code` (integer, required) — Error code.
- `message` (string, required) — Error message.
- `more_info` (string, required) — URL for more information about the error.
- `status` (integer, required) — HTTP status code.
## Examples
**Request**
```json
{
"Name": "Death Star IVR"
}
```
**Response**
```json
{
"sid": "5184b831-184f-4209-872d-ccdccc80f2f1",
"date_created": "2019-11-26T20:00:00Z",
"date_updated": "2019-11-26T20:00:00Z",
"date_last_accessed": "2020-06-05T20:00:00Z",
"account_sid": "b3877c40-da60-4998-90ad-b792e98472af",
"name": "Death Star IVR",
"contents": "Hello!",
"request_url": "https://example.signalwire.com/laml-bins/5184b831-184f-4209-872d-ccdccc80f2f1",
"num_requests": 42,
"api_version": "2010-04-01",
"uri": "/api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af/LamlBins/5184b831-184f-4209-872d-ccdccc80f2f1"
}
```
**SDK Code**
```python
import requests
url = "https://your_space.signalwire.com/api/laml/2010-04-01/Accounts/AccountSid/LamlBins/Sid"
payload = ""
headers = {
"Content-Type": "application/x-www-form-urlencoded"
}
response = requests.post(url, data=payload, headers=headers, auth=("", ""))
print(response.json())
```
```javascript
const url = 'https://your_space.signalwire.com/api/laml/2010-04-01/Accounts/AccountSid/LamlBins/Sid';
const credentials = btoa(":");
const options = {
method: 'POST',
headers: {
Authorization: `Basic ${credentials}`,
'Content-Type': 'application/x-www-form-urlencoded'
},
body: new URLSearchParams('')
};
try {
const response = await fetch(url, options);
const data = await response.json();
console.log(data);
} catch (error) {
console.error(error);
}
```
```go
package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://your_space.signalwire.com/api/laml/2010-04-01/Accounts/AccountSid/LamlBins/Sid"
req, _ := http.NewRequest("POST", url, nil)
req.SetBasicAuth("", "")
req.Header.Add("Content-Type", "application/x-www-form-urlencoded")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(res)
fmt.Println(string(body))
}
```
```ruby
require 'uri'
require 'net/http'
url = URI("https://your_space.signalwire.com/api/laml/2010-04-01/Accounts/AccountSid/LamlBins/Sid")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request.basic_auth("", "")
request["Content-Type"] = 'application/x-www-form-urlencoded'
response = http.request(request)
puts response.read_body
```
```java
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;
HttpResponse response = Unirest.post("https://your_space.signalwire.com/api/laml/2010-04-01/Accounts/AccountSid/LamlBins/Sid")
.basicAuth("", "")
.header("Content-Type", "application/x-www-form-urlencoded")
.asString();
```
```php
request('POST', 'https://your_space.signalwire.com/api/laml/2010-04-01/Accounts/AccountSid/LamlBins/Sid', [
'form_params' => null,
'headers' => [
'Content-Type' => 'application/x-www-form-urlencoded',
],
'auth' => ['', ''],
]);
echo $response->getBody();
```
```csharp
using RestSharp;
using RestSharp.Authenticators;
var client = new RestClient("https://your_space.signalwire.com/api/laml/2010-04-01/Accounts/AccountSid/LamlBins/Sid");
client.Authenticator = new HttpBasicAuthenticator("", "");
var request = new RestRequest(Method.POST);
request.AddHeader("Content-Type", "application/x-www-form-urlencoded");
IRestResponse response = client.Execute(request);
```
```swift
import Foundation
let credentials = Data(":".utf8).base64EncodedString()
let headers = [
"Authorization": "Basic \(credentials)",
"Content-Type": "application/x-www-form-urlencoded"
]
let request = NSMutableURLRequest(url: NSURL(string: "https://your_space.signalwire.com/api/laml/2010-04-01/Accounts/AccountSid/LamlBins/Sid")! as URL,
cachePolicy: .useProtocolCachePolicy,
timeoutInterval: 10.0)
request.httpMethod = "POST"
request.allHTTPHeaderFields = headers
let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
if (error != nil) {
print(error as Any)
} else {
let httpResponse = response as? HTTPURLResponse
print(httpResponse)
}
})
dataTask.resume()
```