How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Stacklok skills API

The skills API from Stacklok — 12 operation(s) for skills.

Stacklok skills API is one of 13 APIs that Stacklok publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Skills. The published artifact set on APIs.io includes an OpenAPI specification.

This API exposes 14 operations across 12 paths, and defines 24 schemas. It is described by OpenAPI 3.2.0, at version 0.1.

14 operations 12 paths 24 schemas 2 DELETE8 GET4 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
0.1
Authentication
API Key
License
Resource Areas
1

Authentication & Security 1

Stacklok skills API declares 1 security scheme for authenticating requests. An API key is passed in the header as Authorization (BearerAuth).

  • BearerAuth — OAuth 2.0 Bearer token authentication. Format: "Bearer {token}"

Paths & Operations 14

Across 12 paths, the API surfaces 14 operations — 2 DELETE, 8 GET, 4 POST. Each is listed below with its method, path, parameters, and response codes.

skills 14
GET
/registry/{registryName}/v0.1/x/dev.toolhive/skills
List skills in registry
5 params → 200400500
GET
/registry/{registryName}/v0.1/x/dev.toolhive/skills/{namespace}/{name}
Get latest skill version
3 params → 200400404500
GET
/registry/{registryName}/v0.1/x/dev.toolhive/skills/{namespace}/{name}/versions
List skill versions
3 params → 200400404500
GET
/registry/{registryName}/v0.1/x/dev.toolhive/skills/{namespace}/{name}/versions/{version}
Get specific skill version
4 params → 200400404500
GET
/api/v1beta/skills
List all installed skills
4 params → 200500
POST
/api/v1beta/skills
Install a skill
body → 201400401404409429500502
DELETE
/api/v1beta/skills/{name}
Uninstall a skill
3 params → 204400404500
GET
/api/v1beta/skills/{name}
Get skill details
3 params → 200400404500
POST
/api/v1beta/skills/build
Build a skill
body → 200400500
GET
/api/v1beta/skills/builds
List locally-built skill artifacts
→ 200500
DELETE
/api/v1beta/skills/builds/{tag}
Delete a locally-built skill artifact
1 param → 204404500
GET
/api/v1beta/skills/content
Get skill content
1 param → 200400401404429500502504
POST
/api/v1beta/skills/push
Push a skill
body → 204400404500
POST
/api/v1beta/skills/validate
Validate a skill
body → 200400500

Schemas 24

The contract defines 24 schemas that model the data the API accepts and returns. The most detailed are registry.Skill (14 properties), github_com_stacklok_toolhive_pkg_skills.InstalledSkill (10 properties), registry.SkillPackage (8 properties), pkg_api_v1.installSkillRequest (7 properties). Each schema is shown below with its type and property counts.

github_com_stacklok_toolhive_pkg_skills.ValidationResult
object
3 properties
pkg_api_v1.buildListResponse
object
Response containing a list of locally-built OCI skill artifacts
1 property
github_com_stacklok_toolhive_pkg_skills.SkillFileEntry
object
2 properties
github_com_stacklok_toolhive_pkg_skills.BuildResult
object
1 property
registry.SkillPackage
object
8 properties
github_com_stacklok_toolhive_pkg_skills.SkillMetadata
object
Metadata contains the skill's metadata.
5 properties
pkg_api_v1.validateSkillRequest
object
Request to validate a skill definition
1 property
internal_api_x_skills.SkillListMetadata
object
2 properties
github_com_stacklok_toolhive_pkg_skills.InstalledSkill
object
InstalledSkill contains the full installation record.
10 properties
internal_api_x_skills.SkillListResponse
object
2 properties
github_com_stacklok_toolhive_pkg_skills.InstallStatus
string
Status is the current installation status.
registry.SkillIcon
object
4 properties
github_com_stacklok_toolhive_pkg_skills.Scope
string
Scope for the installation
registry.SkillRepository
object
Repository is the source repository of the skill.
2 properties
github_com_stacklok_toolhive_pkg_skills.SkillContent
object
6 properties
github_com_stacklok_toolhive_pkg_skills.SkillInfo
object
2 properties
registry.Skill
object
14 properties
pkg_api_v1.buildSkillRequest
object
Request to build a skill from a local directory
2 properties
github_com_stacklok_toolhive_pkg_skills.LocalBuild
object
5 properties
github_com_stacklok_toolhive_pkg_skills.Dependency
object
3 properties
pkg_api_v1.installSkillResponse
object
Response after successfully installing a skill
1 property
pkg_api_v1.installSkillRequest
object
Request to install a skill
7 properties
pkg_api_v1.pushSkillRequest
object
Request to push a built skill artifact
1 property
pkg_api_v1.skillListResponse
object
Response containing a list of installed skills
1 property

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

stacklok-skills-api-openapi.yml Raw ↑

Other APIs Stacklok publishes across the network.

Stacklok clients API
Stacklok discovery API
Stacklok groups API
Stacklok logs API
Stacklok registry API
Stacklok registry-servers API
Stacklok registry-skills API
Stacklok secrets API
Stacklok system API
Stacklok v1 API
Stacklok version API
Stacklok workloads API
Where this information came from

This is an independent, third-party profile of Stacklok skills API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.