Get Test Design Result (v1)

Method & Path

GET /api/v1/workspace/:workspaceId/labs/tests/:testId/design-result

Actual backend path: /v1/workspace/:workspaceId/labs/tests/:testId/design-result

Description

Get the test design result for a given test ID.

If you pass fetchFromExternal=true and there is no local design result, the backend will attempt to fetch it from an external source and store it.

Authentication

Required: JWT token in Authorization header

Persona Access:

• Workspace Owner: Allowed
• Staff: Allowed (role-based)

Required Permissions:

• labs.manage

Headers

Header	Type	Required	Description
Authorization	string	Yes	Bearer token: Bearer <token>

Path Parameters

Parameter	Type	Required	Description
workspaceId	string	Yes	Workspace identifier (MongoDB ObjectId)
testId	number	Yes	Numeric test ID

Query Parameters

Parameter	Type	Required	Description
fetchFromExternal	boolean	No	When true, attempts external fetch if not found locally (default: false)

Response 200 OK

{
  "designResult": {
    "id": "507f1f77bcf86cd799439050",
    "workspaceId": "507f1f77bcf86cd799439012",
    "testId": 101,
    "sections": [],
    "commentRules": [],
    "calculationsRules": [],
    "deletedAt": null,
    "createdAt": "2026-01-10T12:00:00.000Z",
    "updatedAt": "2026-01-10T12:00:00.000Z"
  }
}

Common Errors

401 Unauthorized: Missing or invalid authentication token

403 Forbidden: Insufficient permissions (labs.manage required)

404 Not Found: Workspace not found, or design result not found

422 Validation Error: Invalid workspace ID or invalid test ID