Update PAL Skill
curl --request PATCH \
--url https://tavusapi.com/v2/pals/{pal_id}/skills/{skill_id} \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"config": {
"slides_trigger": "on_demand"
}
}
'import requests
url = "https://tavusapi.com/v2/pals/{pal_id}/skills/{skill_id}"
payload = { "config": { "slides_trigger": "on_demand" } }
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({config: {slides_trigger: 'on_demand'}})
};
fetch('https://tavusapi.com/v2/pals/{pal_id}/skills/{skill_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://tavusapi.com/v2/pals/{pal_id}/skills/{skill_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'config' => [
'slides_trigger' => 'on_demand'
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://tavusapi.com/v2/pals/{pal_id}/skills/{skill_id}"
payload := strings.NewReader("{\n \"config\": {\n \"slides_trigger\": \"on_demand\"\n }\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("x-api-key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.patch("https://tavusapi.com/v2/pals/{pal_id}/skills/{skill_id}")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"config\": {\n \"slides_trigger\": \"on_demand\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://tavusapi.com/v2/pals/{pal_id}/skills/{skill_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"config\": {\n \"slides_trigger\": \"on_demand\"\n }\n}"
response = http.request(request)
puts response.read_body{
"skill_id": "presentation",
"config": {
"document_ids": [
"d1234567890",
"d2468101214"
],
"slides_trigger": "walk_the_deck",
"prompt": "Walk the participant through the Q4 roadmap deck."
},
"attached_at": "2026-06-10T14:30:45.123456+00:00",
"updated_at": "2026-06-10T14:30:45.123456+00:00"
}{
"error": "Bad Request: {'config': ['Missing data for required field.']}"
}{
"message": "Invalid access token"
}{
"error": "Skill 'presentation' is not attached to this PAL"
}Skills
Update PAL Skill
Merge changes into an existing skill attachment’s configuration. Fields you pass replace the existing values, fields you omit are preserved, and fields set to null are removed. The merged configuration is validated against the skill’s config schema.
Unlike Attach Skill to PAL, this endpoint cannot create a new attachment - the skill must already be attached.
PATCH
/
v2
/
pals
/
{pal_id}
/
skills
/
{skill_id}
Update PAL Skill
curl --request PATCH \
--url https://tavusapi.com/v2/pals/{pal_id}/skills/{skill_id} \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"config": {
"slides_trigger": "on_demand"
}
}
'import requests
url = "https://tavusapi.com/v2/pals/{pal_id}/skills/{skill_id}"
payload = { "config": { "slides_trigger": "on_demand" } }
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({config: {slides_trigger: 'on_demand'}})
};
fetch('https://tavusapi.com/v2/pals/{pal_id}/skills/{skill_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://tavusapi.com/v2/pals/{pal_id}/skills/{skill_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'config' => [
'slides_trigger' => 'on_demand'
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://tavusapi.com/v2/pals/{pal_id}/skills/{skill_id}"
payload := strings.NewReader("{\n \"config\": {\n \"slides_trigger\": \"on_demand\"\n }\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("x-api-key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.patch("https://tavusapi.com/v2/pals/{pal_id}/skills/{skill_id}")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"config\": {\n \"slides_trigger\": \"on_demand\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://tavusapi.com/v2/pals/{pal_id}/skills/{skill_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"config\": {\n \"slides_trigger\": \"on_demand\"\n }\n}"
response = http.request(request)
puts response.read_body{
"skill_id": "presentation",
"config": {
"document_ids": [
"d1234567890",
"d2468101214"
],
"slides_trigger": "walk_the_deck",
"prompt": "Walk the participant through the Q4 roadmap deck."
},
"attached_at": "2026-06-10T14:30:45.123456+00:00",
"updated_at": "2026-06-10T14:30:45.123456+00:00"
}{
"error": "Bad Request: {'config': ['Missing data for required field.']}"
}{
"message": "Invalid access token"
}{
"error": "Skill 'presentation' is not attached to this PAL"
}For AI agents, use
https://docs.tavus.io/openapi.yaml for the full HTTP API contract.Path Parameters
Body
application/json
Response
Successfully updated the skill attachment
A skill attached to a PAL.
The skill's configuration. Empty object for skills with no configuration.
Shape depends on skill_id - see Skills. For magic_canvas, config.components is a sparse overlay and config.usage_guidance is an optional string (max 2048 characters) that steers when the PAL shows cards; see Canvas configuration.
Example:
{
"document_ids": ["d1234567890", "d2468101214"],
"slides_trigger": "walk_the_deck",
"prompt": "Walk the participant through the Q4 roadmap deck."
}

