Skip to navigation
aVenture APIAgents and SystemResearch Runs

List Your Research Runs

View as Markdown

Read only your own research runs, newest first, optionally filtered by entitySlug. Each row is the run’s status and target; read one run with getResearchRun. Continue with X-Next-Cursor; a cursor ignores page. Reading existing runs uses no research allowance.

Authentication

AuthorizationBearer

Your aVenture API key (https://aventure.vc/settings/api-keys) or OAuth access token

Query parameters

entitySlugstringOptional

Entity slug the run targets; omit for all your runs.

taskPresetKeylist of stringsOptional

Research presets to include (listResearchRunPresets keys); omit for all.

pageintegerOptionalDefaults to 0

Zero-based page index (0..N)

sizeintegerOptionalDefaults to 50

Runs per page; maximum 200.

cursorstringOptional

Opaque URL-safe cursor token from X-Next-Cursor. Reuse the same filters and sort.

Response headers

X-Next-CursorstringOptional
Continuation token when more runs remain
X-RateLimit-Limitinteger

Requests allowed per client IP in the current rate-limit window.

X-RateLimit-Remaininginteger

Requests left before the tightest applicable rate-limit bucket rejects.

X-RateLimit-Resetinteger

Seconds until the exhausted rate-limit bucket admits another request; 0 when none is exhausted.

Response

OK
contentlist of objectsOptional
emptybooleanOptional
firstbooleanOptional
lastbooleanOptional
numberintegerOptional
numberOfElementsintegerOptional
pageableobjectOptional
sizeintegerOptional
sortobjectOptional
totalElementslongOptional
totalPagesintegerOptional

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
406
Not Acceptable Error
422
Unprocessable Entity Error
429
Too Many Requests Error
500
Internal Server Error
503
Service Unavailable Error