Skip to content
DocumentationAPI ReferenceChangelog
API ReferenceTalon Studio v1.0.2-beta

Standards

List a workspace's detection standards.

List standards

GET/api/v1/standardsstandards:read

List the detection standards defined in a workspace, newest first. A standard is a Forge blueprint with a conformance spec that detections are graded against.

Query parameters
workspaceIdstring (UUID)
Required with an org-scoped token; a workspace-bound token uses its own workspace.
Response
idstring (UUID)
namestring
descriptionstring · nullable
enforcementstring
warn | block — warn is non-blocking (the default); block makes a non-conforming detection a hard blocker in the change-request gate.
isActiveStandardboolean
This standard is the workspace's active override.
isOrgDefaultboolean
This standard is the org-wide default.
createdAtstring (ISO 8601)
Returned as { data: [...] }. Deleted standards are left out.
Which standard applies
The standard in force for a workspace is its active override (isActiveStandard) if it has one; otherwise the org default (isOrgDefault); otherwise none.
Request
curl -H "Authorization: Bearer tlk_…" \
  "https://<your-instance>/api/v1/standards?workspaceId=…"
Response
{
  "data": [
    {
      "id": "9f8e7d6c-5b4a-4392-8170-6e5d4c3b2a19",
      "name": "Baseline detection quality",
      "description": "Required fields and MITRE mapping for all detections.",
      "enforcement": "block",
      "isActiveStandard": true,
      "isOrgDefault": false,
      "createdAt": "2026-05-12T09:03:44.000Z"
    },
    {
      "id": "2c3d4e5f-6a7b-4c8d-9e0f-1a2b3c4d5e6f",
      "name": "Org baseline",
      "description": "Default standard applied when a workspace has no override.",
      "enforcement": "warn",
      "isActiveStandard": false,
      "isOrgDefault": true,
      "createdAt": "2026-04-01T10:00:00.000Z"
    }
  ]
}