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

# Get a POT by UUID

`GET /pots/{pot_id}`

Get a POT by its UUID, scoped to the caller's workspace.

Args:
    pot_id: POT unique identifier
    pot_service: Injected PotService instance
    workspace_id: Caller's workspace (auth context or X-Workspace-ID)

Returns:
    POT data

Raises:
    404: POT not found (or owned by another workspace)

## Path parameters

- `pot_id` string, uuid, 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
- `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)