Skip to main content
POST
Run a GEO prompt sequence now

Authorizations

Authorization
string
header
required

Send your API key in the Authorization header as Bearer API_KEY. Account API keys work in every workspace you belong to: send X-Notra-Organization-Id with the workspace id or slug to choose one. Workspace endpoints require it when you belong to more than one workspace; GET /v1/me/workspaces works without it. Organization keys only accept their own workspace there.

Path Parameters

projectId
string
required
Minimum string length: 1
Pattern: ^[A-Za-z0-9_-]{1,100}$
Example:

"b1f2c3d4-0000-4000-8000-000000000000"

sequenceId
string
required
Minimum string length: 1
Pattern: ^[A-Za-z0-9_-]{1,100}$

Response

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

checks
integer
required

Answers recorded during this request by the API-based engines that responded. Consumer-app answers from the queued scan are not counted.

mentions
integer
required

How many of those answers mentioned the tracked brand.

engines
string[]
required

Every API-based engine the conversation was played against during this request, once at least one of them answered, including engines that failed. Empty when only consumer apps run or none of the API engines answered.

organization
object
required
queuedScanId
string | null

Scan that plays the conversation in the tracked consumer apps (ChatGPT, Perplexity, Gemini, AI Mode, Copilot) in the background, or null when none was queued. Poll GET /v1/projects/{projectId}/geo/scans/{scanId} until status leaves running; its answers then land in the project's GEO checks.

queuedEngines
string[]

Consumer-app engines covered by queuedScanId. Empty when nothing was queued.