{"id":27003,"library":"foundry-platform-sdk","title":"Foundry Platform SDK","description":"The official Python library for the Palantir Foundry API. Version 1.82.0, requires Python >=3.10, <4.0. Rapid release cadence (weekly).","status":"active","version":"1.82.0","language":"python","source_language":"en","source_url":"https://github.com/palantir/foundry-platform-python","tags":["foundry","palantir","api-client","sdk"],"install":[{"cmd":"pip install foundry-platform-sdk","lang":"bash","label":"Install from PyPI"}],"dependencies":[{"reason":"HTTP client used internally","package":"httpx","optional":false},{"reason":"Data validation and settings management","package":"pydantic","optional":false}],"imports":[{"wrong":"from foundry import FoundryClient","symbol":"FoundryClient","correct":"from foundry_sdk import FoundryClient"}],"quickstart":{"code":"from foundry import FoundryClient\nfrom foundry import os\n\nclient = FoundryClient(\n    hostname=os.environ.get('FOUNDRY_HOSTNAME', ''),\n    token=os.environ.get('FOUNDRY_TOKEN', ''),\n)\n\n# List users\nusers = client.admin.User.list()\nfor user in users.data[:5]:\n    print(user.email)","lang":"python","description":"Initialize client with hostname and token from environment variables."},"warnings":[{"fix":"Upgrade Python to 3.10 or later.","message":"The SDK requires Python >=3.10. Installations on Python 3.9 or lower will fail.","severity":"breaking","affected_versions":"all versions >=1.0.0"},{"fix":"Switch to using FOUNDRY_TOKEN or FoundryClient(token=...).","message":"Authentication via foundry_client_id and foundry_client_secret environment variables is deprecated in favor of token-based auth using FOUNDRY_TOKEN.","severity":"deprecated","affected_versions":">=1.50.0"},{"fix":"Use 'from foundry import FoundryClient'.","message":"The correct import is from foundry import FoundryClient, NOT from foundry_platform_sdk. Many users mistakenly use the PyPI package name as import root.","severity":"gotcha","affected_versions":"all versions"},{"fix":"Use users.data instead of users directly.","message":"List methods return a paginated object, not a plain list. Access .data to get items.","severity":"gotcha","affected_versions":"all versions"}],"env_vars":null,"search_vec":"'1.82.0':14 '3.10':17 '4.0':18 'api':12,26 'api-cli':25 'cadenc':21 'client':27 'foundri':1,11,23 'librari':7 'offici':5 'palantir':10,24 'platform':2 'python':6,16 'rapid':19 'releas':20 'requir':15 'sdk':3,28 'version':13 'week':22","created_at":"2026-05-01T17:44:00.291448+00:00","updated_at":"2026-05-01T17:44:00.291448+00:00","problems":null,"ecosystem":"pypi","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":"","cli_version":null,"type":"library","homepage":"https://www.palantir.com/docs/foundry/","github":"https://github.com/palantir/foundry-platform-python","docs":null,"changelog":null,"pypi":"https://pypi.org/project/foundry-platform-sdk/","npm":null,"openapi_spec":null,"status_page":null,"smithery":null,"categories":["http-networking","aws","gcp","azure"],"base_url":null,"auth_type":null,"provenance":{"verified_status":"passing","verified_at":"2026-07-03","last_verified":"2026-07-03","next_check":"2026-08-02","install_tag":null}}