---
title: "Analyze User Intel"
method: POST
path: "/admin/user-intel/{workspace_id}/analyze"
tags: ["Admin"]
---

# Analyze User Intel

`POST /admin/user-intel/{workspace_id}/analyze`

## Request

- Base URL: `https://api.kolens.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.kolens.ai/admin/user-intel/{workspace_id}/analyze`
- Auth: none declared

Build the dossier, run the LLM, persist + return the report.

On-demand + cached: when a cached report already exists and
``refresh`` is false, it is returned verbatim (``cached=true``)
without another LLM call. ``refresh=true`` always re-runs and
overwrites the cached row.

## Path parameters

- `workspace_id` string, required

## Query parameters

- `refresh` boolean: Force re-analysis even if a cached report exists

## Headers

- `x-admin-secret` string, nullable

## Response `200`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

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