---
title: "Reauthenticate Identity"
method: POST
path: "/v1/identities/{identityId}/reauthenticate"
tags: ["Identities"]
---

# Reauthenticate Identity

`POST /v1/identities/{identityId}/reauthenticate`

## Request

- Base URL: `https://api.anchorbrowser.io`
- URL: `https://api.anchorbrowser.io/v1/identities/{identityId}/reauthenticate`
- Auth: API key in header `anchor-api-key`

Re-authenticates an identity on demand: validates the saved browser profile and runs login if
it is no longer signed in, then persists the refreshed profile and tears the temporary session
down. Equivalent to a session with `identity_skip_validation: false` that ends after auth.

## Path parameters

- `identityId` string, uuid, required

## Request body

- ReauthenticateIdentityRequest
  - `sync` boolean: When `true` (default), wait for authentication to finish and persist the refreshed profile before returning. When `false`, start authentication asynchronously.

## Response `200`

Identity reauthentication started or completed

- ReauthenticateIdentityResponse
  - `identityId` string, required: The identity that was reauthenticated
  - `async` boolean, required: Whether authentication is still running in the background
  - `sessionId` string, required: Browser session that ran the reauthentication; its recording shows what happened
  - `auth_status` 'authenticated' | 'pending', required: authenticated: the identity is signed in again; pending: an async run is still in progress
  - `method` 'profile' | 'task' | 'mixed': How the identity got authenticated: profile = stored profile was still signed in, task = agentic authentication task, mixed = both. Absent while pending.

## Other responses

- `401`: Missing API key for team
- `404`: Identity not found
- `412`: Identity has no credentials to authenticate with
- `422`: Identity authentication failed
- `500`: Failed to reauthenticate identity

## Changes

- **2026-10-16** `b3bfdb98c79e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/anchorbrowser/apis/anchorbrowser-api/changes/v1/identities/:identityId/reauthenticate/post.md)

---

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