---
title: "POST Impersonate a user or workspace"
description: "Finds a user by email, slug, domain, or Stripe customer ID and returns impersonation credentials and URLs."
last_updated: "2026-10-05T05:08:24.425832+00:00"
canonical_url: "https://www.doc0.dev/docs/934e554a-e6a1-476f-bb2f-23e62d86c3fd/api/admin/adminimpersonateuser"
---

<APIEndpoint
  method={"POST"}
  path={"/api/admin/impersonate"}
  summary={"Impersonate a user or workspace"}
  description={"Finds a user by email, slug, domain, or Stripe customer ID and returns impersonation credentials and URLs."}
  deprecated={false}
  baseUrl={""}
/>

## Request Body

Identifier to search for user, workspace, domain, or Stripe customer ID

<APIRequestBody
  contentType={"application/json"}
  required={true}
  schema={{"type":"object"}}
/>

## Responses

<APIResponse
  statusCode={"200"}
  description={"Impersonation data retrieved successfully"}
  contentType={"application/json"}
  schema={{"type":"object"}}
/>

<APIResponse
  statusCode={"400"}
  description={"Invalid query or parameters"}
  contentType={"text/plain"}
/>

<APIResponse
  statusCode={"404"}
  description={"User or workspace not found"}
  contentType={"text/plain"}
/>

## Try It

<APIPlayground
  method={"POST"}
  path={"/api/admin/impersonate"}
  parameters={[]}
  requestBody={{"contentType":"application/json","required":true,"description":"Identifier to search for user, workspace, domain, or Stripe customer ID","schema":{"type":"object"}}}
  baseUrl={""}
/>


## Sitemap

See the full [sitemap](https://www.doc0.dev/docs/934e554a-e6a1-476f-bb2f-23e62d86c3fd/llms.txt) for all pages in this wiki.