---
schema_version: "1"
id: 1eda13059bdc3edf16053178c79e8e38fec6f93b6f3bde0ef57d14d6ef11c8c0
title: TenantSecurityApiAnomaly
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/object_reference/sforce_api_objects_tenantsecurityapianomaly.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_tenantsecurityapianomaly.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: 6bd50e985a505fc1f2d7f8d672daf77f5f6ed19f268b9bafa60e827066349e19
description: Stores detected anomalies in how users typically make API calls. Fore more information, see Threat Detection. This object is available to Security Center subscribers in API version 53.0 and later.
---
# TenantSecurityApiAnomaly

Stores detected anomalies in how users typically make API calls. Fore more information, see [Threat Detection](https://help.salesforce.com/s/articleView?language=en_US&type=5&id=sf.real_time_em_threat_detection.htm). This object is available to Security Center subscribers in API version 53.0 and later.

![Note](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/images/icon_note.png)

#### Note

Threat Detection is available only for Event Monitoring subscribers.

## Supported Calls

describeSObjects(), getDeleted(), getUpdated(), query(), retrieve()

## Special Access Rules

This object is read-only.

## Fields

| Field | Details |
| --- | --- |
| DetailIdentifier | 
Type

string

Properties

Filter, Group, idLookup, Sort

Description

The ID of the individual detail record. This field is unique within your org.



 |
| EventDate | 

Type

dateTime

Properties

Filter, Nillable, Sort

Description

The time when the anomaly was reported. For example, 2020-01-20T19:12:26.965Z. The most granular setting is milliseconds.



 |
| EventIdentifier | 

Type

string

Properties

Filter, Group, idLookup, Nillable, Sort

Description

The unique ID of the event, which is shared with the corresponding storage object.



 |
| EventName | 

Type

string

Properties

Filter, Group, idLookup, Nillable, Sort

Description

The name of the event, which is Api Anomaly.



 |
| MetricIdentifier | 

Type

string

Properties

Filter, Group, Sort

Description

The ID of the type of metric that was counted.



 |
| MetricsType | 

Type

picklist

Properties

Filter, Group, Restricted picklist, Sort

Description

The type of data collected.



 |
| Name | 

Type

string

Properties

Filter, Group, idLookup, Sort

Description

The name of the metric for the data collected.



 |
| Operation | 

Type

string

Properties

Filter, Group, Nillable, Sort

Description

The API call that generated the event. For example, Query.



 |
| QueriedEntities | 

Type

textarea

Properties

Nillable

Description

The type of entities associated with the event.



 |
| RequestIdentifier | 

Type

string

Properties

Filter, Group, Nillable, Sort

Description

The unique ID of a single transaction. A transaction can contain one or more events.



 |
| RowsProcessed | 

Type

double

Properties

Filter, Nillable, Sort

Description

Total row count for the current operation.



 |
| Score | 

Type

double

Properties

Filter, idLookup, Nillable, Sort

Description

A number from 0 through 100 that represents the anomaly score for the API execution or export tracked by this event. The anomaly score shows how the current API activity differs from the user’s typical activity. A low score indicates that the user’s current API activity is similar to the usual activity, and a high score indicates that it’s different.



 |
| SecurityEventData | 

Type

textarea

Properties

Nillable

Description

The set of features about the API activity that triggered this anomaly event.

For example, a user typically downloads 10 accounts at a time but then deviates from that pattern and downloads 1,000 accounts. This event is triggered, and the contributing features are captured in this field. Potential features include row count, column count, average row size, day of week, and the browser’s user agent used for the report activity. The data captured also shows how much as a percentage that the feature contributed to triggering this anomaly event. The data is in JSON format.





 |
| Summary | 

Type

textarea

Properties

Nillable

Description

A text summary of the API anomaly that caused this event.



 |
| Tenant | 

Type

string

Properties

Filter, Group, idLookup, Sort

Description

The ID of the tenant that was targeted in the event.



 |
| TenantName | 

Type

string

Properties

Filter, Group, idLookup, Nillable, Sort

Description

The name of the tenant that was targeted in the event.



 |
| Uri | 

Type

string

Properties

Filter, Group, Nillable, Sort

Description

The URI of the page that’s receiving the request. For example: /home/home.jsp.



 |
| UserAgent | 

Type

textarea

Properties

Nillable

Description

UserAgent used in the HTTP request, post-processed by the server.



 |
| UserIdentifier | 

Type

string

Properties

Filter, Group, Nillable, Sort

Description

The origin user’s unique ID.



 |
| Username | 

Type

string

Properties

Filter, Group, idLookup, Nillable, Sort

Description

The origin username in the format of user@company.com at the time that the event was created.



 |

## Associated Objects

This object has these associated objects. If the API version isn’t specified, it’s available in the same API versions as this object. Otherwise, it’s available in the specified API version and later.

[TenantSecurityApiAnomalyChangeEvent](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_associated_objects_change_event.htm "A ChangeEvent object is available for each object that supports Change Data Capture. You can subscribe to a stream of change events using Change Data Capture to receive data tied to record changes in Salesforce. Changes include record creation, updates to an existing record, deletion of a record, and undeletion of a record. A change event isn’t a Salesforce object—it doesn’t support CRUD operations or queries. It’s included in the object reference so you can discover which Salesforce objects support change events.")

Change events are available for the object.

[TenantSecurityApiAnomalyFeed](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_associated_objects_feed.htm "StandardObjectNameFeed is the model for all feed objects associated with standard objects. These objects represent the posts and feed-tracked changes of a standard object.")

Feed tracking is available for the object.

[TenantSecurityApiAnomalyHistory](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_associated_objects_history.htm "StandardObjectNameHistory is the model for all history objects associated with standard objects. These objects represent the history of changes to the values in the fields of a standard object.")

History is available for tracked fields of the object.

[TenantSecurityApiAnomalyOwnerSharingRule](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_associated_objects_ownersharingrule.htm "StandardObjectNameOwnerSharingRule is the model for all owner sharing rule objects associated with standard objects. These objects represent a rule for sharing a standard object with users other than the owner.")

Sharing rules are available for the object.

[TenantSecurityApiAnomalyShare](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_associated_objects_share.htm "StandardObjectNameShare is the model for all share objects associated with standard objects. These objects represent a sharing entry on the standard object.")

Sharing is available for the object.