uip ah

Manage Automation Hub automation ideas, pipeline, taxonomy, marketplace, and users using the `uip ah` tool.

uip ah is the Automation Hub tool (command prefix ah, package @uipath/automation-hub-tool): it manages the automation-idea pipeline — ideas submitted through an assessment, moved through configurable phases, scored, and tracked to delivery — plus the taxonomy, collaboration, and marketplace surfaces around it. Install it with uip tools install ah, or invoke uip ah … and let auto-install run. See Tools (plugins) for the install model.

Conceptos

• Every write is a full-record replace, not a patch. automations update, categories update, users update, and tags set all send Automation Hub's complete record shape — fields you don't pass are carried over from what's already stored (or, for categories update/tags set, the whole collection is replaced outright). Check each verb's own notes for exactly what's preserved vs. overwritten.
• --all-fields on every read command. A raw Automation Hub record carries roughly 300 keys, including a __display pre-formatted twin for most of them. Every list/get command projects down to a manageable field set by default; pass --all-fields for the untouched payload.
• Paged vs. unpaged endpoints. Most list commands hit a paged Automation Hub endpoint and accept --limit/--offset normally. A few endpoints (roles, idea-flows, questionnaires list, audit-logs list, collaborators list) return their entire collection in one call with no server-side paging — --limit/--offset are applied client-side on these, after the full set is fetched.
• IDs come from other list commands, not from the UI. Automation Hub's web UI doesn't expose most of the numeric IDs this CLI takes (category IDs, phase-status IDs, role IDs) — find them with the corresponding list --all-fields command, as each verb's own error messages point out.
• Errors specific to this tool: a 403 means "not visible to your Automation Hub role," never "not found" — Automation Hub doesn't use 404 for out-of-scope records. A 500-class "Automation Hub is not provisioned on this tenant" or "no tenant record of its own yet" response surfaces as Result: "ConfigError" with tenant-onboarding instructions, distinct from an authentication failure.

Recursos

Cada recurso tiene su propia página de referencia. El verbo establecido en cada página coincide con los comandos registrados por uip ah — ejecuta uip ah --help para confirmar la superficie completa en tu instalación.

Recurso	Propósito
automations, idea-flows, business-cases, phases, questionnaires, pipelines	The core idea-to-delivery lifecycle: submit and read automation ideas, discover phase/status transitions, read cost-benefit analyses, move ideas through phases, read the assessment question catalogue, and read the benefit-ranked pipeline view.
applications, components, documents, media, store-listings, store-reviews	The application inventory automations are tagged against, reusable components, attached documents and media, and the Automation Store marketplace (published listings and their reviews).
categories, tags, collaborators, roles, users	The category taxonomy, free-text tags, per-automation collaborators and their roles, the assignable role catalogue, and Automation Hub user accounts.
audit-logs, auth-info	Covered below on this page — small, cross-cutting utility resources.

uip ah audit-logs

Read the Automation Hub audit trail. Automation Hub groups the trail into weekly CSV bundles rather than a flat log.

uip ah audit-logs list

List audit-log bundles for a date range.

Opciones

Largo	Valor	Descripción
--start-date <date>	YYYY-MM-DD	Start of the range.
--end-date <date>	YYYY-MM-DD	End of the range.
--limit <n>	Entero	Maximum number of bundles to return. Default 20.
--offset <n>	Entero	Number of bundles to skip. Default 0.
--all-fields	Marca	Return the raw payload instead of the projected Name/EntryCount fields.

Unpaged endpoint — the whole collection for the date range is fetched, then windowed client-side. An empty trail (a 404 "No audit log was found") is folded into an empty Data array rather than surfaced as an error.

Ejemplo

uip ah audit-logs list --start-date 2026-07-01 --end-date 2026-08-04

Forma de datos (--json de salida)

{
  "Code": "AhAuditLogsList",
  "Data": [
    { "Name": "tenant-service-audit-log-(2026-08-02)-to-(2026-08-08).csv", "EntryCount": 12 }
  ]
}

A bundle backed by an object-reference blob instead of inline entries returns Uri (the value download --uri takes) in place of EntryCount.

uip ah audit-logs download

Save one audit-log bundle as a local CSV file.

Opciones

Largo	Valor	Obligatorio	Descripción
--uri <name>	String	Sí	Bundle name, exactly as the Name field from audit-logs list.
--destination <path>	Ruta	Sí	Local path to write the CSV to.

Ejemplo

uip ah audit-logs download --uri <name> --destination ./audit.csv

Forma de datos (--json de salida)

{ "Code": "AhAuditLogsDownload", "Data": { "Destination": "./audit.csv", "Bytes": 4096, "Rows": 20 } }

uip ah auth-info

Singular mass-noun resource — there is exactly one identity per session, so there is nothing to list.

uip ah auth-info get

Show the Automation Hub tenant and your identity in it — the quickest check that Automation Hub is enabled and onboarded for the active tenant.

Opciones

Largo	Descripción
--all-fields	Return the raw payload instead of the summarized Type/Tenant/User fields.

Ejemplo

uip ah auth-info get

Forma de datos (--json de salida)

{
  "Code": "AhAuthInfoGet",
  "Data": {
    "Type": "automation-cloud",
    "Tenant": { "Uuid": "...", "CompanyName": "acme - finance", "Url": "..." },
    "User": {
      "Id": 3, "Email": "[e-mail]", "FirstName": "Jane", "LastName": "Doe",
      "JobTitle": "Analyst", "Department": "Finance", "BusinessUnit": "EMEA",
      "IsAdmin": 1, "IsActive": 1, "Roles": ["ah-system-admin"]
    }
  }
}

Sinopsis

uip ah audit-logs list [--start-date <date>] [--end-date <date>] [--limit <n>] [--offset <n>] [--all-fields]
uip ah audit-logs download --uri <name> --destination <path>
uip ah auth-info get [--all-fields]

See automations, idea-flows, business-cases, phases, questionnaires, pipelines, applications, components, documents, media, store-listings, store-reviews, and categories, tags, collaborators, roles, users for the rest of the command surface.

Ver también

• Herramientas (complementos)
• Herramientas de UIP
• Opciones globales
• Códigos de salida