uip tm project

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 [--filter <text>]
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>
uip tm project set-default-folder --project-key <key> --folder-key <uuid>
uip tm project clear-default-folder --project-key <key>

All verbs honor the global options and the standard exit codes. Every verb accepts -t, --tenant <name> to target a tenant other than the one in the active session, and --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:

• --filter <text> — filter projects by name (server-side search).

示例：

uip tm project list --filter demo

Data shape (--output json):

{
  "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:

• --name <name> (required) — project name.
• --project-key <key> (required) — project key / prefix (e.g. MYPROJ). Test case and test set object keys will be prefixed with this value (e.g. MYPROJ:1).
• --description <text> — free-form project description. Defaults to empty.

示例：

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:

• --project-key <key> (required) — the project to update.
• --name <name> — new name. Omit to leave unchanged.
• --description <text> — new description. Omit to leave unchanged.

示例：

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:

• --project-key <key> (required) — the project to delete.

示例：

uip tm project delete --project-key DEMO

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:

• --project-key <key> (required) — Test Manager project key.
• --folder-key <uuid> (required) — Orchestrator folder key (UUID). Get it from uip or folders list.

示例：

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. New test sets will no longer inherit a folder.

Arguments: none.

Options:

• --project-key <key> (required) — the project to clear.

示例：

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

Data shape:

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

Related

• testcase — create test cases inside a project.
• testset — group test cases into executable suites.

另请参阅

• Test Manager overview — where project fits in the full flow.
• Authentication — how -t, --tenant resolves.
• uip or folders list — source of the folder UUID used by set-default-folder.