---
title: "Get a POT by slug"
method: GET
path: "/pots/by-slug/{slug}"
tags: ["pots"]
---

# Get a POT by slug

`GET /pots/by-slug/{slug}`

Look up a POT by its human-readable slug within the workspace identified by the `X-Workspace-ID` header. Returns the same shape as `GET /pots/{pot_id}`.

**Renamed from `/pots/by-slug/{workspace_id}/{slug}`** — the workspace path segment was redundant with the required header and has been removed.

## Path parameters

- `slug` string, required

## Response `200`

POT retrieved successfully

- POTResponse — POT for API responses.
  - `id` string, uuid, required
  - `slug` string, required
  - `workspace_id` string, uuid, required
  - `name` string, required
  - `description` string, required
  - `domain` string — Knowledge domain of the POT (from config.pot.domain). Exposed so clients — e.g. `scipot pot export` — can round-trip it; the coverage-gap routing key derives from it.
  - `constitution` ConstitutionResponse, required — Constitution for API responses.
    - `facts` ConstitutionFactResponse[], required
      - `id` string, required
      - `content` string, required
      - `title` string, nullable
      - `pot_score` number, required
      - `level` string, required
      - `rationale` string, nullable
      - `keywords` string[]
    - `version` string
    - `last_updated` string, required
    - `approved_by` string, required
    - `fact_count` integer, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `404` — POT not found in this workspace
- `422` — Validation Error

---

[API](https://skmtc.dev/scipot/apis/scipot-core-api.md) · [All operations](https://skmtc.dev/scipot/apis/scipot-core-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/scipot/scipot-core-api/revisions/e8712e9ffeae/schema)