---
title: "GET /v1/workspaces/{workspaceNameOrID}/skill-inventories/{id}/by-skill"
method: GET
path: "/v1/workspaces/{workspaceNameOrID}/skill-inventories/{id}/by-skill"
tags: ["SkillInventory"]
---

# GET /v1/workspaces/{workspaceNameOrID}/skill-inventories/{id}/by-skill

`GET /v1/workspaces/{workspaceNameOrID}/skill-inventories/{id}/by-skill`

By-skill lens — paginated version-blind GlobalSkillId groups with their SkillInstances and the manifests that reference them.

## Path parameters

- `workspaceNameOrID` string, required
- `id` string, uuid, required

## Query parameters

- `sort` union
  - union[]
    - union
      - 'canonicalName'
      - '-canonicalName'
      - 'canonicalRepo'
      - '-canonicalRepo'
  - 'canonicalName'
  - '-canonicalName'
  - 'canonicalRepo'
  - '-canonicalRepo'
- `page[size]` number
- `page[after]` string
- `page[before]` string
- `page[number]` integer
- `q` string
- `type` union
  - 'first-party'
  - 'third-party'
  - 'unknown'
  - union[]
    - union
      - 'first-party'
      - 'third-party'
      - 'unknown'
- `security` union
  - 'none'
  - 'pending'
  - 'failed'
  - 'passed'
  - 'critical'
  - union[]
    - union
      - 'none'
      - 'pending'
      - 'failed'
      - 'passed'
      - 'critical'
- `severity` union
  - 'critical'
  - 'high'
  - 'medium'
  - 'low'
  - 'clean'
  - union[]
    - union
      - 'critical'
      - 'high'
      - 'medium'
      - 'low'
      - 'clean'
- `repo` union
  - string
  - string[]

## Headers

- `Authorization` string

## Response `200`

Default Response

- object
  - `links` object, required
    - `self` string, uri, required
    - `next` string, uri, nullable, required
    - `prev` string, uri, nullable, required
  - `meta` object, required
    - `count` number, required
  - `data` object[], required
    - `id` string, uuid, required
    - `type` 'skill-inventory-skill-group', required
    - `attributes` object, required
      - `scm` string, required
      - `canonicalRepo` string, required
      - `canonicalName` string, required
      - `description` string, nullable, required
      - `category` union, required
        - 'first-party'
        - 'third-party'
        - 'unknown'
      - `instanceCount` number, required
      - `repoCount` number, required
      - `skillInstances` object[], required
        - `id` string, uuid, required
        - `repoId` string, uuid, required
        - `repoFullName` string, required
        - `kind` union, required
          - 'source'
          - 'dependency'
        - `path` string, required
        - `name` string, required
        - `scm` string, required
        - `canonicalRepo` string, required
        - `canonicalName` string, required
        - `version` string, nullable, required
      - `manifests` object[], required
        - `id` string, uuid, required
        - `repoId` string, uuid, required
        - `repoFullName` string, required
        - `path` string, required
        - `type` union, required
          - 'skills-lock'
          - 'tessl-deps'
          - 'tile'
          - 'tessl-plugin'
          - 'claude-plugin'
          - 'claude-marketplace'
          - 'claude-settings'
          - 'unknown'
      - `findingsCount` number, required
      - `worstPriority` union, required
        - 'critical'
        - 'high'
        - 'medium'
        - 'low'
      - `registryScores` object, nullable, required
        - `version` string, required
        - `aggregate` number, nullable, required
        - `quality` number, nullable, required
        - `impact` number, nullable, required
        - `security` union, required — Deprecated legacy Snyk overall grade. Use `securityLevel` instead.
          - 'LOW'
          - 'MEDIUM'
          - 'HIGH'
          - 'CRITICAL'
        - `securityLevel` union, required
          - 'NONE'
          - 'LOW'
          - 'MEDIUM'
          - 'HIGH'
          - 'CRITICAL'
        - `evalAvg` number, nullable, required
        - `evalBaseline` number, nullable, required
        - `evalImprovement` number, nullable, required
        - `evalImprovementMultiplier` number, nullable, required
        - `evalCount` integer, nullable, required
        - `validationErrors` string[], required
        - `lastScoredAt` string, nullable, required
      - `registryTesslUrl` string, nullable, required
      - `firstSeenAt` string, nullable, required
      - `licence` string, nullable, required
      - `tags` string[], required
      - `committers` object, required
        - `total` number, required
        - `items` object[], required
          - `username` string, required
          - `avatarUrl` string, nullable, required
      - `securityReview` object, nullable, required
        - `status` union, required
          - 'pending'
          - 'completed'
          - 'failed'
        - `riskLevel` union, required — Deprecated legacy Snyk overall risk level. Use `securityLevel` instead.
          - 'LOW'
          - 'MEDIUM'
          - 'HIGH'
          - 'CRITICAL'
        - `securityLevel` union, required
          - 'NONE'
          - 'LOW'
          - 'MEDIUM'
          - 'HIGH'
          - 'CRITICAL'

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `500` — Internal Server Error

---

[API](https://skmtc.net/tessl/apis/tessl-api.md) · [All operations](https://skmtc.net/tessl/apis/tessl-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tessl/tessl-api/versions/fbb186825642/schema)