Get a profile's precomputed summary
The whole profile as one card, precomputed, with no query. Built for the start of a session, where there is no question to ask yet.
A summary is generated in the background. is_stale tells you newer memories have arrived since it was written; that is ordinary and the card is still usable.
GET
/
ai
/
memory
/
namespaces
/
{namespace}
/
profiles
/
{profile_id}
/
summary
JavaScript
import Telnyx from 'telnyx';
const client = new Telnyx({
apiKey: process.env['TELNYX_API_KEY'], // This is the default and can be omitted
});
const response = await client.ai.memory.namespaces.profiles.retrieveSummary('namespace', 'profile_id');
console.log(response.data);import os
from telnyx import Telnyx
client = Telnyx(
api_key=os.environ.get("TELNYX_API_KEY"), # This is the default and can be omitted
)
response = client.ai.memory.namespaces.profiles.retrieve_summary(
"namespace",
"profile_id",
)
print(response.data)
package main
import (
"context"
"fmt"
"github.com/team-telnyx/telnyx-go"
"github.com/team-telnyx/telnyx-go/option"
)
func main() {
client := telnyx.NewClient(
option.WithAPIKey("My API Key"),
)
response, err := client.AI.Memory.Namespaces.Profiles.GetSummary(
context.TODO(),
"namespace",
"profile_id",
)
if err != nil {
panic(err.Error())
}
fmt.Printf("%+v\n", response.Data)
}
package com.telnyx.sdk.example;
import com.telnyx.sdk.client.TelnyxClient;
import com.telnyx.sdk.client.okhttp.TelnyxOkHttpClient;
public final class Main {
private Main() {}
public static void main(String[] args) {
TelnyxClient client = TelnyxOkHttpClient.fromEnv();
var response = client.ai().memory().namespaces().profiles().retrieveSummary("namespace", "profile_id");
}
}require "telnyx"
telnyx = Telnyx::Client.new(api_key: "My API Key")
response = telnyx.ai.memory.namespaces.profiles.retrieve_summary("namespace", "profile_id")
puts(response)<?php
require_once dirname(__DIR__) . '/vendor/autoload.php';
use Telnyx\Client;
use Telnyx\Core\Exceptions\APIException;
$client = new Client(apiKey: getenv('TELNYX_API_KEY') ?: 'My API Key');
try {
$response = $client->ai->memory->namespaces->profiles->retrieveSummary(
'namespace',
'profile_id',
);
var_dump($response);
} catch (APIException $e) {
echo $e->getMessage();
}telnyx ai:memory:namespaces:profiles retrieve-summary \
--api-key 'My API Key' \
--namespace namespace \
--profile-id profile_idcurl --request GET \
--url https://api.telnyx.com/v2/ai/memory/namespaces/{namespace}/profiles/{profile_id}/summary \
--header 'Authorization: Bearer <token>'{
"data": {
"profile_id": "user-42",
"text": "## Profile Summary\n\n- Prefers Slack over email.\n- Timezone: US Central.",
"generated_at": "2026-09-18T18:32:17.501833+00:00",
"is_stale": false
}
}{
"errors": [
{
"code": "10009",
"title": "Authentication failed",
"detail": "Could not find any usable credentials in the request.",
"source": {
"pointer": "/"
},
"meta": {
"url": "https://developers.telnyx.com/docs/overview/errors/10009"
}
}
]
}{
"errors": [
{
"code": "namespace_not_found",
"detail": "no such namespace"
}
]
}{
"errors": [
{
"code": "upstream_error",
"detail": "the memory dataplane is unavailable"
}
]
}Authorizations
Telnyx API key
Path Parameters
The namespace. default exists for every organization.
The profile: your identifier for the user, caller or agent this memory is about.
Response
The profile's summary
Show child attributes
Show child attributes
Was this page helpful?
JavaScript
import Telnyx from 'telnyx';
const client = new Telnyx({
apiKey: process.env['TELNYX_API_KEY'], // This is the default and can be omitted
});
const response = await client.ai.memory.namespaces.profiles.retrieveSummary('namespace', 'profile_id');
console.log(response.data);import os
from telnyx import Telnyx
client = Telnyx(
api_key=os.environ.get("TELNYX_API_KEY"), # This is the default and can be omitted
)
response = client.ai.memory.namespaces.profiles.retrieve_summary(
"namespace",
"profile_id",
)
print(response.data)
package main
import (
"context"
"fmt"
"github.com/team-telnyx/telnyx-go"
"github.com/team-telnyx/telnyx-go/option"
)
func main() {
client := telnyx.NewClient(
option.WithAPIKey("My API Key"),
)
response, err := client.AI.Memory.Namespaces.Profiles.GetSummary(
context.TODO(),
"namespace",
"profile_id",
)
if err != nil {
panic(err.Error())
}
fmt.Printf("%+v\n", response.Data)
}
package com.telnyx.sdk.example;
import com.telnyx.sdk.client.TelnyxClient;
import com.telnyx.sdk.client.okhttp.TelnyxOkHttpClient;
public final class Main {
private Main() {}
public static void main(String[] args) {
TelnyxClient client = TelnyxOkHttpClient.fromEnv();
var response = client.ai().memory().namespaces().profiles().retrieveSummary("namespace", "profile_id");
}
}require "telnyx"
telnyx = Telnyx::Client.new(api_key: "My API Key")
response = telnyx.ai.memory.namespaces.profiles.retrieve_summary("namespace", "profile_id")
puts(response)<?php
require_once dirname(__DIR__) . '/vendor/autoload.php';
use Telnyx\Client;
use Telnyx\Core\Exceptions\APIException;
$client = new Client(apiKey: getenv('TELNYX_API_KEY') ?: 'My API Key');
try {
$response = $client->ai->memory->namespaces->profiles->retrieveSummary(
'namespace',
'profile_id',
);
var_dump($response);
} catch (APIException $e) {
echo $e->getMessage();
}telnyx ai:memory:namespaces:profiles retrieve-summary \
--api-key 'My API Key' \
--namespace namespace \
--profile-id profile_idcurl --request GET \
--url https://api.telnyx.com/v2/ai/memory/namespaces/{namespace}/profiles/{profile_id}/summary \
--header 'Authorization: Bearer <token>'{
"data": {
"profile_id": "user-42",
"text": "## Profile Summary\n\n- Prefers Slack over email.\n- Timezone: US Central.",
"generated_at": "2026-09-18T18:32:17.501833+00:00",
"is_stale": false
}
}{
"errors": [
{
"code": "10009",
"title": "Authentication failed",
"detail": "Could not find any usable credentials in the request.",
"source": {
"pointer": "/"
},
"meta": {
"url": "https://developers.telnyx.com/docs/overview/errors/10009"
}
}
]
}{
"errors": [
{
"code": "namespace_not_found",
"detail": "no such namespace"
}
]
}{
"errors": [
{
"code": "upstream_error",
"detail": "the memory dataplane is unavailable"
}
]
}