--- title: Platform.sh API Integration on Truto slug: platformsh category: Default canonical: "https://truto.one/integrations/detail/platformsh/" --- # Platform.sh API Integration on Truto **Category:** Default **Status:** Generally available ## Unified APIs ### Unified User Directory API - **Organizations** — Organizations are the top level entity in the source application. Users are associated with an organization. - **Users** — The User object represents a User. ## How it works 1. **Link your customer's Platform.sh account.** Use Truto's frontend SDK; we handle every OAuth and API key flow so you don't need to create the OAuth app. 2. **Authentication is automatic.** Truto refreshes tokens, stores credentials securely, and injects them into every API request. 3. **Call Truto's API to reach Platform.sh.** The Proxy API is a 1-to-1 mapping of the Platform.sh API. 4. **Get a unified response format.** Every response uses a single shape, with cursor-based pagination and data in the `result` field. ## Use cases - **Automate access auditing across Platform.sh organizations** — IAM and compliance SaaS products can pull Platform.sh organization and user data to continuously audit who holds admin, contributor, or viewer roles across production projects — ensuring departed employees are offboarded and access policies are enforced. - **Centralize developer identity across hosting providers** — Developer platform teams can unify user directories from Platform.sh alongside other infrastructure tools, giving their customers a single pane of glass for managing team members, roles, and project access across their entire stack. - **Enforce least-privilege access policies on PaaS environments** — Security and governance SaaS products can integrate with Platform.sh to detect over-provisioned users — such as developers with production database access they no longer need — and trigger automated remediation workflows. - **Streamline onboarding and offboarding for agency teams** — HR and IT automation platforms can sync Platform.sh user membership with their customer's identity provider, automatically granting or revoking project access as employees join, change roles, or leave the organization. ## What you can build - **Cross-platform user access inventory** — Ship a unified dashboard that lists every Platform.sh user alongside their roles, organization memberships, and project access — correlated with identities from other connected tools. - **Automated offboarding from Platform.sh** — Trigger Platform.sh user removal as part of a broader employee offboarding workflow when an account is deactivated in an identity provider. - **Role drift detection alerts** — Continuously compare Platform.sh user roles against a defined policy baseline and alert security teams when permissions escalate beyond expected levels. - **Organization-level access reports for compliance** — Generate exportable SOC 2 and GDPR-ready reports showing which users have access to which Platform.sh organizations and projects, with timestamps and role details. - **Bulk user provisioning for new projects** — Allow customers to select a team from their user directory and provision all members into a new Platform.sh project with pre-defined roles in a single action. ## FAQs ### What data can I access from Platform.sh through Truto today? Platform.sh is available through Truto's Unified User Directory API, which covers Organizations and Users. This lets you read org structures, user profiles, and role/membership data. Additional tools and endpoints can be built on request based on your specific needs. ### How does authentication work for Platform.sh integrations? Platform.sh uses OAuth2 and API token-based authentication. Truto handles the auth flow so your end users can securely connect their Platform.sh accounts without you managing token storage or refresh logic. ### Can I write data back to Platform.sh, such as adding or removing users? Write operations for Platform.sh are not pre-built but can be developed on request. Contact Truto to discuss specific workflows like user provisioning, role updates, or membership management. ### Does Truto handle Platform.sh API rate limits and pagination? Yes. Truto abstracts away API-specific quirks including pagination and rate limiting, so you get consistent, reliable data retrieval without building retry logic or cursor management yourself. ### Can I use the Unified User Directory API to map Platform.sh users to identities in other tools? Absolutely. The Unified User Directory API normalizes user data across connected integrations, so you can correlate a Platform.sh user with the same person's accounts in identity providers, collaboration tools, or other infrastructure platforms. ### What if I need Platform.sh data beyond Organizations and Users — like projects, environments, or deployment status? Truto builds integrations on request. If you need access to Platform.sh projects, environment metadata, variables, or deployment lifecycle actions, reach out and Truto can scope and build those capabilities for your use case.