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

# GET /experimental/orgs/{orgId}/agent-signals/skills/{skillId}/expectations

`GET /experimental/orgs/{orgId}/agent-signals/skills/{skillId}/expectations`

## Request

- Base URL: `https://api.tessl.io`
- URL: `https://api.tessl.io/experimental/orgs/{orgId}/agent-signals/skills/{skillId}/expectations`
- Auth: none declared

Returns, for one tracked skill, the turns that needed it and the turns in which it was activated, in total and per week, over a window of whole UTC days. 404 when the skill is not tracked.

## Path parameters

- `orgId` string, uuid, required
- `skillId` string, required

## Query parameters

- `days` integer

## Headers

- `Authorization` string

## Response `200`

Default Response

- object
  - `links` object, required
    - `self` string, uri, required
  - `meta` object, required
    - `window` object, required: The resolved window: whole UTC days, `start` inclusive and `end` exclusive.
      - `days` integer, required
      - `start` string, date-time, required
      - `end` string, date-time, required
  - `data` object, required
    - `id` string, required
    - `type` 'agent-signal-skill-expectation', required
    - `attributes` object, required
      - `namespace` string, nullable, required
      - `canonicalName` string, required
      - `trackedSkillId` string, uuid, required
      - `governedTools` string[], required
      - `enabled` boolean, required
      - `trackedAt` string, date-time, required
      - `turnsNeeded` integer, required: Distinct turns that needed the skill: turns that used a governed tool, and turns the sampled judge found needed it. A turn counts once whichever tier decided it.
      - `turnsActivated` integer, required: Of those turns, the ones in which the skill was activated.
      - `activationRate` number, nullable, required: `turnsActivated / turnsNeeded`; null when no turn needed it.
      - `weekly` object[], required
        - `weekStart` string, date, required: Monday (UTC) of the week. The first and last weeks are clipped to the window.
        - `turnsNeeded` integer, required: Distinct turns that needed the skill: turns that used a governed tool, and turns the sampled judge found needed it. A turn counts once whichever tier decided it.
        - `turnsActivated` integer, required: Of those turns, the ones in which the skill was activated.
        - `activationRate` number, nullable, required: `turnsActivated / turnsNeeded`; null when no turn needed it.

## Other responses

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

## Changes

- **2026-10-29** `06d2142ed144`: 1 info
  - api operation id `listOrgAgentSignalSkillExpectations` was added
- **2026-10-22** `d97810390526`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/tessl/apis/tessl-api/changes/experimental/orgs/:orgId/agent-signals/skills/:skillId/expectations/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/0d008f56f0c1?raw)