How palantir/foundry-platform-python works
The Foundry Platform SDK is a generated Python client for Foundry’s versioned APIs. Users configure a client with authentication and a hostname, select an API resource, and invoke operations such as creating a dataset branch or querying data; responses and errors are handled through shared runtime infrastructure. The graph preserves the major API domains listed in the repository tree and README. Some domain internals are unsampled, so edges reflect only README statements or source-index references, not inferred domain-to-domain workflows.
Main entry points: client.py Versioned clients · api_client.py API transport · auth_utils.py Authentication · datasets Datasets
Components 23
Client setup
- Versioned clients
foundry_sdk/v2/client.py - Client configuration
foundry_sdk/_core/client_init_helpers.py - Authentication
foundry_sdk/_core/auth_utils.py - User token auth
foundry_sdk/_core/user_token_auth_client.py - OAuth client auth
foundry_sdk/_core/confidential_client_auth.py - Public client auth
foundry_sdk/_core/public_client_auth.py - Pipeline auth
foundry_sdk/_core/compute_module_pipeline_auth.py - Hostname resolution
foundry_sdk/_core/hostname_supplier.py
Shared runtime
- API transport
foundry_sdk/_core/api_client.py - Shared models
foundry_sdk/v2/core/models.py - Error handling
foundry_sdk/_errors
Data and ontology
- Datasets
foundry_sdk/v2/datasets - Ontology resources
foundry_sdk/v2/ontologies - Functions and queries
foundry_sdk/v2/functions - SQL queries
foundry_sdk/v2/sql_queries - Filesystem
foundry_sdk/v2/filesystem
Platform APIs
- Administration
foundry_sdk/v2/admin - AI agents and models
foundry_sdk/v2/aip_agents - Orchestration
foundry_sdk/v2/orchestration - Connectivity and streams
foundry_sdk/v2/connectivity - Other API domains
foundry_sdk/v2
Other components
- SDK user
- Foundry API
Connections 32
- SDK user → Versioned clients: initializes
- Versioned clients → Client configuration: resolves settings
foundry_sdk/v2/client.py - Versioned clients → Administration: creates namespace
foundry_sdk/v2/client.py - Versioned clients → AI agents and models: creates namespace
foundry_sdk/v2/client.py - Versioned clients → Orchestration: creates namespace
foundry_sdk/v2/client.py - Versioned clients → Connectivity and streams: creates namespace
foundry_sdk/v2/client.py - Versioned clients → Datasets: creates namespace
foundry_sdk/v2/client.py - Versioned clients → Filesystem: creates namespace
foundry_sdk/v2/client.py - Versioned clients → Functions and queries: creates namespace
foundry_sdk/v2/client.py - Versioned clients → Ontology resources: creates namespace
foundry_sdk/v2/client.py - Versioned clients → SQL queries: creates namespace
foundry_sdk/v2/client.py - Versioned clients → Other API domains: exposes namespaces
foundry_sdk/v2/client.py - Client configuration → Authentication: selects auth
foundry_sdk/_core/client_init_helpers.py - Client configuration → Hostname resolution: resolves hostname
foundry_sdk/_core/client_init_helpers.py - User token auth → Authentication: implements
foundry_sdk/_core/user_token_auth_client.py - OAuth client auth → Authentication: implements
foundry_sdk/_core/confidential_client_auth.py - Public client auth → Authentication: implements
foundry_sdk/_core/public_client_auth.py - Pipeline auth → Authentication: implements
foundry_sdk/_core/compute_module_pipeline_auth.py - Datasets → API transport: uses
- Ontology resources → API transport: uses
- Functions and queries → API transport: uses
foundry_sdk/v2/functions/query.py - SQL queries → API transport: uses
foundry_sdk/v2/sql_queries/sql_query.py - Filesystem → API transport: uses
- Administration → API transport: uses
- AI agents and models → API transport: uses
- Orchestration → API transport: uses
- Connectivity and streams → API transport: uses
- API transport → Foundry API: sends API requests
- SDK user → Datasets: creates branch
- Ontology resources → Foundry API: accesses resources
- Datasets → Shared models: uses schemas
- API transport → Error handling: raises API errors