Skip to main content
cURL

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your workspace API key. See Find your API key for more information.

Path Parameters

workspaceId
string<uuid>
required

The workspace id.

Query Parameters

page
integer
default:1

The page to return in a paginated query.

Required range: x >= 1
perPage
integer
default:25

Maximum number of items to return per page.

Required range: 1 <= x <= 100
searchQuery
string

Filter by a free-text search over names and descriptions.

projectId
string<uuid>

Only include items that apply to this project.

asc
boolean
default:true

Whether to sort in ascending order.

includeRuleStats
boolean
default:false

Whether to include a ruleStats object on each framework, with its rule result status counts and its per-project completion buckets. Computed over the returned page only.

enabled
boolean

Only include frameworks that are enabled (or disabled).

tags
string[]

Only include frameworks carrying all of these tags.

sortColumn
enum<string>

The column to sort on.

Available options:
name,
enabled,
dateCreated,
dateUpdated,
overallCompletion,
projectCompletionBuckets
completionOperator
enum<string>

How to compare each framework's completion percentage with completionValue. Must be sent together with completionValue.

Available options:
is,
>,
>=,
<,
<=,
!=
completionValue
integer

The completion percentage to compare against, from 0 to 100.

Required range: 0 <= x <= 100

Response

Status OK.

items
object[]
required