> ## 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.

# ITM Platform

> ITM Platform provides modern project, portfolio, task, service, financial, risk, and resource management APIs plus read-only DataMart analytics.

![ITM Platform logo](https://mintcdn.com/composio-preview/tIuAovF9-7pXq2wA/images/toolkits/itm_platform.svg?fit=max\&auto=format\&n=tIuAovF9-7pXq2wA\&q=85\&s=c7cafab1c81cbdfd58d790bb988fd8b2)

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

## Tools

> [accordion] Aggregate DataMart Components
>
> **Slug:** `ITM_PLATFORM_AGGREGATE_DATAMART_COMPONENTS`
>
> Run a bounded read-only DataMart aggregation over project and service records for portfolio analytics.
>
> #### Input Parameters
>
> **pipeline** `array` *required*
>
> MongoDB-style read-only aggregation stages. Each stage must contain exactly one supported operator, and the final stage must be a positive \$limit no greater than 1000. \$lookup is forbidden.
>
> #### 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 Project
>
> **Slug:** `ITM_PLATFORM_CREATE_PROJECT`
>
> Create an ITM Platform project with its schedule and optional account-specific classification IDs. This changes customer data and has no v2 delete counterpart.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Project name.
>
> **type\_id** `integer`
>
> Account-specific project type ID; retrieve reference data rather than guessing.
>
> **end\_date** `string`
>
> Project end date as an ISO 8601 date or date-time; must not precede start\_date.
>
> **status\_id** `integer`
>
> Account-specific project status ID from List Reference Data.
>
> **start\_date** `string`
>
> Project start date as an ISO 8601 date or date-time.
>
> **description** `string`
>
> Project description; ITM Platform may store HTML.
>
> **priority\_id** `integer`
>
> Account-specific project priority ID from List Reference Data.
>
> **internal\_code** `string`
>
> Internal project code.
>
> **is\_kanban\_project** `boolean`
>
> Whether to create the project with Kanban behavior enabled.
>
> **performing\_unit\_id** `integer`
>
> Account-specific organizational unit responsible for the project.
>
> **internal\_cost\_center** `string`
>
> Internal cost-center code.
>
> #### 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:** `ITM_PLATFORM_CREATE_TASK`
>
> Create a task in an ITM Platform project using account-defined type, priority, and status names.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Task name.
>
> **details** `string`
>
> Task details or acceptance notes.
>
> **end\_date** `string`
>
> Task end date in YYYY-MM-DD format; must not precede start\_date.
>
> **sprint\_id** `string`
>
> Sprint ID to assign, if the project uses sprints.
>
> **type\_name** `string`
>
> Exact account-defined task type name from List Reference Data.
>
> **project\_id** `integer` *required*
>
> Project ID that will own the task.
>
> **start\_date** `string`
>
> Task start date in YYYY-MM-DD format.
>
> **status\_name** `string`
>
> Exact account-defined task status name from List Reference Data.
>
> **priority\_name** `string`
>
> Exact account-defined task priority name from List Reference Data.
>
> **swimlane\_name** `string`
>
> Exact Kanban swimlane name for the new task.
>
> **parent\_task\_id** `string`
>
> Parent task ID when creating a child task.
>
> **display\_in\_portfolio** `boolean`
>
> Whether the task should appear in portfolio views.
>
> #### 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] Get Project
>
> **Slug:** `ITM_PLATFORM_GET_PROJECT`
>
> Return the full current details of one project by its ITM Platform project ID.
>
> #### Input Parameters
>
> **project\_id** `integer` *required*
>
> ITM Platform project ID returned by Search Projects or Create Project.
>
> #### 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 Reference Data
>
> **Slug:** `ITM_PLATFORM_LIST_REFERENCE_DATA`
>
> List account-defined project or task statuses, priorities, or types needed to form valid project and task mutations.
>
> #### Input Parameters
>
> **kind** `string ("project_statuses" | "project_priorities" | "project_types" | "task_statuses" | "task_priorities" | "task_types")` *required*
>
> Reference collection to list: project\_statuses, project\_priorities, project\_types, task\_statuses, task\_priorities, or task\_types.
>
> #### 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 DataMart Components
>
> **Slug:** `ITM_PLATFORM_SEARCH_DATAMART_COMPONENTS`
>
> Search the read-only DataMart for project or service analytics records and return one offset-paginated page.
>
> #### Input Parameters
>
> **sort** `object`
>
> MongoDB-style sort map from field names to 1 for ascending or -1 for descending order.
>
> **limit** `integer`
>
> Maximum DataMart components in this page (1-200).
>
> **where** `object`
>
> MongoDB-style DataMart filter over component fields, for example componentType or nested task fields.
>
> **project** `object`
>
> MongoDB-style projection selecting only needed fields. Use dot notation for nested arrays, such as tasks.name, instead of selecting whole arrays.
>
> **next\_cursor** `string`
>
> Opaque continuation cursor from a previous response. When set, reuse it without changing the query criteria.
>
> #### 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 Projects
>
> **Slug:** `ITM_PLATFORM_SEARCH_PROJECTS`
>
> Search projects by account-specific filters and return one page of project summaries with a continuation cursor.
>
> #### Input Parameters
>
> **fields** `array`
>
> Project fields to return, for example Id, Name, StartDate, EndDate, Status, or Priority.
>
> **filter** `object`
>
> MongoDB-style project filter using provider field names and operators such as \$regex, \$in, \$gte, or \$lte.
>
> **page\_size** `integer`
>
> Maximum projects to return in this page (1-500).
>
> **next\_cursor** `string`
>
> Opaque continuation cursor from a previous response. When set, reuse it without changing the search criteria.
>
> #### 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 Tasks
>
> **Slug:** `ITM_PLATFORM_SEARCH_TASKS`
>
> Search tasks across accessible projects and return one page of task summaries with a continuation cursor.
>
> #### Input Parameters
>
> **fields** `array`
>
> Task fields to return, for example Id, ProjectId, Name, StartDate, EndDate, Status, or Priority.
>
> **filter** `object`
>
> MongoDB-style task filter using provider field names, for example ProjectId equality or Name with \$regex.
>
> **page\_size** `integer`
>
> Maximum tasks to return in this page (1-500).
>
> **next\_cursor** `string`
>
> Opaque continuation cursor from a previous response. When set, reuse it without changing the search criteria.
>
> #### 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 Project
>
> **Slug:** `ITM_PLATFORM_UPDATE_PROJECT`
>
> Update selected fields of an existing ITM Platform project and return the provider result. Verify important changes with Get Project.
>
> #### Input Parameters
>
> **name** `string`
>
> New project name.
>
> **type\_id** `integer`
>
> New account-specific project type ID.
>
> **end\_date** `string`
>
> New end date as an ISO 8601 date or date-time. When start\_date is also provided, end\_date must not precede it.
>
> **status\_id** `integer`
>
> New project status ID from List Reference Data.
>
> **project\_id** `integer` *required*
>
> ITM Platform project ID to update.
>
> **start\_date** `string`
>
> New start date as an ISO 8601 date or date-time.
>
> **description** `string`
>
> New project description; ITM Platform may store HTML.
>
> **priority\_id** `integer`
>
> New project priority ID from List Reference Data.
>
> **internal\_code** `string`
>
> New internal project code.
>
> **performing\_unit\_id** `integer`
>
> New account-specific performing unit ID.
>
> **internal\_cost\_center** `string`
>
> New internal cost-center code.
>
> #### 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:** `ITM_PLATFORM_UPDATE_TASK`
>
> Update selected descriptive, scheduling, hierarchy, or custom fields on an existing ITM Platform project task. Verify important changes with Search Tasks.
>
> #### Input Parameters
>
> **name** `string`
>
> New task name.
>
> **details** `string`
>
> New task details.
>
> **task\_id** `integer` *required*
>
> ID of the task to update.
>
> **end\_date** `string`
>
> New end date in YYYY-MM-DD format. When start\_date is also provided, end\_date must not precede it.
>
> **sprint\_id** `string`
>
> New sprint ID, if applicable.
>
> **project\_id** `integer` *required*
>
> ID of the project that owns the task.
>
> **start\_date** `string`
>
> New start date in YYYY-MM-DD format.
>
> **custom\_fields** `array`
>
> Custom-field updates. Each item requires custom\_field\_base\_id, value, and type\_name from the account's custom-field definitions.
>
> **swimlane\_name** `string`
>
> Exact Kanban swimlane name.
>
> **parent\_task\_id** `string`
>
> New parent task ID.
>
> **display\_in\_portfolio** `boolean`
>
> Whether the task appears in portfolio views.
>
> #### 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
