# uip aops

> Manage UiPath StudioAdmin AOps — SourceControl connections, repositories, automation projects, solutions, CI/CD pipelines, and pipeline executions — using the `uip aops` tool.

`uip aops` manages **StudioAdmin AOps** (Automation Ops) — the automation-inventory and CI/CD layer that sits on top of your source-control repositories. A **connection** links a tenant to a Git provider (GitHub or Azure DevOps); AOps discovers **repositories**, **automation projects**, and **Studio solutions** through that connection; a **pipeline** defines a CI/CD build/run configuration for a project; each pipeline run produces an **execution** you can inspect or stop.

This is a discovery-and-CI/CD tool, not an authoring one — `uip aops` never edits your project source. Connections themselves are provisioned through the StudioAdmin UI; this CLI consumes already-provisioned connections by identifier.

## This resource spans four pages

- **This page** — concepts and the shared pagination convention.
- [`connections`](./uip-aops-connections.md) — `connection` (sync/inspect a SourceControl connection, discover its repos/projects/solutions) and `repo` (inspect one repository's branches and project files).
- [`projects`](./uip-aops-projects.md) — `project` (inspect one automation project's files, content, and commit history) and `solution` (the same for a Studio solution).
- [`pipelines`](./uip-aops-pipelines.md) — `pipeline` (CRUD + run a CI/CD pipeline) and `execution` (inspect/stream logs/stop a pipeline run).

## Concepts

- **Two backing services, two SDKs.** `connection`, `repo`, `project`, and `solution` call the **SourceControl (SC) service** (`@uipath/sc-sdk`). `pipeline` and `execution` call the **CICD service** (`@uipath/cicd-sdk`). They're independent identifier namespaces — a connection id is never a pipeline id, and so on.
- **Typical flow**: `connection list` (find a connection) → `connection sync --wait` (refresh it) → `connection projects <id>` / `connection repos <id>` (discover what's in it) → `pipeline create --file` (define a CI/CD pipeline against a discovered process) → `pipeline run` or `pipeline save-and-run` → `execution logs --follow` (watch it to completion).
- **Pagination convention.** Every paginated list verb accepts `--offset`/`--limit` (page-based: `--offset` must be a multiple of `--limit`, or the command fails client-side before any network call). Defaults vary per verb — documented on each sibling page.
- **`--login-validity <minutes>`** is available on every verb across all six command groups — overrides the interactive-login token lifetime for that one call. Rarely needed.
- **Destructive operations require `-y, --yes`.** `connection delete` and `pipeline delete` both fail immediately without it — this CLI never prompts interactively.
- **Fan-out degrades, it doesn't fail outright.** `project list` (the cross-connection aggregator) queries every visible connection in parallel; if some connections can't be read, the reachable projects are still returned with a `Warning` naming which connections were skipped. Only an all-connections failure is a hard error.

## Synopsis

```text
uip aops connection list
uip aops connection state [--connection <id>]
uip aops connection sync [connection-id] [--wait] [--timeout <ms>] [--poll-interval <ms>]
uip aops connection delete <connection-id> -y
uip aops connection repos <connection-id> [--azure-projects-ids <csv>] [--organization-identifier <name>]
uip aops connection repos-bulk --ids <csv>
uip aops connection projects <connection-id> [--repository-ids <csv>] [--target-framework <name>] [--project-type <type>] [--sort-by <field>] [--sort-order <asc|desc>] [--offset <n>] [--limit <n>] [--search <term>]
uip aops connection solutions <connection-id> [--offset <n>] [--limit <n>] [--search <term>]
uip aops connection azure-projects <connection-id> [--organization-identifier <name>]

uip aops repo branches <repo-id>
uip aops repo project-files <repo-id> [--reference <ref>]

uip aops project list [--connections <csv>] [--target-framework <name>] [--project-type <type>] [--offset <n>] [--limit <n>] [--search <term>]
uip aops project get --project-id <id> [--reference <ref>] [--with-branches]
uip aops project files --project-id <id> [--path <path>] [--reference <ref>]
uip aops project content --project-id <id> --path <path> [--reference <ref>]
uip aops project commits --project-id <id> [--path <path>] [--branch <name>] [--offset <n>] [--limit <n>] [--search <term>]
uip aops project commit --project-id <id> --reference <sha>

uip aops solution get <solution-id>
uip aops solution commits <solution-id> [--path <path>] [--branch <name>] [--offset <n>] [--limit <n>] [--search <term>]

uip aops pipeline list [--repository-ids <csv>] [--offset <n>] [--limit <n>] [--search <term>]
uip aops pipeline state
uip aops pipeline processes
uip aops pipeline process <process-id>
uip aops pipeline repos
uip aops pipeline get <pipeline-id> [--for-update] [--output-file <path>]
uip aops pipeline search [--name <name> | --prefix <prefix>]
uip aops pipeline create --file <path> [--telemetry-flow-id <id>]
uip aops pipeline update <pipeline-id> --file <path>
uip aops pipeline delete <pipeline-id> -y
uip aops pipeline run <pipeline-id>
uip aops pipeline save-and-run --file <path> [--telemetry-flow-id <id>]
uip aops pipeline executions <pipeline-id> [--offset <n>] [--limit <n>]
uip aops pipeline executions-bulk --ids <csv>

uip aops execution get <execution-id> [--with-arguments]
uip aops execution logs [execution-id] [--job-key <key>] [--follow] [--limit <n>] [--poll-interval <ms>] [--timeout <ms>]
uip aops execution details [execution-id] [--job-key <key>]
uip aops execution stop [execution-id] [--job-key <key>] [--wait] [--poll-interval <ms>] [--timeout <ms>]
```

## Related

- [`connections`](./uip-aops-connections.md) — SourceControl connections and repositories.
- [`projects`](./uip-aops-projects.md) — automation projects and Studio solutions.
- [`pipelines`](./uip-aops-pipelines.md) — CI/CD pipelines and executions.

## See also

- [Global options](./global-options.md)
- [Exit codes](./exit-codes.md)
- [Tools (plugins)](./concepts-tools.md)