---
title: "Install a skill pack into the workspace"
method: POST
path: "/v1/skill-packs/{pack_slug}/install"
tags: ["skill-packs"]
---

# Install a skill pack into the workspace

`POST /v1/skill-packs/{pack_slug}/install`

## Request

- Base URL: `https://api.patricia.app` (the document declares no server; this is the origin it was published from)
- URL: `https://api.patricia.app/v1/skill-packs/{pack_slug}/install`
- Auth: HTTP bearer

Install every skill in a pack, plus any skills those skills need. Each one arrives paused and pinned to its released version, with default settings, so nothing sends until it is set up and switched on. Skills this workspace already has are left exactly as they are. Installing the same pack twice is safe.

Every skill a pack installs is TEAM-wide, so this route requires skills:install, not just skills:create.

## Path parameters

- `pack_slug` string, required: The pack's slug.

## Headers

- `X-Tenant-Id` string, nullable

## Response `201`

Successful Response

- SkillPackInstallResponse: What a pack install did: one bucket per outcome, so the dashboard can say what happened.
  - `pack_slug` string, required: The pack that was installed.
  - `installed` string[]: Skill slugs now enabled for this workspace: freshly added (paused, awaiting setup), or a default-on member the workspace had switched off, restored in place with its saved config (already configured, already active).
  - `already_installed` string[]: Skill slugs this workspace already had running. Left exactly as they were.
  - `missing` string[]: Slugs with nothing to install yet (not released to the catalog).

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `403`: Forbidden. Inspect response body `code` for the specific reason (for example: PERMISSION_DENIED, EMAIL_NOT_VERIFIED, TENANT_ACCESS_REQUIRED, ROLE_UNRESOLVED)
- `404`: Not found
- `422`: Validation error

---

[API](https://skmtc.dev/patricia/apis/patricia-api.md) · [All operations](https://skmtc.dev/patricia/apis/patricia-api/llms.txt) · [OpenAPI document](https://skmtc.dev/patricia/apis/patricia-api/revisions/0dfb44495ea1?raw)