# PipesHub Skills API

**Canonical:** https://apis.io/apis/pipeshub/pipeshub-skills-api/  
**Provider:** PipesHub — https://apis.io/providers/pipeshub/  
**Base URL:** https://app.pipeshub.com/api/v1  
**Documentation:** https://docs.pipeshub.com/developer/api-reference

PipesHub Skills API is one of 51 APIs that [PipesHub](https://apis.io/providers/pipeshub/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include Skills. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and 6 JSON Schemas.

Beta: Skills (SKILL.md packages) that agents load on demand — CRUD, versioning, resources, import (npm/URL/upload), and learning-loop candidate review. Gated by the ENABLE_SKILLS platform feature flag; disabled orgs get 403 on every route.

## Operations (26)

| Method | Path | Summary |
|---|---|---|
| GET | `/skills` | List skills |
| POST | `/skills` | Create a custom skill |
| GET | `/skills/categories` | Get skill categories and tags |
| GET | `/skills/search` | Search skills |
| GET | `/skills/candidates/pending` | List pending learning-loop skill candidates |
| POST | `/skills/candidates/{candidateId}/approve` | Approve a skill candidate |
| POST | `/skills/candidates/{candidateId}/reject` | Reject a skill candidate |
| POST | `/skills/import/npm/preview` | Preview an npm-sourced skill import |
| POST | `/skills/import/url/preview` | Preview a URL-sourced skill import |
| POST | `/skills/import/upload/preview` | Preview an uploaded skill archive |
| POST | `/skills/import/finalize` | Finalize a previewed skill import |
| GET | `/skills/{name}` | Get a skill |
| PUT | `/skills/{name}` | Update a skill |
| DELETE | `/skills/{name}` | Delete a skill (safe delete) |
| GET | `/skills/{name}/export` | Export a skill as SKILL.md |
| PATCH | `/skills/{name}/body` | Patch a skill's body with an exact string replacement |
| POST | `/skills/{name}/deprecate` | Deprecate a skill |
| POST | `/skills/{name}/disable` | Disable a skill |
| POST | `/skills/{name}/enable` | Re-enable a disabled skill |
| GET | `/skills/{name}/usage` | Get a skill's usage |
| GET | `/skills/{name}/versions` | List a skill's version history |
| GET | `/skills/{name}/versions/{version}` | Get a specific skill version |
| POST | `/skills/{name}/rollback` | Roll back a skill to a prior version |
| GET | `/skills/{name}/resource` | Get a bundled resource |
| PUT | `/skills/{name}/resource` | Write a bundled resource |
| DELETE | `/skills/{name}/resource` | Remove a bundled resource |

## Machine-readable artifacts (8)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/pipeshub/refs/heads/main/openapi/pipeshub-skills-api-openapi.yml
- **Documentation** — https://docs.pipeshub.com/developer/api-reference
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/pipeshub/refs/heads/main/json-schema/pipeshub-get-record-by-id-response-schema-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/pipeshub/refs/heads/main/json-schema/pipeshub-record-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/pipeshub/refs/heads/main/json-schema/pipeshub-knowledge-hub-nodes-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/pipeshub/refs/heads/main/json-schema/pipeshub-agent-create-conversation-request-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/pipeshub/refs/heads/main/json-schema/pipeshub-conversation-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/pipeshub/refs/heads/main/json-schema/pipeshub-create-conversation-request-schema.json

## Other PipesHub APIs (12)

- [PipesHub Agents API](https://apis.io/apis/pipeshub/pipeshub-agents-api/)
- [PipesHub AI Models Providers API](https://apis.io/apis/pipeshub/pipeshub-ai-models-providers-api/)
- [PipesHub Authentication Configuration API](https://apis.io/apis/pipeshub/pipeshub-authentication-configuration-api/)
- [PipesHub Configuration Manager API](https://apis.io/apis/pipeshub/pipeshub-configuration-manager-api/)
- [PipesHub Connector API](https://apis.io/apis/pipeshub/pipeshub-connector-api/)
- [PipesHub Connector Configuration API](https://apis.io/apis/pipeshub/pipeshub-connector-configuration-api/)
- [PipesHub Connector Control API](https://apis.io/apis/pipeshub/pipeshub-connector-control-api/)
- [PipesHub Connector Filters API](https://apis.io/apis/pipeshub/pipeshub-connector-filters-api/)
- [PipesHub Connector Instances API](https://apis.io/apis/pipeshub/pipeshub-connector-instances-api/)
- [PipesHub Connector OAuth API](https://apis.io/apis/pipeshub/pipeshub-connector-oauth-api/)
- [PipesHub Connector Registry API](https://apis.io/apis/pipeshub/pipeshub-connector-registry-api/)
- [PipesHub Connectors API](https://apis.io/apis/pipeshub/pipeshub-connectors-api/)

## Tags

Skills

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/pipeshub/pipeshub-skills-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/pipeshub/.