Content Integration Overview

Content Integration is the layer for connecting external content systems with TutorFlow content. It is designed for two flows:

• Import existing source JSON, such as a customer's category, level, and lesson structure, and expand it into TutorFlow authoring outputs.
• Control content created in TutorFlow so another system can retrieve, update, and reconcile resources.

Content Integration is not the Agent Platform API. Use /v1/content/** and tf_content_ keys for human-owned TutorFlow content that appears in classrooms and the admin UI. Use /v1/platform/** only for AI agent workflows that were explicitly built for the Agent Platform.

Recommended flow

1. Create a test Content Integration API key as a signed-in TutorFlow admin.
2. Create a Content Integration job with one small source JSON payload.
3. Store the returned job id in the external system.
4. Poll the job status endpoint until it is completed or failed.
5. Retrieve the result manifest.
6. Store the result manifest and any generated resource references in the external system.
7. Test direct resource reads and updates if TutorFlow-created content must sync back.
8. Use webhooks for production status updates once polling is verified.

Output priorities

1. interactive_module, primary output for app insertion.
2. summary_video, secondary output. Video generation creates the editable video structure. MP4 rendering is triggered separately after review.
3. expanded_quiz, tertiary output for extra assessment coverage.

Related guides

• Content Integration Quickstart
• Content API Key Management
• Source JSON Payload
• Content Integration API
• Content Resource API
• Content Integration API Reference
• Content Integration Testing Guide
• Content Integration Webhooks
• Content Integration Errors
• Content Integration Examples
• Content Integration Security
• Integration Confirmation Checklist
• Content Integration FAQ
• Developer and AI Agent Runbook