uip tm project

Syntax and options for `uip tm project`, which manages Test Manager projects as the top-level containers for test cases and sets.

uip tm project manages Test Manager projects on the current tenant. A Test Manager project is the top-level container for test cases, test sets, and executions; every other uip tm verb scopes to a project via --project-key.

Synopsis

uip tm project list [--limit <n>] [--offset <n>]
uip tm project create --name <name> --project-key <key> [--description <text>]
uip tm project update --project-key <key> [--name <name>] [--description <text>]
uip tm project delete --project-key <key> [-y]
uip tm project set-default-folder --project-key <key> --folder-key <uuid>
uip tm project clear-default-folder --project-key <key>
uip tm project owners list [--project-key <key...>]

All verbs honor the global options and the standard exit codes. Every verb accepts --log-level <level> for verbosity (debug, info, warn, error; default Information).

uip tm project list

List every Test Manager project on the current tenant.

Arguments

None.

Options

Flag	Description
--limit <n>	Maximum number of projects to return per page. Defaults to 50.
--offset <n>	Number of results to skip. Defaults to 0.

Example

uip tm project list --limit 20 --offset 0

Data shape

{
  "Code": "ProjectsList",
  "Data": [
    {
      "ProjectKey": "DEMO",
      "Name": "Demo Project",
      "Description": "Smoke tests",
      "Active": true
    }
  ]
}

uip tm project create

Create a new Test Manager project. The project is created as active.

Arguments

None.

Options

Flag	Description
--name <name>	Required. Project name.
--project-key <key>	Required. Project key / prefix (for example, MYPROJ). Test case and test set object keys will be prefixed with this value (for example, MYPROJ:1).
--description <text>	Free-form project description. Defaults to empty.

Example

uip tm project create \
  --name "Demo Project" \
  --project-key DEMO \
  --description "Smoke tests"

Data shape

{
  "Code": "ProjectCreate",
  "Data": {
    "ProjectKey": "DEMO",
    "Id": "a1b2c3d4-0000-0000-0000-000000000001",
    "Name": "Demo Project",
    "Description": "Smoke tests"
  }
}

uip tm project update

Update a project's name or description. Provide at least one of --name or --description.

Arguments

None.

Options

Flag	Description
--project-key <key>	Required. The project to update.
--name <name>	New name. Omit to leave unchanged.
--description <text>	New description. Omit to leave unchanged.

Example

uip tm project update --project-key DEMO --name "Demo Project (2026)"

Data shape

{
  "Code": "ProjectUpdate",
  "Data": {
    "ProjectKey": "DEMO",
    "Id": "a1b2c3d4-0000-0000-0000-000000000001",
    "Name": "Demo Project (2026)",
    "Description": "Smoke tests"
  }
}

uip tm project delete

Delete a Test Manager project by its key. This is unconditional and permanent — all test cases, test sets, and execution history are removed.

Arguments

None.

Options

Flag	Description
--project-key <key>	Required. The project to delete.
-y, --yes	Skip the confirmation prompt. Required in non-interactive environments (CI pipelines, scripts).

Example

uip tm project delete --project-key DEMO --yes

Data shape

{
  "Code": "ProjectDelete",
  "Data": {
    "ProjectKey": "DEMO",
    "Id": "a1b2c3d4-0000-0000-0000-000000000001",
    "Result": "Deleted"
  }
}

uip tm project set-default-folder

Set the default Orchestrator folder for the project. Test sets created afterwards inherit this folder unless overridden.

Arguments

None.

Options

Flag	Description
--project-key <key>	Required. Test Manager project key.
--folder-key <uuid>	Required. Orchestrator folder key (UUID). Get it from uip or folders list.

Example

uip tm project set-default-folder \
  --project-key DEMO \
  --folder-key f0f0f0f0-0000-0000-0000-000000000001

Data shape

{
  "Code": "ProjectSetDefaultFolder",
  "Data": {
    "ProjectKey": "DEMO",
    "FolderKey": "f0f0f0f0-0000-0000-0000-000000000001",
    "Result": "Updated"
  }
}

uip tm project clear-default-folder

Remove the default Orchestrator folder from a project. After clearing, new test sets do not inherit a folder automatically.

Arguments

None.

Options

• --project-key <key> (required) — Test Manager project key.

Example

uip tm project clear-default-folder --project-key DEMO

Data shape

{
  "Code": "ProjectClearDefaultFolder",
  "Data": {
    "ProjectKey": "DEMO",
    "Result": "Cleared"
  }
}

uip tm project owners list

List the owners of one or more Test Manager projects. Accepts one or multiple project keys in a single call.

Arguments

None.

Options

• --project-key <key...> — one or more project keys (space-separated). Omit to list owners across all projects.

Examples

# List owners of a single project
uip tm project owners list --project-key DEMO

# List owners of multiple projects in one call
uip tm project owners list --project-key DEMO MyOtherProject

Data shape

{
  "Code": "ProjectOwnersList",
  "Data": [
    {
      "ProjectKey": "DEMO",
      "ProjectId": "a1b2c3d4-0000-0000-0000-000000000001",
      "Owners": [
        {
          "Identifier": "b2c3d4e5-0000-0000-0000-000000000001",
          "DisplayName": "John Doe",
          "Source": "local"
        }
      ]
    },
    {
      "ProjectKey": "MyOtherProject",
      "ProjectId": "a2b3c4d5-0000-0000-0000-000000000002",
      "Owners": []
    }
  ]
}

Related

• testcases — create test cases inside a project.
• testsets — group test cases into executable suites.

See also

• Test Manager overview
• uip or folders list — source of the folder UUID used by set-default-folder.