Update memory settings

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
  }
}

PATCH

settings

memory

Update memory settings

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
  }
}

Authorizations

Authorization

string

header

required

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, 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

application/json

memory_enabled_default

boolean

Workspace default for caller memory.

memory_staleness_days

integer | null

Days without a call until a caller profile goes stale; null = never.

Required range: 1 <= x <= 3650

memory_channels

enum<string>[]

Operational channels allowed to read and write canonical customer memory. Web is reserved until a server-verified signed-in identity boundary exists.

Minimum array length: 1

A currently operational memory channel. Web is deliberately excluded until signed-in browser users have a server-verified identity boundary.

Available options:

voice,

sms,

whatsapp,

email,

telegram,

slack,

messenger,

teams,

discord,

gchat,

x,

freshdesk,

gmail,

outlook,

zendesk,

servicenow,

intercom,

zoho_mail,

agent_mail,

instagram,

zulip

When true, unknown consent blocks memory reads and writes.

memory_retention_days

integer

Rolling retention in days; -1 keeps memory until it is manually erased.

Required range: -1 <= x <= 3650

Response

The updated settings.

data

object

Show child attributes

API Reference

Account

Billing

API Keys

Workspaces

Assistants

Versions

Simulations

Voices

Tools

Knowledge Bases

Calls

History

QA

Callbacks

Campaigns

Leads

Segments

Suppression

Phone Numbers

Caller IDs

SIP Trunks

Carrier Connections

Famulor Loop

Messaging

SMS

Widgets

Integrations

Bookings

Automations

Milian Missions

Dashboards

Catalog

Settings

Migrations

White Label

Update memory settings

Authorizations

Body

Response