---
title: "Profile State Set"
method: POST
path: "/profiles/{profile_id}/state"
tags: ["profiles"]
---

# Profile State Set

`POST /profiles/{profile_id}/state`

## 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/profiles/{profile_id}/state`
- Auth: OAuth 2
  - Password
  - Token URL: `token`

## Path parameters

- `profile_id` string, required

## Headers

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

## Request body

- ProfileStateImportRequest
  - `cookies` Cookie[]
    - `name` string, required
    - `value` string, required
    - `domain` string, required
    - `path` string, required
    - `httpOnly` boolean, required
    - `expirationDate` number, nullable
    - `hostOnly` boolean, nullable
    - `sameSite` 'Lax' | 'None' | 'Strict', nullable
    - `secure` boolean, nullable
    - `session` boolean, nullable
    - `storeId` string, nullable
    - `expires` number, nullable
    - `partitionKey` string, nullable
  - `local_storage` object
  - `session_storage` object
  - `domains` string[], nullable
  - `mode` 'replace' | 'append'
  - `storage_scope` 'domains' | 'origins': Use origins for partial live-tab snapshots: replace only origins present in each storage map.

## Response `200`

Successful Response

- ProfileStateImportResponse
  - `success` boolean, required
  - `cookies_count` integer, required
  - `local_storage_origins` integer, required
  - `session_storage_origins` integer, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-18** `20f8ac8dc733`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/notte/apis/notte-api/changes/profiles/:profile_id/state/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)