---
title: "The installable skill catalog with this workspace's install state"
method: GET
path: "/v1/skill-catalog"
tags: ["skill-hub"]
---

# The installable skill catalog with this workspace's install state

`GET /v1/skill-catalog`

## 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-catalog`
- Auth: HTTP bearer

Every skill this workspace can install right now (the released platform catalog), overlaid with which ones are already installed here, so the dashboard can offer Install or link straight to the installed skill.

## Headers

- `X-Tenant-Id` string, nullable

## Response `200`

Successful Response

- CatalogSkillSummary[]
  - `slug` string, required
  - `title` string, required
  - `description` string, nullable
  - `listing_state` 'unlisted' | 'testing' | 'listed', required: Who can discover and install a global skill.
  - `category` string, nullable
  - `taxonomy` string, nullable
  - `stage` string, nullable
  - `tags` string[]
  - `keywords` string[]
  - `integrations_required` string[]
  - `integrations_recommended` string[]
  - `installed` boolean
  - `default_suppressed` boolean
  - `default_restore_would_lose_settings` boolean
  - `default_enabled` boolean
  - `installation_id` string, uuid, nullable
  - `installation_status_code` string, nullable
  - `install_count_band` integer, nullable
  - `use_count` integer, nullable
  - `last_used_at` string, date-time, nullable
  - `rating` SkillRatingSummary: A rating rate and the evidence count that gives the rate meaning.
    - `rated_count` integer, required
    - `rate` number, required
    - `ranking_score` number, nullable
  - `has_settings` boolean, required
  - `effectively_enabled` boolean, required
  - `default_capable` boolean, required

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