{"id":"sforce_api_objects_authsession","title":"AuthSession","content":"<a name=\"sforce_api_objects_authsession\"><!-- --></a><h1 class=\"helpHead1\">AuthSession</h1><div class=\"body\">\n<div class=\"shortdesc\">\n<span class=\"ph\" id=\"summary\"><a name=\"summary\"><!-- --></a>The AuthSession object represents an individual user session in your\n   organization. </span>This object is available in versions 29.0 and later.</div>\n\n  <div class=\"section\">\n<h2 class=\"helpHead2\">Supported Calls</h2>\n\n   \n   <p class=\"p\"><samp class=\"codeph nolang\">delete()</samp>, <samp class=\"codeph nolang\">describeSObjects()</samp>, <samp class=\"codeph nolang\">query()</samp>, <samp class=\"codeph nolang\">retrieve()</samp></p>\n\n  </div>\n\n  <div class=\"section\">\n<h2 class=\"helpHead2\">Fields</h2>\n\n   \n   \n<div class=\"data colSort\"><table class=\"featureTable sort_table\" summary=\"\">\n     \n     \n     <thead class=\"thead sorted\" align=\"left\">\n      <tr>\n       <th class=\"featureTableHeader  \" id=\"d262150e79\">Field Name</th>\n\n       <th class=\"featureTableHeader  \" id=\"d262150e82\">Details</th>\n\n      </tr>\n\n     </thead>\n\n     <tbody class=\"tbody\">\n      <tr>\n       <td class=\"entry\" headers=\"d262150e79\" data-title=\"Field Name\"><span class=\"keyword parmname\">CreatedDate</span></td>\n\n       <td class=\"entry\" headers=\"d262150e82\" data-title=\"Details\">\n        <dl class=\"dl detailList\">\n         \n          <dt class=\"dt dlterm\">Type</dt>\n\n          <dd class=\"dd\">dateTime</dd>\n\n         \n         \n          <dt class=\"dt dlterm\">Properties</dt>\n\n          <dd class=\"dd\">Defaulted on create, Filter, Sort</dd>\n\n         \n         \n          <dt class=\"dt dlterm\">Description</dt>\n\n          <dd class=\"dd\">The date and time this session was created. This field is a standard system\n           field.</dd>\n\n         \n        </dl>\n\n       </td>\n\n      </tr>\n\n      <tr>\n       <td class=\"entry\" headers=\"d262150e79\" data-title=\"Field Name\"><span class=\"keyword parmname\">Id</span></td>\n\n       <td class=\"entry\" headers=\"d262150e82\" data-title=\"Details\">\n        <dl class=\"dl detailList\">\n         \n          <dt class=\"dt dlterm\">Type</dt>\n\n          <dd class=\"dd\">id</dd>\n\n         \n         \n          <dt class=\"dt dlterm\">Properties</dt>\n\n          <dd class=\"dd\">Defaulted on create, Filter, Group, ID Lookup, Sort</dd>\n\n         \n         \n          <dt class=\"dt dlterm\">Description</dt>\n\n          <dd class=\"dd\">The current session’s ID.</dd>\n\n         \n        </dl>\n\n       </td>\n\n      </tr>\n\n      <tr>\n       <td class=\"entry\" headers=\"d262150e79\" data-title=\"Field Name\"><span class=\"keyword parmname\">IsAssociatedWithJwtAccessToken</span></td>\n\n       <td class=\"entry\" headers=\"d262150e82\" data-title=\"Details\">\n        <dl class=\"dl detailList\">\n         \n          <dt class=\"dt dlterm\">Type</dt>\n\n          <dd class=\"dd\">boolean</dd>\n\n         \n         \n          <dt class=\"dt dlterm\">Properties</dt>\n\n          <dd class=\"dd\">Defaulted on create, Filter, Group, Sort</dd>\n\n         \n         \n          <dt class=\"dt dlterm\">Description</dt>\n\n          <dd class=\"dd\">If <samp class=\"codeph nolang\">true</samp>, the session is associated with a\n            JSON Web Token (JWT)-based access token. This field is available in API version\n           64.0 and later.</dd>\n\n         \n        </dl>\n\n       </td>\n\n      </tr>\n\n      <tr>\n       <td class=\"entry\" headers=\"d262150e79\" data-title=\"Field Name\"><span class=\"keyword parmname\">IsCurrent</span></td>\n\n       <td class=\"entry\" headers=\"d262150e82\" data-title=\"Details\">\n        <dl class=\"dl detailList\">\n         \n          <dt class=\"dt dlterm\">Type</dt>\n\n          <dd class=\"dd\">boolean</dd>\n\n         \n         \n          <dt class=\"dt dlterm\">Properties</dt>\n\n          <dd class=\"dd\">Defaulted on create, Filter, Group, Sort</dd>\n\n         \n         \n          <dt class=\"dt dlterm\">Description</dt>\n\n          <dd class=\"dd\">\n<span class=\"ph\" id=\"IsCurrentDesc\"><a name=\"IsCurrentDesc\"><!-- --></a>If <span class=\"keyword parmname\">true</span>, the session is a member of the\n            user’s current session family.</span> This field is available in API version 37.0 and\n           later.</dd>\n\n         \n        </dl>\n\n       </td>\n\n      </tr>\n\n      <tr>\n       <td class=\"entry\" headers=\"d262150e79\" data-title=\"Field Name\"><span class=\"keyword parmname\">LastModifiedDate</span></td>\n\n       <td class=\"entry\" headers=\"d262150e82\" data-title=\"Details\">\n        <dl class=\"dl detailList\">\n         \n          <dt class=\"dt dlterm\">Type</dt>\n\n          <dd class=\"dd\">dateTime</dd>\n\n         \n         \n          <dt class=\"dt dlterm\">Properties</dt>\n\n          <dd class=\"dd\">Defaulted on create, Filter, Sort</dd>\n\n         \n         \n          <dt class=\"dt dlterm\">Description</dt>\n\n          <dd class=\"dd\">The date and time this session was last updated. A session expires when the current\n           date and time equals <span class=\"keyword parmname\">LastModifiedDate</span> +\n            <span class=\"keyword parmname\">NumSecondsValid</span>. This field is a standard system field.</dd>\n\n         \n        </dl>\n\n       </td>\n\n      </tr>\n\n      <tr>\n       <td class=\"entry\" headers=\"d262150e79\" data-title=\"Field Name\"><span class=\"keyword parmname\">LoginGeoId</span></td>\n\n       <td class=\"entry\" headers=\"d262150e82\" data-title=\"Details\">\n        <dl class=\"dl detailList\">\n         \n          <dt class=\"dt dlterm\">Type</dt>\n\n          <dd class=\"dd\">reference</dd>\n\n         \n         \n          <dt class=\"dt dlterm\">Properties</dt>\n\n          <dd class=\"dd\">Filter, Group, Nillable, Sort</dd>\n\n         \n         \n          <dt class=\"dt dlterm\">Description</dt>\n\n          <dd class=\"dd\">The 18-character ID for the record of the geographic location of the user for a login\n           event. Due to the nature of geolocation technology, the accuracy of geolocation fields\n           (for example, country, city, postal code) can vary. This field is available in API\n           version 34.0 and later.</dd>\n\n          <dd class=\"dd\">This is a relationship field.</dd>\n\n         \n         \n          <dt class=\"dt dlterm\">Relationship Name</dt>\n\n          <dd class=\"dd\">LoginGeo</dd>\n\n         \n         \n          <dt class=\"dt dlterm\">Relationship Type</dt>\n\n          <dd class=\"dd\">Lookup</dd>\n\n         \n         \n          <dt class=\"dt dlterm\">Refers To</dt>\n\n          <dd class=\"dd\">LoginGeo</dd>\n\n         \n        </dl>\n\n       </td>\n\n      </tr>\n\n      <tr>\n       <td class=\"entry\" headers=\"d262150e79\" data-title=\"Field Name\"><span class=\"keyword parmname\">LoginHistoryId</span></td>\n\n       <td class=\"entry\" headers=\"d262150e82\" data-title=\"Details\">\n        <dl class=\"dl detailList\">\n         \n          <dt class=\"dt dlterm\">Type</dt>\n\n          <dd class=\"dd\">reference</dd>\n\n         \n         \n          <dt class=\"dt dlterm\">Properties</dt>\n\n          <dd class=\"dd\">Filter, Group, Nillable, Sort</dd>\n\n         \n         \n          <dt class=\"dt dlterm\">Description</dt>\n\n          <dd class=\"dd\">The 18-character ID for a successful login event. When a session is reused, Salesforce\n           updates the <samp class=\"codeph apex_code\">LoginHistoryId</samp> with the value from\n           the most recent login. This field is available in API version 33.0 and later.</dd>\n\n          <dd class=\"dd\">This is a relationship field.</dd>\n\n         \n         \n          <dt class=\"dt dlterm\">Relationship Name</dt>\n\n          <dd class=\"dd\">LoginHistory</dd>\n\n         \n         \n          <dt class=\"dt dlterm\">Relationship Type</dt>\n\n          <dd class=\"dd\">Lookup</dd>\n\n         \n         \n          <dt class=\"dt dlterm\">Refers To</dt>\n\n          <dd class=\"dd\">LoginHistory</dd>\n\n         \n        </dl>\n\n       </td>\n\n      </tr>\n\n      <tr>\n       <td class=\"entry\" headers=\"d262150e79\" data-title=\"Field Name\"><span class=\"keyword parmname\">LoginType</span></td>\n\n       <td class=\"entry\" headers=\"d262150e82\" data-title=\"Details\">\n        <dl class=\"dl detailList\">\n         \n          <dt class=\"dt dlterm\">Type</dt>\n\n          <dd class=\"dd\">picklist</dd>\n\n         \n         \n          <dt class=\"dt dlterm\">Properties</dt>\n\n          <dd class=\"dd\">Filter, Group, Nillable, Restricted picklist, Sort</dd>\n\n         \n         \n          <dt class=\"dt dlterm\">Description</dt>\n\n          <dd class=\"dd\">\n<span class=\"ph\" id=\"def_logintype\"><a name=\"def_logintype\"><!-- --></a>The type of login used to access the session.</span> Possible\n           values are: <ul class=\"ul bulletList\">\n            <li class=\"li\"><samp class=\"codeph nolang\">AJAX Toolkit</samp></li>\n\n            <li class=\"li\"><samp class=\"codeph nolang\">Apex Office Toolkit</samp></li>\n\n            <li class=\"li\"><samp class=\"codeph nolang\">AppExchange</samp></li>\n\n            <li class=\"li\"><samp class=\"codeph nolang\">Application</samp></li>\n\n            <li class=\"li\"><samp class=\"codeph nolang\">AppStore</samp></li>\n\n            <li class=\"li\"><samp class=\"codeph nolang\">Certificate-based login</samp></li>\n\n            <li class=\"li\"><samp class=\"codeph nolang\">Chatter Communities External User</samp></li>\n\n            <li class=\"li\"><samp class=\"codeph nolang\">Chatter Communities External User Third Party\n              SSO</samp></li>\n\n            <li class=\"li\"><samp class=\"codeph nolang\">Community</samp></li>\n\n            <li class=\"li\"><samp class=\"codeph nolang\">Customer Service Portal Third-Party SSO</samp></li>\n\n            <li class=\"li\"><samp class=\"codeph nolang\">Customer Service Portal</samp></li>\n\n            <li class=\"li\"><samp class=\"codeph nolang\">DataJunction</samp></li>\n\n            <li class=\"li\"><samp class=\"codeph nolang\">DB Replication</samp></li>\n\n            <li class=\"li\"><samp class=\"codeph nolang\">Employee Login to Community</samp></li>\n\n            <li class=\"li\"><samp class=\"codeph nolang\">Excel Integration</samp></li>\n\n            <li class=\"li\"><samp class=\"codeph nolang\">Help and Training</samp></li>\n\n            <li class=\"li\"><samp class=\"codeph nolang\">HOTP YubiKey</samp></li>\n\n            <li class=\"li\"><samp class=\"codeph nolang\">Lightning Login</samp></li>\n\n            <li class=\"li\"><samp class=\"codeph nolang\">Networks Portal API Only</samp></li>\n\n            <li class=\"li\"><samp class=\"codeph nolang\">Offline Client</samp></li>\n\n            <li class=\"li\"><samp class=\"codeph nolang\">Order Center</samp></li>\n\n            <li class=\"li\"><samp class=\"codeph nolang\">Other Apex API</samp></li>\n\n            <li class=\"li\"><samp class=\"codeph nolang\">Outlook Integration</samp></li>\n\n            <li class=\"li\"><samp class=\"codeph nolang\">Partner Portal Third-Party SSO</samp></li>\n\n            <li class=\"li\"><samp class=\"codeph nolang\">Partner Portal</samp></li>\n\n            <li class=\"li\"><samp class=\"codeph nolang\">Partner Product</samp></li>\n\n            <li class=\"li\"><samp class=\"codeph nolang\">Passwordless Login</samp></li>\n\n            <li class=\"li\"><samp class=\"codeph nolang\">Remote Access 2.0</samp></li>\n\n            <li class=\"li\"><samp class=\"codeph nolang\">Remote Access Client</samp></li>\n\n            <li class=\"li\"><samp class=\"codeph nolang\">Sales Anywhere</samp></li>\n\n            <li class=\"li\"><samp class=\"codeph nolang\">Salesforce Outlook Integration</samp></li>\n\n            <li class=\"li\"><samp class=\"codeph nolang\">Salesforce.com Website</samp></li>\n\n            <li class=\"li\"><samp class=\"codeph nolang\">SAML Chatter Communities External User SSO</samp></li>\n\n            <li class=\"li\"><samp class=\"codeph nolang\">SAML Customer Service Portal SSO</samp></li>\n\n            <li class=\"li\"><samp class=\"codeph nolang\">SAML Idp Initiated SSO</samp></li>\n\n            <li class=\"li\"><samp class=\"codeph nolang\">SAML Partner Portal SSO</samp></li>\n\n            <li class=\"li\"><samp class=\"codeph nolang\">SAML Sfdc Initiated SSO</samp></li>\n\n            <li class=\"li\"><samp class=\"codeph nolang\">SAML Site SSO</samp></li>\n\n            <li class=\"li\"><samp class=\"codeph nolang\">Self-Service</samp></li>\n\n            <li class=\"li\"><samp class=\"codeph nolang\">Signup</samp></li>\n\n            <li class=\"li\"><samp class=\"codeph nolang\">Sync</samp></li>\n\n            <li class=\"li\"><samp class=\"codeph nolang\">SysAdmin Switch</samp></li>\n\n            <li class=\"li\"><samp class=\"codeph nolang\">Third Party SSO</samp></li>\n\n            <li class=\"li\"><samp class=\"codeph nolang\">Unknown</samp></li>\n\n            <li class=\"li\"><samp class=\"codeph nolang\">Validate</samp></li>\n\n           </ul>\n</dd>\n\n         \n        </dl>\n\n       </td>\n\n      </tr>\n\n      <tr>\n       <td class=\"entry\" headers=\"d262150e79\" data-title=\"Field Name\"><span class=\"keyword parmname\">LogoutUrl</span></td>\n\n       <td class=\"entry\" headers=\"d262150e82\" data-title=\"Details\">\n        <dl class=\"dl detailList\">\n         \n          <dt class=\"dt dlterm\">Type</dt>\n\n          <dd class=\"dd\">string</dd>\n\n         \n         \n          <dt class=\"dt dlterm\">Properties</dt>\n\n          <dd class=\"dd\">Filter, Nillable, Sort</dd>\n\n         \n         \n          <dt class=\"dt dlterm\">Description</dt>\n\n          <dd class=\"dd\">The page or view to display after users log out of an Experience Cloud site, or an org\n           if they authenticated using SAML. This field is available in API version 32.0 and\n           later.</dd>\n\n         \n        </dl>\n\n       </td>\n\n      </tr>\n\n      <tr>\n       <td class=\"entry\" headers=\"d262150e79\" data-title=\"Field Name\"><span class=\"keyword parmname\">NumSecondsValid</span></td>\n\n       <td class=\"entry\" headers=\"d262150e82\" data-title=\"Details\">\n        <dl class=\"dl detailList\">\n         \n          <dt class=\"dt dlterm\">Type</dt>\n\n          <dd class=\"dd\">int</dd>\n\n         \n         \n          <dt class=\"dt dlterm\">Properties</dt>\n\n          <dd class=\"dd\">Filter, Group, Sort</dd>\n\n         \n         \n          <dt class=\"dt dlterm\">Description</dt>\n\n          <dd class=\"dd\">The number of seconds before the session expires, starting from the last update\n           time.</dd>\n\n         \n        </dl>\n\n       </td>\n\n      </tr>\n\n      <tr>\n       <td class=\"entry\" headers=\"d262150e79\" data-title=\"Field Name\"><span class=\"keyword parmname\">ParentId</span></td>\n\n       <td class=\"entry\" headers=\"d262150e82\" data-title=\"Details\">\n        <dl class=\"dl detailList\">\n         \n          <dt class=\"dt dlterm\">Type</dt>\n\n          <dd class=\"dd\">reference</dd>\n\n         \n         \n          <dt class=\"dt dlterm\">Properties</dt>\n\n          <dd class=\"dd\">Filter, Group, Nillable, Sort</dd>\n\n         \n         \n          <dt class=\"dt dlterm\">Description</dt>\n\n          <dd class=\"dd\">The 18-character ID for the parent session, if one exists (for example, if the current\n           session is for a canvas app). If the current session doesn’t have a parent, this value is\n           the current session’s own ID. </dd>\n\n         \n        </dl>\n\n       </td>\n\n      </tr>\n\n      <tr>\n       <td class=\"entry\" headers=\"d262150e79\" data-title=\"Field Name\"><span class=\"keyword parmname\">SessionSecurityLevel</span></td>\n\n       <td class=\"entry\" headers=\"d262150e82\" data-title=\"Details\">\n        <dl class=\"dl detailList\">\n         \n          <dt class=\"dt dlterm\">Type</dt>\n\n          <dd class=\"dd\">picklist</dd>\n\n         \n         \n          <dt class=\"dt dlterm\">Properties</dt>\n\n          <dd class=\"dd\">Filter, Group, Nillable, Restricted picklist, Sort</dd>\n\n         \n         \n          <dt class=\"dt dlterm\">Description</dt>\n\n          <dd class=\"dd\">Standard or High, depending upon the authentication method used.</dd>\n\n         \n        </dl>\n\n       </td>\n\n      </tr>\n\n      <tr>\n       <td class=\"entry\" headers=\"d262150e79\" data-title=\"Field Name\"><span class=\"keyword parmname\">SessionType</span></td>\n\n       <td class=\"entry\" headers=\"d262150e82\" data-title=\"Details\">\n        <dl class=\"dl detailList\">\n         \n          <dt class=\"dt dlterm\">Type</dt>\n\n          <dd class=\"dd\">picklist</dd>\n\n         \n         \n          <dt class=\"dt dlterm\">Properties</dt>\n\n          <dd class=\"dd\">Filter, Group, Nillable, Restricted picklist, Sort</dd>\n\n         \n         \n          <dt class=\"dt dlterm\">Description</dt>\n\n          <dd class=\"dd\">The type of session. Common ones are UI, Content, API, and Visualforce.</dd>\n\n          <dd class=\"dd\">For more information, see <a class=\"xref\" href=\"https://help.salesforce.com/s/articleView?id=xcloud.security_session_types.htm&amp;type=5&amp;language=en_US\" target=\"_blank\" title=\"HTML (New Window)\">User Session Types</a> in the\n            <cite class=\"cite\">Object Reference Guide</cite>.</dd>\n\n         \n        </dl>\n\n       </td>\n\n      </tr>\n\n      <tr>\n       <td class=\"entry\" headers=\"d262150e79\" data-title=\"Field Name\"><span class=\"keyword parmname\">SourceIp</span></td>\n\n       <td class=\"entry\" headers=\"d262150e82\" data-title=\"Details\">\n        <dl class=\"dl detailList\">\n         \n          <dt class=\"dt dlterm\">Type</dt>\n\n          <dd class=\"dd\">string</dd>\n\n         \n         \n          <dt class=\"dt dlterm\">Properties</dt>\n\n          <dd class=\"dd\">Filter, Group, Sort</dd>\n\n         \n         \n          <dt class=\"dt dlterm\">Description</dt>\n\n          <dd class=\"dd\">IP address of the end user’s device from which the session started. This\n           address can be an IPv4 or IPv6 address.</dd>\n\n          <dd class=\"dd\">The <span class=\"keyword parmname\">SourceIp</span> field doesn't support the <samp class=\"codeph nolang\">LIKE</samp>\n           <a class=\"xref\" href=\"https://developer.salesforce.com/docs/atlas.en-us.260.0.soql_sosl.meta/soql_sosl/sforce_api_calls_soql_select_comparisonoperators.htm\" target=\"_blank\">comparison operator</a>.</dd>\n\n         \n        </dl>\n\n       </td>\n\n      </tr>\n\n      <tr>\n       <td class=\"entry\" headers=\"d262150e79\" data-title=\"Field Name\"><span class=\"keyword parmname\">UserType</span></td>\n\n       <td class=\"entry\" headers=\"d262150e82\" data-title=\"Details\">\n        <dl class=\"dl detailList\">\n         \n          <dt class=\"dt dlterm\">Type</dt>\n\n          <dd class=\"dd\">picklist</dd>\n\n         \n         \n          <dt class=\"dt dlterm\">Properties</dt>\n\n          <dd class=\"dd\">Filter, Group, Restricted picklist, Sort</dd>\n\n         \n         \n          <dt class=\"dt dlterm\">Description</dt>\n\n          <dd class=\"dd\">The kind of user for this session. Types include Standard, Partner, Customer Portal\n           Manager, High Volume Portal, and CSN Only.</dd>\n\n         \n        </dl>\n\n       </td>\n\n      </tr>\n\n      <tr>\n       <td class=\"entry\" headers=\"d262150e79\" data-title=\"Field Name\"><span class=\"keyword parmname\">UsersId</span></td>\n\n       <td class=\"entry\" headers=\"d262150e82\" data-title=\"Details\">\n        <dl class=\"dl detailList\">\n         \n          <dt class=\"dt dlterm\">Type</dt>\n\n          <dd class=\"dd\">reference</dd>\n\n         \n         \n          <dt class=\"dt dlterm\">Properties</dt>\n\n          <dd class=\"dd\">Filter, Group, Nillable, Sort</dd>\n\n         \n         \n          <dt class=\"dt dlterm\">Description</dt>\n\n          <dd class=\"dd\">The user’s Salesforce user ID.</dd>\n\n          <dd class=\"dd\">This is a relationship field.</dd>\n\n         \n         \n          <dt class=\"dt dlterm\">Relationship Name</dt>\n\n          <dd class=\"dd\">Users</dd>\n\n         \n         \n          <dt class=\"dt dlterm\">Relationship Type</dt>\n\n          <dd class=\"dd\">Lookup</dd>\n\n         \n         \n          <dt class=\"dt dlterm\">Refers To</dt>\n\n          <dd class=\"dd\">User</dd>\n\n         \n        </dl>\n\n       </td>\n\n      </tr>\n\n     </tbody>\n\n    </table></div>\n\n  </div>\n\n  <div class=\"section\">\n<h2 class=\"helpHead2\">Usage</h2>\n\n   \n   <p class=\"p\">The AuthSession object exposes session data and enables read and delete operations on that\n    data. For example, use this object to see who is signed in to your org. Or you can use this\n    object to create a tool to delete a session, ending that user’s session. For a user, only their\n    own sessions are available, while administrators can see all sessions.</p>\n\n   <p class=\"p\">You can’t change user sessions with this object. You can only read and delete them.</p>\n\n  </div>\n\n </div><div id=\"sfdc:seealso\" class=\"related-links\"></div>"}