REST API Documentation

curl -H "Authorization: Bearer qg_your_token_here" \
  https://qualitygraph.harnessqa.dev/api/tms/journeys?orgId=YOUR_ORG_ID

# GitHub Actions example
env:
  QG_TOKEN: ${{ secrets.QUALITYGRAPH_TOKEN }}

steps:
  - name: Create user journey
    run: |
      curl -X POST "https://qualitygraph.harnessqa.dev/api/tms/journeys" \
        -H "Authorization: Bearer $QG_TOKEN" \
        -H "Content-Type: application/json" \
        -d '{"orgId":"YOUR_ORG_ID","title":"Checkout Flow","steps":[]}'

{
  "data": { ... },
  "meta": {
    "timestamp": "2026-09-05T12:00:00.000Z"
  }
}

# A folder inside another, then a journey filed into it
curl -X POST "https://qualitygraph.harnessqa.dev/api/tms/journey-folders" \
  -H "Authorization: Bearer $QG_TOKEN" -H "Content-Type: application/json" \
  -d '{ "orgId": "YOUR_ORG_ID", "title": "Checkout", "parentId": "SHOPPING_FOLDER_ID" }'

curl -X PATCH "https://qualitygraph.harnessqa.dev/api/tms/journeys/JOURNEY_ID" \
  -H "Authorization: Bearer $QG_TOKEN" -H "Content-Type: application/json" \
  -d '{ "folderId": "CHECKOUT_FOLDER_ID" }'

# Everything under Shopping, subfolders included
curl -H "Authorization: Bearer $QG_TOKEN" \
  "https://qualitygraph.harnessqa.dev/api/tms/journeys?orgId=YOUR_ORG_ID&folderId=SHOPPING_FOLDER_ID&includeSubfolders=true"

curl -H "Authorization: Bearer $QG_TOKEN" \
  "https://qualitygraph.harnessqa.dev/api/tms/journeys?orgId=YOUR_ORG_ID"

curl -X POST "https://qualitygraph.harnessqa.dev/api/tms/journeys" \
  -H "Authorization: Bearer $QG_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "orgId": "YOUR_ORG_ID",
    "title": "User Checkout Flow",
    "description": "Complete purchase flow from cart to confirmation",
    "priority": "HIGH",
    "status": "ACTIVE",
    "tags": ["checkout", "payment", "critical"],
    "steps": [
      {"order": 1, "action": "Add item to cart", "expectedOutcome": "Item appears in cart with correct price"},
      {"order": 2, "action": "Proceed to checkout", "expectedOutcome": "Checkout form displays with cart summary"},
      {"order": 3, "action": "Enter payment details", "expectedOutcome": "Payment form validates input"},
      {"order": 4, "action": "Submit order", "expectedOutcome": "Order confirmation page with order ID"}
    ]
  }'

{
  "data": {
    "id": "a1b2c3d4-...",
    "title": "User Checkout Flow",
    "description": "Complete purchase flow from cart to confirmation",
    "priority": "HIGH",
    "status": "ACTIVE",
    "tags": ["checkout", "payment", "critical"],
    "steps": [
      {"order": 1, "action": "Add item to cart", "expectedOutcome": "Item appears in cart with correct price"},
      {"order": 2, "action": "Proceed to checkout", "expectedOutcome": "Checkout form displays with cart summary"},
      {"order": 3, "action": "Enter payment details", "expectedOutcome": "Payment form validates input"},
      {"order": 4, "action": "Submit order", "expectedOutcome": "Order confirmation page with order ID"}
    ],
    "orgId": "YOUR_ORG_ID",
    "createdAt": "2026-09-05T12:00:00.000Z",
    "updatedAt": "2026-09-05T12:00:00.000Z"
  }
}

curl -X PATCH "https://qualitygraph.harnessqa.dev/api/tms/journeys/JOURNEY_ID" \
  -H "Authorization: Bearer $QG_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"priority": "CRITICAL", "status": "ACTIVE"}'

curl -X POST "https://qualitygraph.harnessqa.dev/api/tms/journeys/JOURNEY_ID/cases" \
  -H "Authorization: Bearer $QG_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"testCaseIds": ["case-id-1", "case-id-2"]}'

# JSON export of one folder and everything under it
curl -o journeys.json -H "Authorization: Bearer $QG_TOKEN" \
  "https://qualitygraph.harnessqa.dev/api/tms/journeys/export?orgId=YOUR_ORG_ID&folderId=SHOPPING_FOLDER_ID&includeSubfolders=true"

# CSV export: Folder,Title,Description,Steps,Priority,Status,Tags,Test Cases
curl -o journeys.csv -H "Authorization: Bearer $QG_TOKEN" \
  "https://qualitygraph.harnessqa.dev/api/tms/journeys/export?orgId=YOUR_ORG_ID&format=csv"

# Import under a folder; the file contents travel in the JSON body
curl -X POST "https://qualitygraph.harnessqa.dev/api/tms/journeys/import" \
  -H "Authorization: Bearer $QG_TOKEN" \
  -H "Content-Type: application/json" \
  -d "$(jq -n --arg c "$(cat journeys.csv)" '{orgId: "YOUR_ORG_ID", content: $c, targetFolderId: "IMPORTED_FOLDER_ID", onDuplicate: "skip"}')"

# → { "format": "csv", "total": 12, "created": 10, "updated": 0, "skipped": 2, "foldersCreated": 3, "linked": 7, "errors": [], "warnings": [] }

curl -X POST "https://qualitygraph.harnessqa.dev/api/tms/suites" \
  -H "Authorization: Bearer $QG_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "orgId": "YOUR_ORG_ID",
    "title": "Authentication Tests",
    "description": "All test cases related to user authentication"
  }'

# Export the cases you can see in a folder, as a spreadsheet
curl -o cases.csv -H "Authorization: Bearer $QG_TOKEN" \
  "https://qualitygraph.harnessqa.dev/api/tms/cases/export?orgId=YOUR_ORG_ID&format=csv&folderId=SUITE_ID&includeSubfolders=true"

# Preview an import without writing anything
curl -X POST "https://qualitygraph.harnessqa.dev/api/tms/cases/import" \
  -H "Authorization: Bearer $QG_TOKEN" \
  -H "Content-Type: application/json" \
  -d "$(jq -n --arg c "$(cat cases.csv)" '{orgId: "YOUR_ORG_ID", content: $c, dryRun: true}')"

# Then import for real, updating cases that already exist
curl -X POST "https://qualitygraph.harnessqa.dev/api/tms/cases/import" \
  -H "Authorization: Bearer $QG_TOKEN" \
  -H "Content-Type: application/json" \
  -d "$(jq -n --arg c "$(cat cases.csv)" '{orgId: "YOUR_ORG_ID", content: $c, onDuplicate: "update"}')"

# → { "format": "csv", "total": 40, "created": 35, "updated": 5, "skipped": 0, "foldersCreated": 4, "linked": 12,
#     "errors": [{ "row": 17, "message": "Name is required" }], "warnings": [] }

curl -X POST "https://qualitygraph.harnessqa.dev/api/tms/cases" \
  -H "Authorization: Bearer $QG_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "orgId": "YOUR_ORG_ID",
    "name": "Login with valid credentials",
    "description": "Verify user can login with correct email and password",
    "priority": "HIGH",
    "caseType": "MANUAL",
    "suiteId": "SUITE_ID",
    "journeyId": "JOURNEY_ID",
    "steps": [
      {"stepNumber": 1, "action": "Navigate to /login", "expected": "Login form displayed"},
      {"stepNumber": 2, "action": "Enter valid email and password", "expected": "Fields populated"},
      {"stepNumber": 3, "action": "Click Sign In", "expected": "Redirected to dashboard"}
    ],
    "tags": ["auth", "login", "smoke"]
  }'

curl -X POST "https://qualitygraph.harnessqa.dev/api/tms/cases/bulk" \
  -H "Authorization: Bearer $QG_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "cases": [
      {"orgId": "YOUR_ORG_ID", "name": "Login success", "priority": "HIGH"},
      {"orgId": "YOUR_ORG_ID", "name": "Login invalid password", "priority": "MEDIUM"},
      {"orgId": "YOUR_ORG_ID", "name": "Login rate limit", "priority": "LOW"}
    ]
  }'

# 1. Create a test run
curl -X POST "https://qualitygraph.harnessqa.dev/api/tms/runs" \
  -H "Authorization: Bearer $QG_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "orgId": "YOUR_ORG_ID",
    "title": "Nightly Regression - 2026-09-05",
    "environment": "staging"
  }'

# Response: {"data": {"id": "RUN_ID", ...}}

# 2. Submit results
curl -X POST "https://qualitygraph.harnessqa.dev/api/tms/runs/RUN_ID/results" \
  -H "Authorization: Bearer $QG_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "results": [
      {"testCaseId": "CASE_1", "status": "PASSED", "duration": 1.2},
      {"testCaseId": "CASE_2", "status": "FAILED", "duration": 3.5, "notes": "Timeout on payment API"},
      {"testCaseId": "CASE_3", "status": "SKIPPED"}
    ]
  }'

# 3. Complete the run
curl -X PATCH "https://qualitygraph.harnessqa.dev/api/tms/runs/RUN_ID" \
  -H "Authorization: Bearer $QG_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"status": "COMPLETED"}'

curl -X POST -H "Authorization: Bearer $QG_TOKEN" -H "Content-Type: application/json" \
  "https://qualitygraph.harnessqa.dev/api/tms/releases" \
  -d '{"orgId":"YOUR_ORG_ID","name":"2026.10","version":"v2026.10.0","notes":"## Checklist\n- [ ] smoke test"}'

curl -H "Authorization: Bearer $QG_TOKEN" \
  "https://qualitygraph.harnessqa.dev/api/organizations"

curl -X POST -H "Authorization: Bearer $QG_TOKEN" -H "Content-Type: application/json" \
  "https://qualitygraph.harnessqa.dev/api/repositories/YOUR_REPO_ID/test-runs/ingest" \
  -d "{\"format\":\"junit\",\"branch\":\"main\",\"data\":$(jq -Rs . < junit.xml)}"

curl -H "Authorization: Bearer $QG_TOKEN" \
  "https://qualitygraph.harnessqa.dev/api/tms/reports/summary?orgId=YOUR_ORG_ID"

{
  "data": {
    "totalCases": 142,
    "totalRuns": 28,
    "overallPassRate": 87.3,
    "avgDurationMinutes": 12.5,
    "casesByPriority": {"LOW": 20, "MEDIUM": 68, "HIGH": 42, "CRITICAL": 12},
    "casesByStatus": {"ACTIVE": 130, "DRAFT": 8, "DEPRECATED": 4},
    "recentRuns": [...],
    "passRateTrend": [...]
  }
}

{
  "statusCode": 401,
  "message": "Invalid or expired API token",
  "error": "Unauthorized"
}