---
title: "Session Profile Save"
method: POST
path: "/sessions/{session_id}/profile/save"
tags: ["sessions"]
---

# Session Profile Save

`POST /sessions/{session_id}/profile/save`

## Request

- Base URL: `https://api.notte.cc` (the document declares no server; this is the origin it was published from)
- URL: `https://api.notte.cc/sessions/{session_id}/profile/save`
- Auth: OAuth 2
  - Password
  - Token URL: `token`

## Path parameters

- `session_id` string, required

## Headers

- `x-notte-request-origin` string, nullable
- `x-notte-sdk-version` string, nullable

## Request body

- SessionProfileSaveRequest
  - `profile_id` string, nullable: Existing profile to overwrite with the session's current browser state. Omit it together with name to save into the profile the session was started with.
  - `name` string, nullable: Create a new profile with this name and save into it. Mutually exclusive with profile_id.

## Response `200`

Successful Response

- ProfileResponse
  - `profile_id` string, required: Profile ID (format: `notte-profile-{16 hex chars}`)
  - `name` string, nullable, required: Profile name
  - `created_at` string, date-time, required: Profile creation timestamp
  - `updated_at` string, date-time, required: Profile last update timestamp
  - `persisted_domains` string[]

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-13** `628c9c73f1e3`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/notte/apis/notte-api/changes/sessions/:session_id/profile/save/post.md)

---

[API](https://skmtc.dev/notte/apis/notte-api.md) - [All operations](https://skmtc.dev/notte/apis/notte-api/llms.txt) - [OpenAPI document](https://skmtc.dev/notte/apis/notte-api/revisions/d56fcbf39bc9?raw)