GEO

Run a GEO prompt sequence now

Runs the sequence synchronously and answers with its result. The call is not queued: the request stays open for the whole run, which plays every turn against every available answer engine and can take several minutes. Use a client timeout of at least five minutes; after four minutes the API stops waiting and answers 409 while the run finishes on its own. Do not retry; read the result from the project's GEO checks. The work happens inside the Notra dashboard, which owns the model credentials and billing gates; the public API never calls an answer engine itself. Results also land in the project's GEO checks.

post/v1/projects/{projectId}/geo/sequences/{sequenceId}/run

Path parameters

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

Response

Sequence run completed

checksinteger required

Recorded answers across every engine that responded.

mentionsinteger required

How many of those answers mentioned the tracked brand.

enginesstring[] required

Engines the conversation was played against.

Changes

Changed in 1 of the 8 revisions of this API.1