USusenotra
GEO

Run a GEO persona now

Changed on

Plays the persona's conversation now and uses AI credits at twice the rate of a single prompt check. API-based answer engines run synchronously, so the request can stay open for several minutes; checks, mentions and engines report their result. Tracked consumer apps are queued as a background scan named by queuedScanId; poll GET /v1/projects/{projectId}/geo/scans/{scanId} for that part. Use a client timeout of at least five minutes. After four minutes the API answers 409 while the run finishes on its own; do not retry, read GET …/personas/{personaId}/results instead.

post/v1/projects/{projectId}/geo/personas/{personaId}/run

Request

Path parameters

projectIdstring required
Example:b1f2c3d4-0000-4000-8000-000000000000
personaIdstring required

Response

API-based engines finished; a queued consumer-app scan is named by queuedScanId

checksinteger required

Answers recorded during this request by the API-based engines that responded.

mentionsinteger required
enginesstring[] required
queuedScanIdstring nullable

Scan that plays the persona in the tracked consumer apps in the background, or null. Poll GET /v1/projects/{projectId}/geo/scans/{scanId}.

queuedEnginesstring[]

Changes