palantir-common-errors

# Palantir Common Errors ## Overview Quick reference for the top 10 most common Foundry API and transform errors with copy-paste solutions. ## Prerequisites - `foundry-platform-sdk` installed - API credentials configured - Access to Foundry build logs or application logs ## Instructions ### Error 1: 401 Unauthorized — Invalid or Expired Token ``` foundry.ApiError: 401 Unauthorized — The provided token is invalid or expired. ``` **Fix:** ```python # Regenerate token in Developer Console # Settings > Tokens > Generate new personal access token # Or re-authenticate with OAuth2: auth = foundry.ConfidentialClientAuth( client_id=os.environ["FOUNDRY_CLIENT_ID"], client_secret=os.environ["FOUNDRY_CLIENT_SECRET"], hostname=os.environ["FOUNDRY_HOSTNAME"], scopes=["api:read-data"], ) auth.sign_in_as_service_user() # Gets a fresh token ``` ### Error 2: 403 Forbidden — Insufficient Scopes ``` foundry.ApiError: 403 Forbidden — Missing required scope: api:ontology-read ``` **Fix:** Add missing scopes in Developer Console > Your App > Scopes. Common scopes: - `api:read-data` — read datasets - `api:write-data` — write datasets - `api:ontology-read` — read Ontology objects - `api:ontology-write` — apply actions ### Error 3: ObjectTypeNotFound ``` foundry.ApiError: 404 ObjectTypeNotFound — Object type 'employee' not found ``` **Fix:** Object type names are `camelCase` API names, not display names. Check Ontology Manager: ```python # List all object types to find the corre...