Sign in

v2

latestOpenAPI 3.1.02026-08-0382170235.8 KB
pots

Get a POT by 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.

get/pots/by-slug/{slug}

Path parameters

slugstring 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"
}