What gets indexed
- Tasks - Task names, descriptions, and full metadata
- Comments - Task comments embedded within their parent tasks
- Task metadata - Project, task list, status, priority, assignee, creator, due dates, tags, and more
Task details indexed
| Field | Description |
|---|---|
| Assignee | User assigned to the task |
| Attachments | Attachment names (content not indexed) |
| Completion status | Whether the task is completed and when |
| Creator | User who created the task |
| Description | Full task description |
| Due date | Task deadline |
| Estimated time | Time estimate in hours/minutes |
| Parent task | For subtasks, the parent task reference |
| Priority | Task priority level |
| Project | Project the task belongs to |
| Start date | Task start date |
| Status | Current task status |
| Tags | Task tags/labels |
| Task list | Task list within the project |
Comments are indexed as part of their parent task, not as separate documents. This keeps task discussions together for better search relevance.
Setup
Connect to Grapevine
- In Grapevine, go to Integrations and click on Teamwork
- Click Connect Teamwork Account to begin the authorization process
Authorize connection
- You’ll be redirected to Teamwork to authorize the Grapevine integration
- Log into Teamwork if needed
- Select your Teamwork installation
- Click Allow to grant access
Permissions
- Only non-private tasks are indexed (private tasks are excluded)
- All indexed Teamwork tasks are visible to all users in the Grapevine tenant
Sync behavior
- Initial sync - Indexes all tasks across all projects, including completed tasks
- Ongoing syncs - Uses incremental sync to fetch only tasks updated since the last sync
- Deletions - Deleted tasks are removed from the index
The connector uses batch fetching to efficiently retrieve tasks with their related data (projects, task lists, comments, tags, attachments) in fewer API calls.
Rate limits
Teamwork enforces rate limits based on your plan:| Plan | Rate Limit |
|---|---|
| Free | 30 req/min |
| Premium+ | 150 req/min |
For large workspaces with many tasks, a Premium or higher plan is recommended for faster initial syncs. The connector implements automatic retry with exponential backoff when rate limits are encountered.
Limitations
- Private tasks are not indexed (only non-private tasks)
- Attachment content is not indexed (only attachment names)
- Task files and documents are not indexed
- Access tokens are long-lived and do not expire