---
title: "POST /experimental/skill-inventories"
method: POST
path: "/experimental/skill-inventories"
tags: ["SkillInventory"]
---

# POST /experimental/skill-inventories

`POST /experimental/skill-inventories`

Upload of a skill inventory scan from the CLI.

## Headers

- `Authorization` string

## Request body

- object
  - `version` string, required
  - `workspaceId` string, uuid, required
  - `org` string, required
  - `scannedAt` string, date-time, required
  - `cliVersion` string
  - `stats` object
    - `reposScanned` number
    - `apiCalls` number
  - `repos` object[], required
    - `name` string, required
    - `fullName` string, required
    - `url` string, required
    - `description` string, nullable
    - `topics` string[], required
    - `visibility` union, required
      - 'public'
      - 'private'
      - 'internal'
    - `language` string, nullable
    - `defaultBranch` string, required
    - `pushedAt` string, nullable
    - `updatedAt` string, nullable
    - `skills` union[], required
      - union
        - object
          - `path` string, required
          - `body` string, required
          - `agents` string[]
          - `lastModified` unknown
        - object
          - `path` string, required
          - `name` string, required
          - `depSource` string, nullable
          - `version` string, nullable
          - `agents` string[]
    - `manifests` object[]
      - `path` string, required
      - `type` union, required
        - 'skills-lock'
        - 'tessl-deps'
        - 'tile'
        - 'tessl-plugin'
        - 'claude-plugin'
        - 'claude-marketplace'
        - 'claude-settings'
        - 'unknown'
      - `content` unknown
    - `truncated` boolean

## Response `201`

Default Response

- object
  - `inventoryId` string, uuid, required
  - `scanIndex` number, required
  - `kind` union, required
    - 'first-scan-authed'
    - 're-scan'

## 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)