Deprecated: List Your Research Runs

Deprecated

GET

https://api.aventure.vc/v1/research-runs

GET

/v1/research-runs

curl https://api.aventure.vc/v1/research-runs \
     -H "Authorization: Bearer <token>"

{
  "content": [
    {
      "attempt": 1,
      "chassis": "claude-agent-sdk",
      "chassisRouted": true,
      "createdAt": "2024-01-15T09:30:00Z",
      "environment": "unassigned",
      "hasSourceDocument": true,
      "id": "string",
      "iteration": 1,
      "lane": "interactive",
      "llmApi": "anthropic",
      "maxIteration": 1,
      "maxScoutConcurrent": 1,
      "mode": "COMPREHENSIVE",
      "model": "string",
      "status": "queued",
      "subagentModel": "string",
      "type": "ENRICHMENT",
      "updatedAt": "2024-01-15T09:30:00Z",
      "url": "string",
      "entitySlug": "string",
      "error": "string",
      "failureClass": "string",
      "finishedAt": "2024-01-15T09:30:00Z",
      "followUpAdmission": "UNTRACKED",
      "latestStatus": "string",
      "nextAttemptAt": "2024-01-15T09:30:00Z",
      "researchAllowanceType": "string",
      "resumeSafeUntil": "2024-01-15T09:30:00Z",
      "startedAt": "2024-01-15T09:30:00Z",
      "taskPresetKey": [
        "string"
      ],
      "userPrompt": "string"
    }
  ],
  "empty": true,
  "first": true,
  "last": true,
  "number": 1,
  "numberOfElements": 1,
  "pageable": {
    "offset": 1,
    "pageNumber": 1,
    "pageSize": 1,
    "paged": true,
    "sort": {
      "empty": true,
      "sorted": true,
      "unsorted": true
    },
    "unpaged": true
  },
  "size": 1,
  "sort": {
    "empty": true,
    "sorted": true,
    "unsorted": true
  },
  "totalElements": 1,
  "totalPages": 1
}

Deprecated: use research runs list (GET /v1/research/runs).

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-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

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