Private AI integrates with OpenProject for project and task synchronization. Once configured, tasks on your Kanban board sync bi-directionally between both systems.
OpenProject is an open-source project management system. This integration allows teams to work across both platforms seamlessly.

​
For Users

Account linking requires administrator access. Contact your administrator to link your Private AI account to OpenProject.

​
Board Synchronization

When projects are synced, tasks appear on both boards simultaneously.
Private AI board with synchronized tasks
OpenProject board showing same tasks
Moving a task on either board updates the other automatically.

​
For Administrators

​
Prerequisites

  • OpenProject server running and accessible
  • OpenProject API token with appropriate permissions

​
Configuring Connection

1

Open OpenProject Settings

Navigate to Settings → OpenProject Sync.
2

Enter connection details

Provide:
  • Base URL: Your OpenProject server URL (e.g., https://openproject.example.com)
  • API Token: Token from your OpenProject account
Settings page with base URL and API token fields
3

Test connection

Click Test Connection to verify connectivity.
Test connection showing success or failure
4

Enable sync

Toggle Enabled and save settings.
Keep your API token secure. It provides access to your OpenProject data.

​
Syncing User Accounts

Link Private AI accounts to OpenProject accounts for proper task attribution.
1

Open User Management

Navigate to Settings → User Management.
2

Select user

Find the user you want to link.
3

Link to OpenProject

Click the Link icon. Select the corresponding OpenProject account.
User sync dialog showing OpenProject account selection
User sync dialog showing OpenProject account selection
User sync dialog showing OpenProject account selection
Linked users’ tasks will sync with their OpenProject identity, ensuring proper attribution.

​
Syncing Projects

Select which Private AI projects to synchronize with OpenProject.
1

Open Project Sync

Navigate to Settings → Project Sync.
2

Select projects

Check the projects you want to sync.
List of Private AI projects available for sync
3

Sync

Click Sync Selected. Each project creates a corresponding project in OpenProject with a Kanban board.
All existing tasks in the project are synced automatically when you sync a project.

​
Reverse Sync (OpenProject to Private AI)

To sync an existing OpenProject project to Private AI:
  1. Open the project in OpenProject
  2. Navigate to the project settings
  3. Enable Private AI sync
  4. The project and its tasks appear in Private AI
Reverse sync configuration is done on the OpenProject side. Detailed instructions depend on your OpenProject setup.

​
Status Mapping

Configure how task statuses map between Private AI and OpenProject columns.
Mapping Private AI statuses to OpenProject status IDs
Each Private AI status (Todo, In Progress, In Review, Done, Cancelled) maps to an OpenProject status ID.
Find OpenProject status IDs in your OpenProject project settings under Work Package statuses.

​
Sync History

View the history of synchronized tasks.
List of synchronized tasks with timestamps

​
Troubleshooting

  • Verify Base URL is correct and accessible
  • Check API token is valid and not expired
  • Ensure network connectivity between Private AI and OpenProject
  • Verify API token has required permissions
  • Confirm project is synced (check Project Sync page)
  • Verify OpenProject sync is enabled in settings
  • Check status mapping is configured correctly
  • Ensure user accounts are linked
  • Review status mapping configuration
  • Verify OpenProject status IDs are correct
  • Check that mapped statuses exist in OpenProject project