Standards

import { Aside } from ‘@astrojs/starlight/components’;

List standards

GET /v1/organizations/:orgId/standards

Required role: Member.

Returns all standards visible to the organization: global built-in standards plus any custom standards the organization has created.

Response:

{
  "standards": [
    {
      "id": "...",
      "name": "WCAG 2.2",
      "slug": "wcag-2-2",
      "description": "...",
      "source": "built_in",
      "editable": false,
      "organizationId": null,
      "cumulative": true,
      "levels": [
        { "id": "a", "name": "Level A", "sortOrder": 0 },
        { "id": "aa", "name": "Level AA", "sortOrder": 1 },
        { "id": "aaa", "name": "Level AAA", "sortOrder": 2 }
      ],
      "createdAt": "...",
      "updatedAt": "..."
    }
  ]
}

Create a custom standard

POST /v1/organizations/:orgId/standards

Required role: Admin or owner.

Request body:

Field	Type	Required	Description
`name`	`string`	Yes	Standard name.
`description`	`string \| null`	No	Optional description.
`levels`	`array`	No	Ordered conformance levels. Each item: `{ name: string, description?: string }`.
`cumulative`	`boolean`	No	Whether meeting a higher level implies all lower levels (default: `false`).

Returns 201 Created.

Update a custom standard

PATCH /v1/organizations/:orgId/standards/:standardSlug

Required role: Admin or owner. Built-in standards cannot be updated.

Request body (all fields optional):

Field	Type	Description
`name`	`string`
`description`	`string \| null`
`levels`	`array`	Replaces the full set of levels. Removing a level that is referenced by products, organizations, or audits clears those references.
`cumulative`	`boolean`

Delete a custom standard

DELETE /v1/organizations/:orgId/standards/:standardSlug

Required role: Admin or owner. Built-in standards cannot be deleted.

Clears any references to this standard on organizations, products, and audits. Returns 204 No Content.

Duplicate a standard

POST /v1/organizations/:orgId/standards/:standardSlug/duplicate

Required role: Admin or owner.

Creates an editable custom copy of any standard, including built-in ones. The copy includes all requirement groups and requirements. Returns 201 Created.

List requirements

GET /v1/organizations/:orgId/standards/:standardSlug/requirements

Required role: Member.

Query parameters:

Parameter	Type	Description
`version`	`string`	Filter by version tag.
`level`	`string`	Filter by conformance level ID.