Report Anomaly
curl --request POST \
--url https://api.truthlocks.com/v1/agents/{agentId}/anomalies \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"anomaly_type": "<string>"
}
'const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({anomaly_type: '<string>'})
};
fetch('https://api.truthlocks.com/v1/agents/{agentId}/anomalies', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.truthlocks.com/v1/agents/{agentId}/anomalies"
payload = { "anomaly_type": "<string>" }
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.truthlocks.com/v1/agents/{agentId}/anomalies"
payload := strings.NewReader("{\n \"anomaly_type\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-Key", "<api-key>")
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))
}{
"anomaly_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"agent_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"anomaly_type": "<string>",
"severity": "low",
"details": {},
"status": "open",
"resolution": "<string>",
"resolved_by": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"resolved_at": "2023-11-07T05:31:56Z"
}{
"code": "AUTH_REQUIRED",
"message": "Authentication required",
"http_status": 401
}{
"code": "AUTH_REQUIRED",
"message": "Authentication required",
"http_status": 401
}{
"code": "AUTH_REQUIRED",
"message": "Authentication required",
"http_status": 401
}{
"code": "AUTH_REQUIRED",
"message": "Authentication required",
"http_status": 401
}Compliance & Anomalies
Report Anomaly
Report a behavioral anomaly detected in an AI agent’s activity.
POST
/
v1
/
agents
/
{agentId}
/
anomalies
Report Anomaly
curl --request POST \
--url https://api.truthlocks.com/v1/agents/{agentId}/anomalies \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"anomaly_type": "<string>"
}
'const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({anomaly_type: '<string>'})
};
fetch('https://api.truthlocks.com/v1/agents/{agentId}/anomalies', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.truthlocks.com/v1/agents/{agentId}/anomalies"
payload = { "anomaly_type": "<string>" }
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.truthlocks.com/v1/agents/{agentId}/anomalies"
payload := strings.NewReader("{\n \"anomaly_type\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-Key", "<api-key>")
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))
}{
"anomaly_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"agent_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"anomaly_type": "<string>",
"severity": "low",
"details": {},
"status": "open",
"resolution": "<string>",
"resolved_by": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"resolved_at": "2023-11-07T05:31:56Z"
}{
"code": "AUTH_REQUIRED",
"message": "Authentication required",
"http_status": 401
}{
"code": "AUTH_REQUIRED",
"message": "Authentication required",
"http_status": 401
}{
"code": "AUTH_REQUIRED",
"message": "Authentication required",
"http_status": 401
}{
"code": "AUTH_REQUIRED",
"message": "Authentication required",
"http_status": 401
}Reports a behavioral anomaly detected in an AI agent’s activity. Anomalies are flagged observations that indicate an agent may be operating outside its expected behavioral envelope — such as sudden rate spikes, scope violations, trust score drops, or geographic access anomalies.
Anomaly reports create actionable alerts for security teams and can trigger automated response policies (e.g., throttling, session revocation, or agent suspension) depending on severity and tenant configuration.
Anomaly Types
| Type | Description |
|---|---|
rate_spike | Agent’s request rate significantly exceeds historical baseline |
scope_violation | Agent attempted to access a resource outside its granted scopes |
trust_drop | Agent’s computed trust score dropped below threshold |
pattern_deviation | Agent’s behavioral pattern deviates from its trained baseline |
geographic_anomaly | Agent accessed from an unexpected geographic location or IP range |
Severity Levels
| Severity | SLA | Auto-Response |
|---|---|---|
low | 24h review | Logged only |
medium | 4h review | Agent throttled |
high | 1h review | Sessions suspended |
critical | 15min review | Agent revoked pending investigation |
Response
Body
application/json
Response
Anomaly reported

