--- title: Teamwork Spaces API Integration on Truto slug: teamworkspaces category: Knowledge Management canonical: "https://truto.one/integrations/detail/teamworkspaces/" --- # Teamwork Spaces API Integration on Truto **Category:** Knowledge Management **Status:** Generally available ## Unified APIs ### Unified User Directory API - **Me** — - **Organizations** — Organizations are the top level entity in the source application. Users are associated with an organization. - **Users** — The User object represents a User. - **Workspaces** — Workspaces represent concepts like teams, workspaces, projects in apps that support them ## How it works 1. **Link your customer's Teamwork Spaces 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 Teamwork Spaces.** The Proxy API is a 1-to-1 mapping of the Teamwork Spaces 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 - **Sync employee identities into Teamwork Spaces for automated provisioning** — HRIS and identity management platforms can use Truto's Unified User Directory API to read and map users, organizations, and workspaces in Teamwork Spaces — ensuring new hires get access to the right knowledge bases on day one and departing employees are flagged for deprovisioning. - **Ingest Teamwork Spaces content for AI-powered knowledge retrieval** — AI copilot and internal search products can connect to Teamwork Spaces to index page content, workspace structures, and user metadata, grounding RAG pipelines in a customer's actual SOPs and company policies without requiring manual document uploads. - **Surface workspace and user context inside client-services platforms** — PSA and agency management tools can pull workspace and organizational data from Teamwork Spaces to display relevant knowledge base context alongside project delivery workflows, reducing context-switching for account managers and consultants. - **Audit workspace access and organizational structure for compliance tooling** — GRC and compliance platforms can read user-to-workspace assignments and organizational hierarchies via Truto to verify that access controls in Teamwork Spaces align with internal policies, producing audit-ready reports without manual data gathering. ## What you can build - **Automated workspace access mapping** — Read users, organizations, and workspace memberships from Teamwork Spaces to keep your product's permission model in sync with your customer's knowledge base structure. - **Org-chart-aware knowledge base directory** — Pull organizational and user data to render a browsable directory of Teamwork Spaces workspaces grouped by department or team. - **Identity verification dashboard for IT admins** — Surface a unified view of all Teamwork Spaces users and their workspace assignments alongside identities from other connected apps using Truto's Unified User Directory API. - **New hire onboarding checklist with Spaces context** — Automatically detect which workspaces a newly provisioned user has access to and present them as onboarding tasks inside your HR or onboarding product. - **Cross-app user deprovisioning alerts** — Monitor the Teamwork Spaces user directory for active accounts that have been deactivated in an upstream IdP, and surface actionable alerts in your security or IT platform. ## FAQs ### Which Truto Unified API resources are available for Teamwork Spaces today? Teamwork Spaces is mapped to Truto's Unified User Directory API, which exposes the Me, Users, Organizations, and Workspaces resources. Additional tools and unified models can be built on request. ### Can I read or write page content from Teamwork Spaces through Truto? Page content operations are not part of the currently available Unified User Directory API. However, the Teamwork Spaces API does support page CRUD — Truto can build custom tools or proxy endpoints for this on request. ### How does authentication work for Teamwork Spaces integrations? Truto manages the full auth lifecycle for your end users. Teamwork Spaces supports OAuth 2.0 through the Teamwork.com platform, and Truto handles token exchange, storage, and refresh so you never deal with credentials directly. ### Does Truto handle pagination and rate limits for the Teamwork Spaces API? Yes. Truto abstracts away pagination logic and respects Teamwork Spaces API rate limits automatically, so your application receives clean, complete result sets without needing to manage cursors or throttling. ### Can I request support for Teamwork Spaces endpoints not yet covered by Truto? Absolutely. Truto builds new tools and unified model mappings on request. If you need access to pages, required reading status, or other Teamwork Spaces-specific data, the Truto team can scope and deliver those integrations. ### Is Teamwork Spaces data available in real-time or batch? Data is fetched via API calls in near real-time. Truto does not currently list webhook-based sync for Teamwork Spaces, but polling strategies and caching can be configured to balance freshness with rate limit budgets.