List eval case proposals | Runtype Documentation

{
  "count": 1,
  "limit": 50,
  "offset": 0,
  "proposals": [
    {
      "acceptedCaseId": null,
      "createdAt": "2024-06-10T12:45:00Z",
      "id": "a1b2c3d4-e5f6-7890-ab12-cd34ef567890",
      "rationale": "Generated to cover basic authentication flow based on API definition.",
      "resolvedAt": null,
      "resolvedBy": null,
      "source": "definition",
      "sourceRefs": {
        "category": "authentication",
        "toolName": "definition-seeded-generator",
        "executionId": "exec-20240610-1234",
        "feedbackId": null
      },
      "status": "proposed",
      "suggestedGraders": [],
      "suiteId": "suite-9876abcd-1234-ef56-7890-abcdef123456",
      "proposedCase": {
        "name": "User login with valid credentials",
        "input": {
          "username": "testuser",
          "password": "correcthorsebatterystaple"
        },
        "expected": {
          "status": "success",
          "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9"
        },
        "notes": "Test case generated from definition-seeded generation to cover login functionality."
      }
    }
  ],
  "total": 1
}

List a suite’s machine-proposed cases (the review queue). Every generation source — definition-seeded generation, coverage gaps, trace mining, feedback — lands here; nothing enters the suite without an accept.

Authentication

AuthorizationBearer

API key or Clerk session token

Path parameters

idstringRequired>=1 character

Query parameters

statusenumOptional

Filter by status. Omit for all; the queue UI uses “proposed”.

Allowed values:

limitstringOptional

Number of results (default 50, max 100)

offsetstringOptional

Pagination offset

Response

Proposals returned

countinteger

Proposals in this page.

limitinteger

offsetinteger

proposalslist of objects

totalinteger

Total proposals matching the filter.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error

$	curl https://api.runtype.com/v1/eval/suites/id/proposals \
>	-H "Authorization: <apiKey>" \
>	-H "Content-Type: application/json"