> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Teamwork

> Teamwork is a project management platform for planning projects, coordinating tasks, collaborating with teams, and tracking time.

![Teamwork logo](https://mintcdn.com/composio-preview/IA0_SoMcsWt17HEC/images/toolkits/teamwork.svg?fit=max\&auto=format\&n=IA0_SoMcsWt17HEC\&q=85\&s=ebf27bc875b32441407b1c3e40f6e40c)

* **Category:** project management
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 12
* **Triggers:** 0
* **Slug:** `TEAMWORK`
* **Version:** 20261019\_00

## Tools

> [accordion] Create Tag
>
> **Slug:** `TEAMWORK_CREATE_TAG`
>
> Create a Teamwork tag, or return the existing installation tag when the same name already exists.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Non-empty tag name.
>
> **color** `string`
>
> Optional six-digit hex color, such as #3455DB.
>
> **project\_id** `integer`
>
> Project ID for a project tag, or 0 for an installation-wide tag.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Task
>
> **Slug:** `TEAMWORK_CREATE_TASK`
>
> Create a task in a Teamwork task list with common scheduling, assignment, estimate, privacy, and tag fields.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Task name.
>
> **tag\_ids** `array`
>
> Existing Teamwork tag IDs to attach.
>
> **due\_date** `string`
>
> Task due date as YYYY-MM-DD.
>
> **is\_private** `boolean`
>
> Whether the task should be private.
>
> **start\_date** `string`
>
> Task start date as YYYY-MM-DD.
>
> **description** `string`
>
> Plain-text task description.
>
> **fire\_webhook** `boolean`
>
> Allow Teamwork entity-update webhooks for this request.
>
> **task\_list\_id** `integer` *required*
>
> ID of the task list that will contain the task.
>
> **notify\_assignees** `boolean`
>
> Notify assignees about the new task.
>
> **assignee\_user\_ids** `array`
>
> Teamwork person IDs to assign.
>
> **estimated\_minutes** `integer`
>
> Estimated effort in minutes.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Milestones
>
> **Slug:** `TEAMWORK_LIST_MILESTONES`
>
> List visible Teamwork milestones by project, status, due-date range, assignee, or text. Returns one page and an opaque continuation cursor.
>
> #### Input Parameters
>
> **statuses** `array`
>
> Filter by one or more milestone statuses, such as completed, incomplete, late, today, or upcoming.
>
> **due\_after** `string`
>
> Only return milestones due on or after this YYYY-MM-DD date.
>
> **page\_size** `integer`
>
> Maximum number of milestones to return in this page (1-500).
>
> **due\_before** `string`
>
> Only return milestones due on or before this YYYY-MM-DD date.
>
> **next\_cursor** `string`
>
> Opaque cursor returned by a previous call. Omit for the first page and keep all filters unchanged when continuing.
>
> **project\_ids** `array`
>
> Only return milestones in these Teamwork projects.
>
> **search\_term** `string`
>
> Filter milestones by name or description.
>
> **assigned\_user\_ids** `array`
>
> Only return milestones assigned to these Teamwork people.
>
> **include\_completed** `boolean`
>
> Include completed milestones.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List People
>
> **Slug:** `TEAMWORK_LIST_PEOPLE`
>
> List people visible to the connected Teamwork user for assignment and ownership workflows.
>
> #### Input Parameters
>
> **page\_size** `integer`
>
> Maximum people to return in this page (1-500).
>
> **user\_type** `string ("account" | "collaborator" | "contact")`
>
> Filter by account, collaborator, or contact.
>
> **next\_cursor** `string`
>
> Opaque cursor returned by a previous call; omit for the first page.
>
> **project\_ids** `array`
>
> Only return people associated with these project IDs.
>
> **search\_term** `string`
>
> Filter people by name or other text indexed by Teamwork.
>
> **include\_clients** `boolean`
>
> Include client users.
>
> **include\_collaborators** `boolean`
>
> Include collaborator users.
>
> **include\_service\_accounts** `boolean`
>
> Include service accounts.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Projects
>
> **Slug:** `TEAMWORK_LIST_PROJECTS`
>
> List projects visible to the connected Teamwork user, with focused filters for name, status, company, membership, and archival state. Returns one page and an opaque continuation cursor.
>
> #### Input Parameters
>
> **page\_size** `integer`
>
> Maximum number of projects to return in this page (1-500).
>
> **company\_ids** `array`
>
> Return projects belonging to these Teamwork company IDs.
>
> **next\_cursor** `string`
>
> Opaque cursor returned by a previous call. Omit for the first page and keep all filters unchanged when continuing.
>
> **search\_term** `string`
>
> Filter projects by name.
>
> **updated\_after** `string`
>
> Only return projects updated after this ISO 8601 timestamp.
>
> **include\_archived** `boolean`
>
> Include archived projects in the results.
>
> **only\_my\_projects** `boolean`
>
> Only return projects where the connected user has explicit membership.
>
> **project\_statuses** `array`
>
> Filter by one or more project statuses: active, current, late, upcoming, completed, or deleted.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Tags
>
> **Slug:** `TEAMWORK_LIST_TAGS`
>
> List Teamwork tags visible to the connected user, optionally filtered by project, item type, name, or usage. Returns one page and an opaque continuation cursor.
>
> #### Input Parameters
>
> **item\_type** `string ("all" | "project" | "task" | "tasklist" | "milestone" | "message" | "comment" | "timelog" | "file" | "user" | "company" | "invoice" | "risk" | "notebook" | "link" | "event" | "notebookversion" | "fileversion")`
>
> Filter tag usage by item type, such as project, task, tasklist, milestone, timelog, user, or company.
>
> **page\_size** `integer`
>
> Maximum number of tags to return in this page (1-500).
>
> **next\_cursor** `string`
>
> Opaque cursor returned by a previous call. Omit for the first page and keep all filters unchanged when continuing.
>
> **project\_ids** `array`
>
> Only return tags associated with these projects. Installation-wide tags may have project ID 0.
>
> **recent\_only** `boolean`
>
> When true, return recently used tags instead of all accessible tags.
>
> **search\_term** `string`
>
> Filter tags by name.
>
> **with\_counters** `boolean`
>
> Include each tag's usage count.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Task Lists
>
> **Slug:** `TEAMWORK_LIST_TASK_LISTS`
>
> List Teamwork task lists, usually within one or more projects, so an agent can place or locate tasks.
>
> #### Input Parameters
>
> **page\_size** `integer`
>
> Maximum task lists in this page (1-500).
>
> **next\_cursor** `string`
>
> Opaque cursor returned by a previous call; omit for the first page.
>
> **project\_ids** `array`
>
> Only return task lists in these projects.
>
> **search\_term** `string`
>
> Filter task lists by name.
>
> **include\_empty** `boolean`
>
> Include task lists that contain no tasks.
>
> **updated\_after** `string`
>
> Only return task lists updated after this ISO 8601 timestamp.
>
> **show\_completed** `boolean`
>
> Include completed task lists.
>
> **include\_archived\_projects** `boolean`
>
> Include task lists from archived projects.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Tasks
>
> **Slug:** `TEAMWORK_LIST_TASKS`
>
> List and filter Teamwork tasks by project, task list, assignee, dates, completion state, or tags. Returns one page and an opaque cursor for continuation.
>
> #### Input Parameters
>
> **tag\_ids** `array`
>
> Only return tasks carrying these tag IDs.
>
> **due\_after** `string`
>
> Only return tasks due on or after this YYYY-MM-DD date.
>
> **page\_size** `integer`
>
> Maximum tasks in this page (1-500).
>
> **due\_before** `string`
>
> Only return tasks due on or before this YYYY-MM-DD date.
>
> **next\_cursor** `string`
>
> Opaque cursor returned by a previous call; omit for the first page.
>
> **project\_ids** `array`
>
> Only return tasks in these projects.
>
> **search\_term** `string`
>
> Filter by task text.
>
> **task\_filter** `string ("all" | "anytime" | "completed" | "created" | "overdue" | "today" | "yesterday" | "started" | "tomorrow" | "thisweek" | "within7" | "within14" | "within30" | "within365" | "nodate" | "noduedate" | "nostartdate" | "newTaskDefaults" | "hasDate")`
>
> Teamwork date or state preset used to select a predefined task window.
>
> **task\_list\_ids** `array`
>
> Only return tasks in these task lists.
>
> **assigned\_user\_ids** `array`
>
> Only return tasks assigned to these people.
>
> **include\_completed** `boolean`
>
> Include completed tasks.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Time Entries
>
> **Slug:** `TEAMWORK_LIST_TIME_ENTRIES`
>
> List accessible Teamwork time entries by project, task, person, date range, billing state, or tags. Returns one page and an opaque continuation cursor.
>
> #### Input Parameters
>
> **tag\_ids** `array`
>
> Only return time entries with these tag IDs.
>
> **end\_date** `string`
>
> Only return entries on or before this ISO 8601 date-time.
>
> **task\_ids** `array`
>
> Only return time entries linked to these tasks.
>
> **user\_ids** `array`
>
> Only return time entries for these people.
>
> **page\_size** `integer`
>
> Maximum time entries in this page (1-500).
>
> **start\_date** `string`
>
> Only return entries on or after this ISO 8601 date-time.
>
> **next\_cursor** `string`
>
> Opaque cursor returned by a previous call; omit for the first page.
>
> **project\_ids** `array`
>
> Only return time entries for these projects.
>
> **billable\_type** `string ("all" | "billable" | "non-billable")`
>
> Filter by all, billable, or non-billable entries.
>
> **invoiced\_type** `string ("all" | "invoiced" | "noninvoiced")`
>
> Filter by all, invoiced, or noninvoiced entries.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Log Time Entry
>
> **Slug:** `TEAMWORK_LOG_TIME_ENTRY`
>
> Log time against a Teamwork task with a date, duration, optional start time, description, person, billing state, and tags without changing task status.
>
> #### Input Parameters
>
> **date** `string` *required*
>
> Date worked as YYYY-MM-DD.
>
> **hours** `integer`
>
> Whole hours worked (0 or greater).
>
> **is\_utc** `boolean`
>
> Whether date and start\_time should be interpreted as UTC.
>
> **minutes** `integer`
>
> Additional minutes worked (0-59).
>
> **tag\_ids** `array`
>
> Tag IDs to attach to the time entry.
>
> **task\_id** `integer` *required*
>
> ID of the task receiving the time entry.
>
> **user\_id** `integer`
>
> Person ID to attribute the entry to; omit for the connected user when Teamwork permits.
>
> **start\_time** `string`
>
> Optional local start time as HH:MM:SS.
>
> **description** `string`
>
> Description of the work performed.
>
> **is\_billable** `boolean`
>
> Whether the time is billable.
>
> **fire\_webhook** `boolean`
>
> Allow Teamwork entity-update webhooks for this request.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search Teamwork
>
> **Slug:** `TEAMWORK_SEARCH_RESOURCES`
>
> Search across Teamwork projects, tasks, task lists, milestones, people, companies, time entries, and other supported item types. Returns one page of lightweight references, optional sideloaded details, and a continuation cursor.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum number of matches to return in this page.
>
> **types** `array`
>
> Resource types to search. Use all or one or more supported types such as projects, tasks, tasklists, milestones, users, companies, or timelogs.
>
> **order\_by** `string ("relevance" | "date")`
>
> Order results by relevance or date.
>
> **project\_id** `integer`
>
> Restrict results to one Teamwork project ID.
>
> **next\_cursor** `string`
>
> Opaque cursor returned by a previous call. Omit for the first page; the cursor retains and enforces all filters from the original search.
>
> **search\_term** `string` *required*
>
> Text to search for.
>
> **updated\_after** `string`
>
> Only search items updated after this ISO 8601 timestamp. Omit to use Teamwork's default search window.
>
> **include\_details** `array`
>
> Sideload full objects for selected result types, such as projects, tasks, tasklists, milestones, users, companies, or timelogs.
>
> **include\_completed** `boolean`
>
> Include completed tasks, task lists, and milestones.
>
> **include\_archived\_projects** `boolean`
>
> Include results from archived projects.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Task
>
> **Slug:** `TEAMWORK_UPDATE_TASK`
>
> Update selected fields of an existing Teamwork task while leaving omitted task fields unchanged.
>
> #### Input Parameters
>
> **name** `string`
>
> Replacement task name.
>
> **tag\_ids** `array`
>
> Replace attached tag IDs.
>
> **task\_id** `integer` *required*
>
> ID of the task to update.
>
> **due\_date** `string`
>
> Replacement due date as YYYY-MM-DD.
>
> **progress** `integer`
>
> Completion percentage from 0 to 100.
>
> **is\_private** `boolean`
>
> Set whether the task is private.
>
> **start\_date** `string`
>
> Replacement start date as YYYY-MM-DD.
>
> **description** `string`
>
> Replacement plain-text description.
>
> **fire\_webhook** `boolean`
>
> Allow Teamwork entity-update webhooks for this request.
>
> **notify\_assignees** `boolean`
>
> Notify assignees about the update.
>
> **assignee\_user\_ids** `array`
>
> Replace task assignees with these Teamwork person IDs.
>
> **estimated\_minutes** `integer`
>
> Replacement estimate in minutes.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
