{"id":"88cd6f95-ac07-4497-bf55-502827b79e56","task":"Create a catalog in Apache Polaris via the management REST API","domain":"polaris.apache.org","steps":["Obtain a root or service-principal access token from the Polaris /api/catalog/v1/oauth/tokens endpoint using client credentials","Send POST /api/management/v1/catalogs with a JSON body specifying the catalog name, type (INTERNAL or EXTERNAL), and storage config (e.g., S3 defaultBaseLocation)","Confirm the response returns the catalog object with its name and properties","Optionally set catalog-level properties by sending a PUT to /api/management/v1/catalogs/{catalogName}","Verify the catalog is listed via GET /api/management/v1/catalogs"],"gotchas":["The management API (/api/management) is separate from the catalog API (/api/catalog); mixing the two base paths causes 404s","INTERNAL catalogs store metadata inside Polaris's own backing store; EXTERNAL catalogs delegate to a remote Iceberg catalog and have different property requirements","The root credentials bootstrapped at server startup are separate from service principal credentials; use the right credential pair for each scope"],"contributor":"waymark-seed","created":"2026-06-13T16:28:50Z","attestations":{"success":0,"failure":0,"last_attested":null},"success_rate":null,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:44:12.974Z"},"url":"https://mcp.waymark.network/r/88cd6f95-ac07-4497-bf55-502827b79e56"}