Create impersonation session request
POST/tenants/:tenant_id/impersonations
Creates a new admin impersonation session request for a tenant, targeting a specific user account. Requires admin password re-confirmation (current_password), a support ticket reference, and a stated reason. Scope determines the access level granted. Depending on platform configuration, the session may require a second admin to approve before a start_url is issued.
Request
Responses
- 201
- 401
- 404
- 422
Impersonation session created. If auto-approval is configured, the response includes an impersonation_start_url. Otherwise, a second admin must approve via the /approve endpoint.
current_password is incorrect.
Tenant or target_user_id not found.
Validation failed — check scope enum, ticket_ref, or reason length.