Profiles
How to save and restore profiles with Airtop
What are profiles?
Profiles are saved archives of the artifacts produced by a browsing session. Most importantly, they contain the cookies and local storage of a session, which can be used to hydrate future sessions and keep the same authenticated state. You will want to use profiles when your users need to authenticate to a site via a Live View, and you want to save the authenticated state for your agents to use.
Creating/modifying a profile
You can either create a new profile manually via the UI, or programatically via the API. You can also mix these mechanisms and bootstrap your profile via the UI, but make subsequent changes programatically.
Via the UI
- Navigate to the Profiles page
- Click the “Create new profile” button
- Enter a name for your profile and keep the “Connect to the profile after creation” checkbox selected
- Click the “Create Profile” button
- Once the profile is created, specify a URL and start the session. Once the page has loaded, log into a site and click “Finish”
You’re all set! Now you can restore the profile from the API Playground or via the API (as long as you’re using an API key in the same organization as the profile).
Programmatically
First, create a new session. During the session lifetime, if you decide you want to save the profile, you can specify a profile name for the profile to be saved under.
Profiles are only saved when the sesssion is terminated. You must remember to call sessions.terminate
on your session to ensure the profile is saved.
Restoring an existing profile
You can restore an existing profile by specifying the profile name in the sessions.create
method.
Deleting profiles
You can delete profiles by ID, if you no longer want to retain them.
Security & Privacy
Airtop takes the security and privacy of your data seriously. We never share any customer data, including profile data, with any third parties, nor do we use that data for any purpose other than to provide the service to you. All profiles are encrypted at rest using AES-256 encryption. If you have any questions or concerns about data privacy and security, please reach out to us at support@airtop.ai.