Sign in

v2

latestOpenAPI 3.1.02026-08-0382170235.8 KB
pots

Get a POT by UUID

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)

get/pots/{pot_id}

Path parameters

pot_idstring uuid required

Response

POT retrieved successfully

idstring uuid required
slugstring required
workspace_idstring uuid required
namestring required
descriptionstring required
domainstring

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.

created_atstring date-time required
updated_atstring date-time required

Example response

{
  "constitution": {
    "approved_by": "system",
    "fact_count": 3,
    "facts": [
      {
        "content": "SciPot builds memory infrastructure for AI agents",
        "id": "const_001",
        "level": "CONSTITUTION",
        "pot_score": 1
      }
    ],
    "last_updated": "2026-01-06T10:30:45Z",
    "version": "1.0"
  },
  "created_at": "2026-01-06T10:30:45.123456Z",
  "description": "A POT about SciPot itself",
  "id": "018d1e8c-7b29-7a3e-8c1d-5e9a1c2d3e4f",
  "name": "SciPot Meta-POT",
  "slug": "scipot-pot",
  "updated_at": "2026-01-06T10:30:45.123456Z",
  "workspace_id": "550e8400-e29b-41d4-a716-446655440000"
}