---
title: "GET /experimental/orgs/{orgId}/agent-signals/users/{userId}/skills"
method: GET
path: "/experimental/orgs/{orgId}/agent-signals/users/{userId}/skills"
tags: ["Orgs", "Agent Signals"]
---

# GET /experimental/orgs/{orgId}/agent-signals/users/{userId}/skills

`GET /experimental/orgs/{orgId}/agent-signals/users/{userId}/skills`

## Request

- Base URL: `https://api.tessl.io`
- URL: `https://api.tessl.io/experimental/orgs/{orgId}/agent-signals/users/{userId}/skills`
- Auth: none declared
- TypeScript: <https://skmtc.dev/tessl/apis/tessl-api/docs/experimental/orgs/:orgId/agent-signals/users/:userId/skills/get.ts> (a function with typed inputs; its response is checked against the schema)

Lists skills with the highest activation or read count for one user in an organization. Activation and read counts and distinct sessions are reported separately and are never combined.

## Path parameters

- `orgId` string, uuid, required
- `userId` string, uuid, required

## Query parameters

- `rankBy` union
  - 'skill.activation'
  - 'skill.read'
- `page[size]` number
- `page[number]` integer

## 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, required
    - `type` 'agent-signal-skill-aggregate', required
    - `attributes` object, required
      - `name` string, required
      - `namespace` string, nullable, required
      - `activation` object, required
        - `count` number, required
        - `distinctUsers` number, required
        - `unattributedRows` number, required
        - `interactiveUsers` number, required
        - `automatedRows` number, required
        - `distinctSessions` number, required
      - `read` object, required
        - `count` number, required
        - `distinctUsers` number, required
        - `unattributedRows` number, required
        - `interactiveUsers` number, required
        - `automatedRows` number, required
        - `distinctSessions` number, required

## Other responses

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

## Changes

- **2026-10-29** `06d2142ed144`: 1 info
  - api operation id `listOrgAgentSignalUserSkills` was added
- **2026-10-01** `202970d1e3fb`: 6 info
  - added the required property `data/items/attributes/activation/automatedRows` to the response with the `200` status
  - added the required property `data/items/attributes/activation/interactiveUsers` to the response with the `200` status
  - added the required property `data/items/attributes/activation/unattributedRows` to the response with the `200` status
  - added the required property `data/items/attributes/read/automatedRows` to the response with the `200` status
  - …2 more
- **2026-09-23** `6da83f4191fc`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/tessl/apis/tessl-api/changes/experimental/orgs/:orgId/agent-signals/users/:userId/skills/get.md)

---

[API](https://skmtc.dev/tessl/apis/tessl-api.md) - [All operations](https://skmtc.dev/tessl/apis/tessl-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tessl/apis/tessl-api/revisions/49129f210919?raw)