---
id: foundry-platform-sdk
version: "1.103.0"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# foundry-platform-sdk — The official Python library for the Foundry API

License: permissive · Maintenance: active · Downloads: 1.0M/mo

## What it is and what it does

The Foundry Platform SDK is an auto-generated Python client for Palantir's Foundry API, providing structured access to platform resources like datasets, branches, and ontology metadata. It wraps HTTP calls to versioned Foundry API endpoints (v1, v2, etc.) and handles authentication via user tokens or OAuth2 client credentials. The SDK is built on httpx for HTTP transport and pydantic for request/response validation, and it automatically retries failed requests when OAuth2 tokens expire.

You use it to programmatically interact with Foundry platform infrastructure—creating branches, querying datasets, managing ontological resources—from Python applications. The SDK distinguishes itself from the Ontology SDK by surfacing platform-level operations on resource types themselves. It's designed for applications that need to automate Foundry administration or integrate Foundry data workflows into larger systems.

Use it for:

- Automate dataset and branch creation or management workflows in Foundry from Python scripts
- Build integration layers that programmatically query Foundry platform metadata and ontology definitions
- Develop service applications using OAuth2 client credentials to access Foundry resources on behalf of a service user
- Construct data pipelines that need to interact with Foundry datasets and transactions via API
- Create administrative tools that manage Foundry platform resources without manual console interaction

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

A Python client library for the Foundry API that provides programmatic access to Foundry platform resources including datasets, branches, and ontological constructs through versioned endpoints.

Yes. The SDK is actively maintained (released 1 day ago), has low install friction, supports current Python versions (3.10–3.14), carries no known vulnerabilities, and is licensed permissively. Install it if you need programmatic access to Foundry platform APIs; skip it if you only need to query Foundry objects and links or if you're working with Gotham platform.

## Install

pip install foundry-platform-sdk
uv add foundry-platform-sdk
poetry add foundry-platform-sdk

## Installing foundry-platform-sdk

Before you install: Low friction install with a pure-wheel distribution and eight common runtime dependencies. Actively maintained with a release 1 day old and 197 repository stars.

License in practice: Licensed under Apache-2.0 (permissive), allowing commercial use, modification, and redistribution with minimal restrictions.

Quickstart:

pip install foundry-platform-sdk

from foundry_platform_sdk import FoundryClient

client = FoundryClient(
    auth=UserTokenAuth(token),
    hostname="example.palantirfoundry.com"
)
api_response = client.datasets.Dataset.Branch.create(
    dataset_rid, name="master"
)

Requires Python 3.10 or later. Requires a Foundry instance hostname and valid authentication token (user token or OAuth2 client credentials).

Verify before relying:

- Whether the SDK covers all current Foundry API endpoints or if some require direct HTTP calls
- Performance characteristics when working with large datasets or high-volume API calls
- Specific scopes required for different endpoint categories when using OAuth2 authentication

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 1.0M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

foundry api client, palantir foundry sdk, foundry dataset access, foundry platform python, api client for foundry, foundry branch management, foundry platform api, palantir-foundry, api-client, oauth2

[View on SkillFed](https://skillfed.io/packages/foundry-platform-sdk) · [View on PyPI](https://pypi.org/project/foundry-platform-sdk/)