Skip to main content
ITM Platform logo
  • Category: project management
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 10
  • Triggers: 0
  • Slug: ITM_PLATFORM
  • Version: 00000000_00

Tools

Slug: ITM_PLATFORM_AGGREGATE_DATAMART_COMPONENTSRun a bounded read-only DataMart aggregation over project and service records for portfolio analytics.

Input Parameters

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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ITM_PLATFORM_CREATE_PROJECTCreate 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

string
required
Project name.
integer
Account-specific project type ID; retrieve reference data rather than guessing.
string
Project end date as an ISO 8601 date or date-time; must not precede start_date.
integer
Account-specific project status ID from List Reference Data.
string
Project start date as an ISO 8601 date or date-time.
string
Project description; ITM Platform may store HTML.
integer
Account-specific project priority ID from List Reference Data.
string
Internal project code.
boolean
Whether to create the project with Kanban behavior enabled.
integer
Account-specific organizational unit responsible for the project.
string
Internal cost-center code.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ITM_PLATFORM_CREATE_TASKCreate a task in an ITM Platform project using account-defined type, priority, and status names.

Input Parameters

string
required
Task name.
string
Task details or acceptance notes.
string
Task end date in YYYY-MM-DD format; must not precede start_date.
string
Sprint ID to assign, if the project uses sprints.
string
Exact account-defined task type name from List Reference Data.
integer
required
Project ID that will own the task.
string
Task start date in YYYY-MM-DD format.
string
Exact account-defined task status name from List Reference Data.
string
Exact account-defined task priority name from List Reference Data.
string
Exact Kanban swimlane name for the new task.
string
Parent task ID when creating a child task.
boolean
Whether the task should appear in portfolio views.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ITM_PLATFORM_GET_PROJECTReturn the full current details of one project by its ITM Platform project ID.

Input Parameters

integer
required
ITM Platform project ID returned by Search Projects or Create Project.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ITM_PLATFORM_LIST_REFERENCE_DATAList account-defined project or task statuses, priorities, or types needed to form valid project and task mutations.

Input Parameters

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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ITM_PLATFORM_SEARCH_DATAMART_COMPONENTSSearch the read-only DataMart for project or service analytics records and return one offset-paginated page.

Input Parameters

object
MongoDB-style sort map from field names to 1 for ascending or -1 for descending order.
integer
Maximum DataMart components in this page (1-200).
object
MongoDB-style DataMart filter over component fields, for example componentType or nested task fields.
object
MongoDB-style projection selecting only needed fields. Use dot notation for nested arrays, such as tasks.name, instead of selecting whole arrays.
string
Opaque continuation cursor from a previous response. When set, reuse it without changing the query criteria.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ITM_PLATFORM_SEARCH_PROJECTSSearch projects by account-specific filters and return one page of project summaries with a continuation cursor.

Input Parameters

array
Project fields to return, for example Id, Name, StartDate, EndDate, Status, or Priority.
object
MongoDB-style project filter using provider field names and operators such as $regex, $in, $gte, or $lte.
integer
Maximum projects to return in this page (1-500).
string
Opaque continuation cursor from a previous response. When set, reuse it without changing the search criteria.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ITM_PLATFORM_SEARCH_TASKSSearch tasks across accessible projects and return one page of task summaries with a continuation cursor.

Input Parameters

array
Task fields to return, for example Id, ProjectId, Name, StartDate, EndDate, Status, or Priority.
object
MongoDB-style task filter using provider field names, for example ProjectId equality or Name with $regex.
integer
Maximum tasks to return in this page (1-500).
string
Opaque continuation cursor from a previous response. When set, reuse it without changing the search criteria.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ITM_PLATFORM_UPDATE_PROJECTUpdate selected fields of an existing ITM Platform project and return the provider result. Verify important changes with Get Project.

Input Parameters

string
New project name.
integer
New account-specific project type ID.
string
New end date as an ISO 8601 date or date-time. When start_date is also provided, end_date must not precede it.
integer
New project status ID from List Reference Data.
integer
required
ITM Platform project ID to update.
string
New start date as an ISO 8601 date or date-time.
string
New project description; ITM Platform may store HTML.
integer
New project priority ID from List Reference Data.
string
New internal project code.
integer
New account-specific performing unit ID.
string
New internal cost-center code.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ITM_PLATFORM_UPDATE_TASKUpdate selected descriptive, scheduling, hierarchy, or custom fields on an existing ITM Platform project task. Verify important changes with Search Tasks.

Input Parameters

string
New task name.
string
New task details.
integer
required
ID of the task to update.
string
New end date in YYYY-MM-DD format. When start_date is also provided, end_date must not precede it.
string
New sprint ID, if applicable.
integer
required
ID of the project that owns the task.
string
New start date in YYYY-MM-DD format.
array
Custom-field updates. Each item requires custom_field_base_id, value, and type_name from the account’s custom-field definitions.
string
Exact Kanban swimlane name.
string
New parent task ID.
boolean
Whether the task appears in portfolio views.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not