curl --request PATCH \
--url https://app.famulor.io/api/v1/settings/memory \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"memory_enabled_default": true,
"memory_staleness_days": 180,
"memory_channels": [
"voice",
"sms",
"whatsapp",
"email"
],
"memory_consent_required": true,
"memory_retention_days": 365
}
'import requests
url = "https://app.famulor.io/api/v1/settings/memory"
payload = {
"memory_enabled_default": True,
"memory_staleness_days": 180,
"memory_channels": ["voice", "sms", "whatsapp", "email"],
"memory_consent_required": True,
"memory_retention_days": 365
}
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({
memory_enabled_default: true,
memory_staleness_days: 180,
memory_channels: ['voice', 'sms', 'whatsapp', 'email'],
memory_consent_required: true,
memory_retention_days: 365
})
};
fetch('https://app.famulor.io/api/v1/settings/memory', 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://app.famulor.io/api/v1/settings/memory",
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([
'memory_enabled_default' => true,
'memory_staleness_days' => 180,
'memory_channels' => [
'voice',
'sms',
'whatsapp',
'email'
],
'memory_consent_required' => true,
'memory_retention_days' => 365
]),
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://app.famulor.io/api/v1/settings/memory"
payload := strings.NewReader("{\n \"memory_enabled_default\": true,\n \"memory_staleness_days\": 180,\n \"memory_channels\": [\n \"voice\",\n \"sms\",\n \"whatsapp\",\n \"email\"\n ],\n \"memory_consent_required\": true,\n \"memory_retention_days\": 365\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://app.famulor.io/api/v1/settings/memory")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"memory_enabled_default\": true,\n \"memory_staleness_days\": 180,\n \"memory_channels\": [\n \"voice\",\n \"sms\",\n \"whatsapp\",\n \"email\"\n ],\n \"memory_consent_required\": true,\n \"memory_retention_days\": 365\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.famulor.io/api/v1/settings/memory")
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 \"memory_enabled_default\": true,\n \"memory_staleness_days\": 180,\n \"memory_channels\": [\n \"voice\",\n \"sms\",\n \"whatsapp\",\n \"email\"\n ],\n \"memory_consent_required\": true,\n \"memory_retention_days\": 365\n}"
response = http.request(request)
puts response.read_body{
"data": {
"memory_enabled_default": false,
"memory_staleness_days": 180,
"memory_channels": [
"voice"
],
"memory_consent_required": true,
"memory_retention_days": 365,
"memory_available_channels": [
"voice"
]
}
}Update memory settings
Updates the workspace defaults for caller memory. Provide at least one field. Required scope: settings:write.
curl --request PATCH \
--url https://app.famulor.io/api/v1/settings/memory \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"memory_enabled_default": true,
"memory_staleness_days": 180,
"memory_channels": [
"voice",
"sms",
"whatsapp",
"email"
],
"memory_consent_required": true,
"memory_retention_days": 365
}
'import requests
url = "https://app.famulor.io/api/v1/settings/memory"
payload = {
"memory_enabled_default": True,
"memory_staleness_days": 180,
"memory_channels": ["voice", "sms", "whatsapp", "email"],
"memory_consent_required": True,
"memory_retention_days": 365
}
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({
memory_enabled_default: true,
memory_staleness_days: 180,
memory_channels: ['voice', 'sms', 'whatsapp', 'email'],
memory_consent_required: true,
memory_retention_days: 365
})
};
fetch('https://app.famulor.io/api/v1/settings/memory', 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://app.famulor.io/api/v1/settings/memory",
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([
'memory_enabled_default' => true,
'memory_staleness_days' => 180,
'memory_channels' => [
'voice',
'sms',
'whatsapp',
'email'
],
'memory_consent_required' => true,
'memory_retention_days' => 365
]),
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://app.famulor.io/api/v1/settings/memory"
payload := strings.NewReader("{\n \"memory_enabled_default\": true,\n \"memory_staleness_days\": 180,\n \"memory_channels\": [\n \"voice\",\n \"sms\",\n \"whatsapp\",\n \"email\"\n ],\n \"memory_consent_required\": true,\n \"memory_retention_days\": 365\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://app.famulor.io/api/v1/settings/memory")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"memory_enabled_default\": true,\n \"memory_staleness_days\": 180,\n \"memory_channels\": [\n \"voice\",\n \"sms\",\n \"whatsapp\",\n \"email\"\n ],\n \"memory_consent_required\": true,\n \"memory_retention_days\": 365\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.famulor.io/api/v1/settings/memory")
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 \"memory_enabled_default\": true,\n \"memory_staleness_days\": 180,\n \"memory_channels\": [\n \"voice\",\n \"sms\",\n \"whatsapp\",\n \"email\"\n ],\n \"memory_consent_required\": true,\n \"memory_retention_days\": 365\n}"
response = http.request(request)
puts response.read_body{
"data": {
"memory_enabled_default": false,
"memory_staleness_days": 180,
"memory_channels": [
"voice"
],
"memory_consent_required": true,
"memory_retention_days": 365,
"memory_available_channels": [
"voice"
]
}
}Authorizations
API key (fam_..., created under Settings → API Keys) or an OAuth 2.0 access token (fam_at_...). REST operations also require API Access for the credential's workspace. Keys can be restricted to scopes such as assistants:read, calls:write, campaigns:write, automations:read, dashboards:read, dashboards:write, leads:write, segments:write, loop:read, loop:write, phone_numbers:write, sip_trunks:write, knowledge:write, voices:read, billing:read, billing:write, settings:write, platform:read, platform:write; a *:write scope implies the matching *:read. Automation and dashboard endpoints also accept the legacy calls:* scope. Keys without scope restrictions have full access within the workspace's available capabilities.
Body
Configured memory channels. Web Chat and Web Voice require a current verified widget email or phone and visitor consent. Web and SMS memory require a root workspace. An empty array disables all memory channels.
Memory channels. Web Chat and Web Voice require a current verified widget email or phone and memory consent. Web and SMS memory require a root workspace. Legacy web configuration expands to both web channels; anonymous sessions remain excluded.
voice, sms, whatsapp, email, web, telegram, slack, messenger, teams, discord, gchat, x, linear, notion, twitch, mattermost, webex, lark, line, sendblue, linq, zernio, freshdesk, gmail, outlook, zendesk, servicenow, intercom, zoho_mail, agent_mail, instagram, zulip, web_chat, web_voice