QAVE Studio Docs
QAVE Studio Docs
Sign inGet started — the Studio loop
Getting StartedFirst assurance runQuick assure
ConceptsLifecycleGlossaryHow QAVE Studio worksComing soon
Account & workspaceSignup and loginPeopleDemo creditsRolesSettings
Generate simulation suitesContext templatePII and field enhanceDimensionsAgents and plannerDraft review and Save
ExportExport formatsExport formats (detail)
Assurance SDKSDK overviewQAVE Studio suite fetch APIAgent and JSONL queueLangfuse bridge
Execute and tracesRecipe chatbot (reference SUT)TracingFetch tracing
AssureEvaluate APIRubrics and evidenceReading scores
History
WorkbenchGolden data
CoverageCoverage dashboardCoverage strategiesCoverage advisorTest case quality
RAG AssuranceRAG runsRAG datasetsRAG analytics
Project evalsError analysisUnderstanding scores
Studio guidesDimensionsTuplesConversation modesMulti-lingual testingWorkflowsHuman reviewBest practices
ReferenceAPI and packagesTroubleshooting
Assurance SDK

QAVE Studio suite fetch API

Project SDK keys and paginated /sdk routes for listing approved suites and cases.

External Assurance SDK runners fetch approved suites and cases from QAVE Studio. Create a project SDK API key in Studio Settings → Project SDK API keys (shown once). The same page shows the project ID with a copy control — you need both the key and the project ID for /sdk paths.

Auth

Authorization: Bearer qave_sdk_...

The key is scoped to one project. The project_id in the path must match the key or the API returns 403.

List approved suites

GET /sdk/projects/{project_id}/test-suites?page=1&page_size=50

Default page_size is 50; max is 200.

{
  "items": [
    {
      "id": "…",
      "name": "Checkout happy path",
      "description": null,
      "status": "APPROVED",
      "metadata": {},
      "created_at": "…",
      "updated_at": "…"
    }
  ],
  "page": 1,
  "page_size": 50,
  "total": 1
}

Only APPROVED suites are returned.

Fetch approved cases

GET /sdk/projects/{project_id}/test-suites/{suite_id}/cases?page=1&page_size=50

Default page_size is 50; max is 100. Unknown or non-approved suites return 404. Only APPROVED cases are included. Loop page until you have total rows.

Each case is the full stored record (id, conversation_history, criteria, title, intent, dimension_snapshot, …). Map conversation_history to messages in the runner if needed.

Studio key APIs (JWT)

MethodPath
GET/projects/{project_id}/sdk-keys
POST/projects/{project_id}/sdk-keys { "name": "optional" }
DELETE/projects/{project_id}/sdk-keys/{key_id}

POST returns api_key once. Revoke immediately disables /sdk access.

SDK overview

Packages, responsibilities, and the honest boundary between eval-only and SUT drive.

Agent and JSONL queue

Poll inputs.jsonl, call MCP evaluate_conversation, and record traces.

On this page

AuthList approved suitesFetch approved casesStudio key APIs (JWT)