curl --request GET \
--url https://api.mnemom.ai/v1/agent/sessions/{conversationId} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.mnemom.ai/v1/agent/sessions/{conversationId}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.mnemom.ai/v1/agent/sessions/{conversationId}', 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.mnemom.ai/v1/agent/sessions/{conversationId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$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://api.mnemom.ai/v1/agent/sessions/{conversationId}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.mnemom.ai/v1/agent/sessions/{conversationId}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.mnemom.ai/v1/agent/sessions/{conversationId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"conversation_id": "<string>",
"agent": {
"id": "<string>",
"name": "<string>"
},
"org_id": "<string>",
"sealed": {
"contract": "<unknown>",
"hash": "<string>",
"sealed_at": "2023-11-07T05:31:56Z",
"version": 123,
"seal_reason": "first",
"expired_hash": "<string>",
"updated_from": "<string>"
},
"verdict": {
"turn": 123,
"verdict": "<string>",
"reason": "<string>",
"at": "<string>",
"streak_start": 123
},
"turn": 123,
"guardrails": {
"ceilings": {
"max_turns": 123,
"budget_usd": 123,
"stall_turns": 123,
"time_limit_s": 123
},
"state": {
"turns": 123,
"spend_usd": 123,
"stall_run": 123,
"fired": {
"turns": true,
"budget": true,
"stall": true,
"time": true
}
}
},
"seal": {
"state": "live",
"version": 123,
"hash": "<string>",
"sealed_at": "2023-11-07T05:31:56Z",
"reason": "first",
"expired_hash": "<string>",
"updated_from_hash": "<string>",
"mode": "nudge"
},
"verdict_trail": [
{
"request_id": "<string>",
"turn": 123,
"verdict": "aligned",
"reason": "<string>",
"fence_breach": true,
"at": "<string>",
"ceilings": [
"turns"
]
}
],
"unjudged_turns": 123,
"memoised_turns": 123
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": "<unknown>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": "<unknown>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": "<unknown>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": "<unknown>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": "<unknown>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": "<unknown>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": "<unknown>"
}
}Live goal state of one Mnemom Agent session
Backs mnemom agent show.
curl --request GET \
--url https://api.mnemom.ai/v1/agent/sessions/{conversationId} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.mnemom.ai/v1/agent/sessions/{conversationId}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.mnemom.ai/v1/agent/sessions/{conversationId}', 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.mnemom.ai/v1/agent/sessions/{conversationId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$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://api.mnemom.ai/v1/agent/sessions/{conversationId}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.mnemom.ai/v1/agent/sessions/{conversationId}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.mnemom.ai/v1/agent/sessions/{conversationId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"conversation_id": "<string>",
"agent": {
"id": "<string>",
"name": "<string>"
},
"org_id": "<string>",
"sealed": {
"contract": "<unknown>",
"hash": "<string>",
"sealed_at": "2023-11-07T05:31:56Z",
"version": 123,
"seal_reason": "first",
"expired_hash": "<string>",
"updated_from": "<string>"
},
"verdict": {
"turn": 123,
"verdict": "<string>",
"reason": "<string>",
"at": "<string>",
"streak_start": 123
},
"turn": 123,
"guardrails": {
"ceilings": {
"max_turns": 123,
"budget_usd": 123,
"stall_turns": 123,
"time_limit_s": 123
},
"state": {
"turns": 123,
"spend_usd": 123,
"stall_run": 123,
"fired": {
"turns": true,
"budget": true,
"stall": true,
"time": true
}
}
},
"seal": {
"state": "live",
"version": 123,
"hash": "<string>",
"sealed_at": "2023-11-07T05:31:56Z",
"reason": "first",
"expired_hash": "<string>",
"updated_from_hash": "<string>",
"mode": "nudge"
},
"verdict_trail": [
{
"request_id": "<string>",
"turn": 123,
"verdict": "aligned",
"reason": "<string>",
"fence_breach": true,
"at": "<string>",
"ceilings": [
"turns"
]
}
],
"unjudged_turns": 123,
"memoised_turns": 123
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": "<unknown>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": "<unknown>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": "<unknown>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": "<unknown>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": "<unknown>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": "<unknown>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": "<unknown>"
}
}Authorizations
Query Parameters
Response
The session's live goal state. Every gateway-owned section is nullable — a session that never sealed a goal contract returns sealed: null, verdict: null, turn: null, guardrails: null.
- Option 1
- Option 2
The seal's lifecycle. live: a sealed contract currently governs. expired: the prior seal lapsed (24h idle) and the next engaged request will seal afresh. null normally means no seal has ever been made for this conversation, but the API also returns null if the gateway sent a seal payload out of contract (an unknown state, or a required subfield missing/mistyped) — a malformed seal is dropped rather than relayed half-trusted, since mode (nudge vs enforce) is conformance-relevant. The two cases are distinguished in the API's own logs (component: "agent-session", event: "seal_dropped"), not in this field.
- Option 1
- Option 2
Show child attributes
Show child attributes