Retrieve Session
curl --request GET \
--url https://platform.perso.ai/api/v1/session/{session_id}/import requests
url = "https://platform.perso.ai/api/v1/session/{session_id}/"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://platform.perso.ai/api/v1/session/{session_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://platform.perso.ai/api/v1/session/{session_id}/",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://platform.perso.ai/api/v1/session/{session_id}/"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://platform.perso.ai/api/v1/session/{session_id}/")
.asString();require 'uri'
require 'net/http'
url = URI("https://platform.perso.ai/api/v1/session/{session_id}/")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"session_id": "<string>",
"client_sdp": null,
"server_sdp": null,
"prompt": {
"name": "<string>",
"prompt_id": "<string>",
"system_prompt": "<string>",
"description": "<string>",
"require_document": true,
"intro_message": "<string>"
},
"llm_type": {
"name": "<string>",
"service": "openai"
},
"model_style": {
"name": "<string>",
"model": "<string>",
"model_files": [
{
"name": "<string>",
"file": "<string>"
}
],
"style": "<string>",
"files": [
{
"name": "<string>",
"file": "<string>"
}
],
"configs": [
{
"modelstyleconfig_id": "<string>",
"key": "<string>",
"value": "<string>"
}
],
"model_file": "<string>",
"file": "<string>",
"platform_type": "android"
},
"tts_type": {
"name": "<string>",
"service": "openai",
"streamable": true,
"model": "<string>",
"voice": "<string>",
"voice_settings": "<unknown>",
"style": "<string>",
"voice_extra_data": "<unknown>"
},
"text_normalization_config": {
"textnormalizationconfig_id": "<string>",
"name": "<string>",
"pre_hook_url": "<string>",
"post_hook_url": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"hook_enabled": true,
"pre_hook_args": null,
"post_hook_args": null
},
"text_normalization_locale": "<string>",
"stt_type": {
"name": "<string>",
"service": "WHISPER",
"options": null
},
"stt_text_normalization_config": {
"textnormalizationconfig_id": "<string>",
"name": "<string>",
"pre_hook_url": "<string>",
"post_hook_url": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"hook_enabled": true,
"pre_hook_args": null,
"post_hook_args": null
},
"stt_text_normalization_locale": "<string>",
"ice_servers": null,
"status": "CREATED",
"termination_reason": "GRACEFUL_TERMINATION",
"duration_sec": 123,
"created_at": "2023-11-07T05:31:56Z",
"session_acls": [
"<string>"
],
"padding_left": 123,
"padding_top": 123,
"padding_height": 123,
"background_image": {
"backgroundimage_id": "<string>",
"title": "<string>",
"image": "<string>",
"created_at": "2023-11-07T05:31:56Z"
},
"extra_data": null,
"capability": [
{
"name": "LLM",
"description": "<string>"
}
],
"agent_config": {
"agentconfig_id": "<string>",
"name": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"config": "<unknown>"
},
"interactive_agent_config": {
"interactiveagentconfig_id": "<string>",
"name": "<string>",
"description": "<string>",
"intro_message": "<string>",
"organization": "<string>"
},
"mcp_servers": [
{
"mcpserver_id": "<string>",
"name": "<string>",
"organization": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"url": "<string>",
"description": "<string>",
"auth_header": null,
"transport_protocol": "sse",
"server_timeout_sec": -1,
"extra_data": null
}
],
"document": "<string>"
}Session Lifecycle
Retrieve Session
Retrieve session details.
GET
/
api
/
v1
/
session
/
{session_id}
/
Retrieve Session
curl --request GET \
--url https://platform.perso.ai/api/v1/session/{session_id}/import requests
url = "https://platform.perso.ai/api/v1/session/{session_id}/"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://platform.perso.ai/api/v1/session/{session_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://platform.perso.ai/api/v1/session/{session_id}/",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://platform.perso.ai/api/v1/session/{session_id}/"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://platform.perso.ai/api/v1/session/{session_id}/")
.asString();require 'uri'
require 'net/http'
url = URI("https://platform.perso.ai/api/v1/session/{session_id}/")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"session_id": "<string>",
"client_sdp": null,
"server_sdp": null,
"prompt": {
"name": "<string>",
"prompt_id": "<string>",
"system_prompt": "<string>",
"description": "<string>",
"require_document": true,
"intro_message": "<string>"
},
"llm_type": {
"name": "<string>",
"service": "openai"
},
"model_style": {
"name": "<string>",
"model": "<string>",
"model_files": [
{
"name": "<string>",
"file": "<string>"
}
],
"style": "<string>",
"files": [
{
"name": "<string>",
"file": "<string>"
}
],
"configs": [
{
"modelstyleconfig_id": "<string>",
"key": "<string>",
"value": "<string>"
}
],
"model_file": "<string>",
"file": "<string>",
"platform_type": "android"
},
"tts_type": {
"name": "<string>",
"service": "openai",
"streamable": true,
"model": "<string>",
"voice": "<string>",
"voice_settings": "<unknown>",
"style": "<string>",
"voice_extra_data": "<unknown>"
},
"text_normalization_config": {
"textnormalizationconfig_id": "<string>",
"name": "<string>",
"pre_hook_url": "<string>",
"post_hook_url": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"hook_enabled": true,
"pre_hook_args": null,
"post_hook_args": null
},
"text_normalization_locale": "<string>",
"stt_type": {
"name": "<string>",
"service": "WHISPER",
"options": null
},
"stt_text_normalization_config": {
"textnormalizationconfig_id": "<string>",
"name": "<string>",
"pre_hook_url": "<string>",
"post_hook_url": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"hook_enabled": true,
"pre_hook_args": null,
"post_hook_args": null
},
"stt_text_normalization_locale": "<string>",
"ice_servers": null,
"status": "CREATED",
"termination_reason": "GRACEFUL_TERMINATION",
"duration_sec": 123,
"created_at": "2023-11-07T05:31:56Z",
"session_acls": [
"<string>"
],
"padding_left": 123,
"padding_top": 123,
"padding_height": 123,
"background_image": {
"backgroundimage_id": "<string>",
"title": "<string>",
"image": "<string>",
"created_at": "2023-11-07T05:31:56Z"
},
"extra_data": null,
"capability": [
{
"name": "LLM",
"description": "<string>"
}
],
"agent_config": {
"agentconfig_id": "<string>",
"name": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"config": "<unknown>"
},
"interactive_agent_config": {
"interactiveagentconfig_id": "<string>",
"name": "<string>",
"description": "<string>",
"intro_message": "<string>",
"organization": "<string>"
},
"mcp_servers": [
{
"mcpserver_id": "<string>",
"name": "<string>",
"organization": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"url": "<string>",
"description": "<string>",
"auth_header": null,
"transport_protocol": "sse",
"server_timeout_sec": -1,
"extra_data": null
}
],
"document": "<string>"
}Path Parameters
Response
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
CREATED- CreatedEXCHANGED- ExchangedIN_PROGRESS- In ProgressTERMINATED- Terminated
Available options:
CREATED, EXCHANGED, IN_PROGRESS, TERMINATED GRACEFUL_TERMINATION- Graceful TerminationSESSION_EXPIRED_BEFORE_CONNECTION- Session Expired Before ConnectionSESSION_LOST_AFTER_CONNECTION- Session Lost After ConnectionSESSION_MISC_ERROR- Session Misc ErrorMAX_ACTIVE_SESSION_QUOTA_EXCEEDED- Max Active Session Quota ExceededMAX_MIN_PER_SESSION_QUOTA_EXCEEDED- Max Min Per Session Quota ExceededTOTAL_MIN_PER_MONTH_QUOTA_EXCEEDED- Total Min Per Month Quota ExceededINSUFFICIENT_CREDITS- Insufficient Credits
Available options:
GRACEFUL_TERMINATION, SESSION_EXPIRED_BEFORE_CONNECTION, SESSION_LOST_AFTER_CONNECTION, SESSION_MISC_ERROR, MAX_ACTIVE_SESSION_QUOTA_EXCEEDED, MAX_MIN_PER_SESSION_QUOTA_EXCEEDED, TOTAL_MIN_PER_MONTH_QUOTA_EXCEEDED, INSUFFICIENT_CREDITS Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Read-only discovery view of an interactive-agent config. Exposes the
identifier/name/owner plus the client-facing intro_message so a caller can
pick a pliac-* to attach at session create; prompts, tools, per-role
models, endpoint and credentials are NOT exposed (operator-managed, and
globals are shared across orgs).
Show child attributes
Show child attributes
Show child attributes
Show child attributes

