Skip to main content

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

Example:

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.

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:

  • --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:

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

Example:

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.

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

Arguments: none.

Options:

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

Example:

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

Data shape:

{
  "Code": "ProjectClearDefaultFolder",
  "Data": {
    "ProjectKey": "DEMO",
    "Result": "Cleared"
  }
}
  • testcases — create test cases inside a project.
  • testsets — group test cases into executable suites.

See also​