get_project_area

Edit online

Fetches project area details from IBM Engineering Lifecycle Management (ELM), including team areas, timelines, and iterations, with support for UUID or name-based search.

Purpose

This tool retrieves comprehensive project area information from IBM ELM applications (CCM, RM, or QM). You can search by project area UUID or by name using wildcard matching. If multiple projects match the name, the tool returns a list to choose from. Optionally include hierarchical team areas, timelines, and iterations in the response.

Tags: CCM | QM | RM | | Read | Basic

The tool supports two search methods:

  • By project area UUID: Direct lookup using the project's unique identifier (starts with underscore)
  • By name: Text-based search with automatic wildcard matching (minimum 3 characters)

You must provide either project_area_uuid OR name, but not both.

Input parameters

Name Type Required Default
app_type string Yes -
project_area_uuid string No None
name string No None
include_team_areas boolean No False
include_timelines boolean No False

Output schema

Field Type Description
name string Name of the project area
project_area_uuid string Unique identifier for the project area (starts with underscore)
summary string Brief summary of the project area
description string Detailed description of the project area
team_areas array List of team areas within the project (optional, included when include_team_areas=true)
team_areas[].name string Name of the team area
team_areas[].team_area_uuid string Unique identifier for the team area
team_areas[].children array Nested child team areas (recursive structure)
timelines array List of timelines in the project (optional, included when include_timelines=true)
timelines[].id string Timeline identifier
timelines[].label string Display label for the timeline
timelines[].timeline_uuid string Unique identifier for the timeline
timelines[].iterations array List of iterations within the timeline
timelines[].iterations[].id string Iteration identifier
timelines[].iterations[].label string Display label for the iteration
timelines[].iterations[].iteration_uuid string Unique identifier for the iteration
timelines[].iterations[].start_date string or null

String
timelines[].iterations[].end_date string or null String
timelines[].iterations[].children array Nested child iterations (recursive structure)

Common use cases

  • Retrieving project area UUID for subsequent operations
  • Validating project existence before creating work items
  • Listing team areas for assignment or filtering
  • Accessing timeline and iteration information for planning
  • Building project selection interfaces
  • Generating project structure reports
  • Understanding project organization and hierarchy
  • Searching for projects by partial name