Change workspace settings
curl --request PATCH \
--url https://api.statisfy.com/v1/settings \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"ai_task_auto_close_days": null,
"ai_task_update_email_notification": null,
"automated_email_denylist": null,
"automated_email_patterns": null,
"enable_weekly_task_overdue_reports": null,
"health_calculation_cooloff": null,
"internal_meeting_tasks": null,
"notetaker_enabled": null,
"notetaker_followup_email": null,
"notetaker_name": null,
"process_meeting": null,
"public_activity_link_expiry_days": null,
"quarter_start_month": null,
"slack_stella_disclosure_message": null,
"support_escalation_widget_display": null,
"task_escalations": null,
"task_type_customer_goal": null
}
'import requests
url = "https://api.statisfy.com/v1/settings"
payload = {
"ai_task_auto_close_days": None,
"ai_task_update_email_notification": None,
"automated_email_denylist": None,
"automated_email_patterns": None,
"enable_weekly_task_overdue_reports": None,
"health_calculation_cooloff": None,
"internal_meeting_tasks": None,
"notetaker_enabled": None,
"notetaker_followup_email": None,
"notetaker_name": None,
"process_meeting": None,
"public_activity_link_expiry_days": None,
"quarter_start_month": None,
"slack_stella_disclosure_message": None,
"support_escalation_widget_display": None,
"task_escalations": None,
"task_type_customer_goal": None
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
ai_task_auto_close_days: null,
ai_task_update_email_notification: null,
automated_email_denylist: null,
automated_email_patterns: null,
enable_weekly_task_overdue_reports: null,
health_calculation_cooloff: null,
internal_meeting_tasks: null,
notetaker_enabled: null,
notetaker_followup_email: null,
notetaker_name: null,
process_meeting: null,
public_activity_link_expiry_days: null,
quarter_start_month: null,
slack_stella_disclosure_message: null,
support_escalation_widget_display: null,
task_escalations: null,
task_type_customer_goal: null
})
};
fetch('https://api.statisfy.com/v1/settings', 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://api.statisfy.com/v1/settings",
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([
'ai_task_auto_close_days' => null,
'ai_task_update_email_notification' => null,
'automated_email_denylist' => null,
'automated_email_patterns' => null,
'enable_weekly_task_overdue_reports' => null,
'health_calculation_cooloff' => null,
'internal_meeting_tasks' => null,
'notetaker_enabled' => null,
'notetaker_followup_email' => null,
'notetaker_name' => null,
'process_meeting' => null,
'public_activity_link_expiry_days' => null,
'quarter_start_month' => null,
'slack_stella_disclosure_message' => null,
'support_escalation_widget_display' => null,
'task_escalations' => null,
'task_type_customer_goal' => null
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$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://api.statisfy.com/v1/settings"
payload := strings.NewReader("{\n \"ai_task_auto_close_days\": null,\n \"ai_task_update_email_notification\": null,\n \"automated_email_denylist\": null,\n \"automated_email_patterns\": null,\n \"enable_weekly_task_overdue_reports\": null,\n \"health_calculation_cooloff\": null,\n \"internal_meeting_tasks\": null,\n \"notetaker_enabled\": null,\n \"notetaker_followup_email\": null,\n \"notetaker_name\": null,\n \"process_meeting\": null,\n \"public_activity_link_expiry_days\": null,\n \"quarter_start_month\": null,\n \"slack_stella_disclosure_message\": null,\n \"support_escalation_widget_display\": null,\n \"task_escalations\": null,\n \"task_type_customer_goal\": null\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
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://api.statisfy.com/v1/settings")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"ai_task_auto_close_days\": null,\n \"ai_task_update_email_notification\": null,\n \"automated_email_denylist\": null,\n \"automated_email_patterns\": null,\n \"enable_weekly_task_overdue_reports\": null,\n \"health_calculation_cooloff\": null,\n \"internal_meeting_tasks\": null,\n \"notetaker_enabled\": null,\n \"notetaker_followup_email\": null,\n \"notetaker_name\": null,\n \"process_meeting\": null,\n \"public_activity_link_expiry_days\": null,\n \"quarter_start_month\": null,\n \"slack_stella_disclosure_message\": null,\n \"support_escalation_widget_display\": null,\n \"task_escalations\": null,\n \"task_type_customer_goal\": null\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.statisfy.com/v1/settings")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"ai_task_auto_close_days\": null,\n \"ai_task_update_email_notification\": null,\n \"automated_email_denylist\": null,\n \"automated_email_patterns\": null,\n \"enable_weekly_task_overdue_reports\": null,\n \"health_calculation_cooloff\": null,\n \"internal_meeting_tasks\": null,\n \"notetaker_enabled\": null,\n \"notetaker_followup_email\": null,\n \"notetaker_name\": null,\n \"process_meeting\": null,\n \"public_activity_link_expiry_days\": null,\n \"quarter_start_month\": null,\n \"slack_stella_disclosure_message\": null,\n \"support_escalation_widget_display\": null,\n \"task_escalations\": null,\n \"task_type_customer_goal\": null\n}"
response = http.request(request)
puts response.read_body{
"ai_task_auto_close_days": 30,
"ai_task_update_email_notification": false,
"automated_email_denylist": [
"payroll.com",
"billing@zoom.us"
],
"automated_email_patterns": [
"^noreply@",
"^no-reply@"
],
"company_domains": [
"acme.com",
"acme.io"
],
"enable_weekly_task_overdue_reports": true,
"health_calculation_cooloff": 7,
"internal_meeting_tasks": false,
"notetaker_enabled": true,
"notetaker_followup_email": 1,
"notetaker_name": "Acme Notetaker",
"process_meeting": 2,
"public_activity_link_expiry_days": 14,
"quarter_start_month": 2,
"slack_stella_disclosure_message": "This response is generated by an AI assistant.",
"slack_stella_pii_guardrail_enabled": true,
"support_escalation_widget_display": false,
"task_escalations": false,
"task_type_customer_goal": false
}settings
Change workspace settings
Changes only the settings sent, as an admin’s save in Settings > Config does, and returns all of them. Every value is checked before anything is written: any problem refuses the whole request with a 422 that lists each one in details. null is refused (there is no reset to the default), and so are company_domains and slack_stella_pii_guardrail_enabled, which only the app changes.
PATCH
/
v1
/
settings
Change workspace settings
curl --request PATCH \
--url https://api.statisfy.com/v1/settings \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"ai_task_auto_close_days": null,
"ai_task_update_email_notification": null,
"automated_email_denylist": null,
"automated_email_patterns": null,
"enable_weekly_task_overdue_reports": null,
"health_calculation_cooloff": null,
"internal_meeting_tasks": null,
"notetaker_enabled": null,
"notetaker_followup_email": null,
"notetaker_name": null,
"process_meeting": null,
"public_activity_link_expiry_days": null,
"quarter_start_month": null,
"slack_stella_disclosure_message": null,
"support_escalation_widget_display": null,
"task_escalations": null,
"task_type_customer_goal": null
}
'import requests
url = "https://api.statisfy.com/v1/settings"
payload = {
"ai_task_auto_close_days": None,
"ai_task_update_email_notification": None,
"automated_email_denylist": None,
"automated_email_patterns": None,
"enable_weekly_task_overdue_reports": None,
"health_calculation_cooloff": None,
"internal_meeting_tasks": None,
"notetaker_enabled": None,
"notetaker_followup_email": None,
"notetaker_name": None,
"process_meeting": None,
"public_activity_link_expiry_days": None,
"quarter_start_month": None,
"slack_stella_disclosure_message": None,
"support_escalation_widget_display": None,
"task_escalations": None,
"task_type_customer_goal": None
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
ai_task_auto_close_days: null,
ai_task_update_email_notification: null,
automated_email_denylist: null,
automated_email_patterns: null,
enable_weekly_task_overdue_reports: null,
health_calculation_cooloff: null,
internal_meeting_tasks: null,
notetaker_enabled: null,
notetaker_followup_email: null,
notetaker_name: null,
process_meeting: null,
public_activity_link_expiry_days: null,
quarter_start_month: null,
slack_stella_disclosure_message: null,
support_escalation_widget_display: null,
task_escalations: null,
task_type_customer_goal: null
})
};
fetch('https://api.statisfy.com/v1/settings', 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://api.statisfy.com/v1/settings",
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([
'ai_task_auto_close_days' => null,
'ai_task_update_email_notification' => null,
'automated_email_denylist' => null,
'automated_email_patterns' => null,
'enable_weekly_task_overdue_reports' => null,
'health_calculation_cooloff' => null,
'internal_meeting_tasks' => null,
'notetaker_enabled' => null,
'notetaker_followup_email' => null,
'notetaker_name' => null,
'process_meeting' => null,
'public_activity_link_expiry_days' => null,
'quarter_start_month' => null,
'slack_stella_disclosure_message' => null,
'support_escalation_widget_display' => null,
'task_escalations' => null,
'task_type_customer_goal' => null
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$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://api.statisfy.com/v1/settings"
payload := strings.NewReader("{\n \"ai_task_auto_close_days\": null,\n \"ai_task_update_email_notification\": null,\n \"automated_email_denylist\": null,\n \"automated_email_patterns\": null,\n \"enable_weekly_task_overdue_reports\": null,\n \"health_calculation_cooloff\": null,\n \"internal_meeting_tasks\": null,\n \"notetaker_enabled\": null,\n \"notetaker_followup_email\": null,\n \"notetaker_name\": null,\n \"process_meeting\": null,\n \"public_activity_link_expiry_days\": null,\n \"quarter_start_month\": null,\n \"slack_stella_disclosure_message\": null,\n \"support_escalation_widget_display\": null,\n \"task_escalations\": null,\n \"task_type_customer_goal\": null\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
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://api.statisfy.com/v1/settings")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"ai_task_auto_close_days\": null,\n \"ai_task_update_email_notification\": null,\n \"automated_email_denylist\": null,\n \"automated_email_patterns\": null,\n \"enable_weekly_task_overdue_reports\": null,\n \"health_calculation_cooloff\": null,\n \"internal_meeting_tasks\": null,\n \"notetaker_enabled\": null,\n \"notetaker_followup_email\": null,\n \"notetaker_name\": null,\n \"process_meeting\": null,\n \"public_activity_link_expiry_days\": null,\n \"quarter_start_month\": null,\n \"slack_stella_disclosure_message\": null,\n \"support_escalation_widget_display\": null,\n \"task_escalations\": null,\n \"task_type_customer_goal\": null\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.statisfy.com/v1/settings")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"ai_task_auto_close_days\": null,\n \"ai_task_update_email_notification\": null,\n \"automated_email_denylist\": null,\n \"automated_email_patterns\": null,\n \"enable_weekly_task_overdue_reports\": null,\n \"health_calculation_cooloff\": null,\n \"internal_meeting_tasks\": null,\n \"notetaker_enabled\": null,\n \"notetaker_followup_email\": null,\n \"notetaker_name\": null,\n \"process_meeting\": null,\n \"public_activity_link_expiry_days\": null,\n \"quarter_start_month\": null,\n \"slack_stella_disclosure_message\": null,\n \"support_escalation_widget_display\": null,\n \"task_escalations\": null,\n \"task_type_customer_goal\": null\n}"
response = http.request(request)
puts response.read_body{
"ai_task_auto_close_days": 30,
"ai_task_update_email_notification": false,
"automated_email_denylist": [
"payroll.com",
"billing@zoom.us"
],
"automated_email_patterns": [
"^noreply@",
"^no-reply@"
],
"company_domains": [
"acme.com",
"acme.io"
],
"enable_weekly_task_overdue_reports": true,
"health_calculation_cooloff": 7,
"internal_meeting_tasks": false,
"notetaker_enabled": true,
"notetaker_followup_email": 1,
"notetaker_name": "Acme Notetaker",
"process_meeting": 2,
"public_activity_link_expiry_days": 14,
"quarter_start_month": 2,
"slack_stella_disclosure_message": "This response is generated by an AI assistant.",
"slack_stella_pii_guardrail_enabled": true,
"support_escalation_widget_display": false,
"task_escalations": false,
"task_type_customer_goal": false
}Authorizations
An API key, sent as Authorization: Bearer stfy_live_…. See Authentication for how to get one and which scopes it needs.
Body
application/json
Only the settings sent are changed.
Response
200 - application/json
Successful Response
Was this page helpful?