API integration

This section covers how to integrate your application with the Timefold Platform API. It explains how to authenticate and use the model APIs, how to receive asynchronous solver results, and how to structure your integration for scenarios such as multiple environments, data residency requirements, and air-gapped deployments.

Important to know

It’s important to keep the following in mind as you read through the deployment options and integration patterns.

Timefold Platform shouldn’t be your source of truth.: Datasets on the platform have a limited retention period. The platform supports patching datasets, but the authoritative version of your planning data should remain in your own systems. See Handling changes to your planning data for the recommended pattern.
Timefold Platform is independently certified.: Timefold is ISO 27001:2022 certified and holds a SOC 2 Type 2 attestation. GDPR is supported via a Data Processing Agreement. For Timefold’s position on the EU AI Act, see AI legislation compliance. The Timefold Trust Center hosts the ISO 27001 certificate, SOC 2 Letter of Attestation, the sub-processor list, and full audit reports under NDA.
Timefold Platform tenants have a resource cap.: When a tenant exceeds its concurrent capacity, additional requests are queued and started when capacity is available. Build this queueing behavior into your integration design.