uip ah applications, components, documents, media, store-listings, store-reviews

Syntax and options for the Automation Hub application inventory, reusable components, attached documents/media, and the Automation Store marketplace (published listings and reviews).

The application inventory is what automations are tagged against (--application-id filters elsewhere reference it). Components are reusable building blocks, optionally scoped to one automation. Documents and media are files attached to an automation — a PDD, a screenshot, a demo video. The Automation Store is Automation Hub's internal marketplace: store-listings are published automations, store-reviews are the reviews left on them. See uip ah for shared concepts (projection/--all-fields, paged vs. unpaged lists) that apply to every verb here.

uip ah applications

Manage the application inventory that automations are tagged against.

概要

uip ah applications list [--search <text>] [--category-id <id...>] [--limit <n>] [--offset <n>] [--all-fields]
uip ah applications update --file <json-file>
uip ah applications delete <application-id> [-y, --yes]

uip ah applications list

オプション

長押し	値 (Value)	説明
--search <text>	string	Free-text search.
--category-id <id...>	repeatable	Only applications in these categories.
--limit <n> / --offset <n>	integer	Paging. Default --limit 20.
--all-fields	フラグ	Return the raw payload.

例

uip ah applications list

データシェイプ(--output json)

{
  "Code": "AhApplicationsList",
  "Data": [
    { "Id": 1, "Name": "SAP", "Version": "S/4HANA", "Language": null, "Code": "SAP", "IsActive": 1, "AddedByEndUser": 0, "CategoryIds": [4], "CreatedEpoch": 1735689600000 }
  ],
  "Pagination": { "Returned": 1, "Limit": 20, "Offset": 0 }
}

uip ah applications update

Update existing applications in the inventory from a file. This edits entries that already exist — it cannot add one, because the service requires an application_id on every element.

オプション

長押し	値 (Value)	Required	説明
--file <json-file>	パス	○	JSON array of applications to update. Each element needs application_id and categoryIds — take the shape from applications list --all-fields.

例

uip ah applications update --file ./applications.json

データシェイプ(--output json)

{ "Code": "AhApplicationsUpdate", "Data": { "Status": "Updated" } }

uip ah applications delete

引数

名前	Required	目的
<application-id>	○	Application id.

オプション

長押し	説明
-y, --yes	Confirm this irreversible operation. Required — the CLI never prompts.

例

uip ah applications delete 7 --yes

データシェイプ(--output json)

{ "Code": "AhApplicationsDelete", "Data": { "Id": 7, "Status": "Deleted" } }

uip ah components

Read reusable components, tenant-wide or per automation. Read-only — there is no create/update/delete on this surface.

uip ah components list

オプション

長押し	値 (Value)	説明
--automation-id <id>	integer	Scope to the components attached to this automation — a separate endpoint that takes no other filters.
--type <type>	string	Only this component type. Cannot combine with --automation-id.
--category-id <id...>	repeatable	Only these categories. Cannot combine with --automation-id.
--application-id <id...>	repeatable	Only components using these applications. Cannot combine with --automation-id.
--limit <n> / --offset <n>	integer	Paging. Default --limit 20.
--all-fields	フラグ	Return the raw payload.

--type/--category-id/--application-id combined with --automation-id fails client-side — the per-automation list is a different endpoint that takes no filters.

例

uip ah components list

uip ah components list --automation-id 20

データシェイプ(--output json)

{
  "Code": "AhComponentsList",
  "Data": [
    { "Id": 3, "Name": "Invoice parser", "Slug": "invoice-parser", "Description": "...", "TypeId": 1, "ReviewCount": 4, "ReviewAverage": 4.5, "DownloadCount": 12, "StatusId": 1, "PhaseId": 3, "UpdatedEpoch": 1738368000000 }
  ],
  "Pagination": { "Returned": 1, "Limit": 20, "Offset": 0 }
}

uip ah documents

Manage the documents attached to an automation.

uip ah documents list

引数

名前	Required	目的
<automation-id>	○	Automation id.

オプション

長押し	説明
--limit <n> / --offset <n>	Paging. Default --limit 20.
--all-fields	Return the raw payload.

例

uip ah documents list 20

データシェイプ(--output json)

{
  "Code": "AhDocumentsList",
  "Data": [
    { "Id": 11, "AutomationId": 20, "Title": "PDD", "Description": "...", "TypeId": 1, "FileId": 42, "FileType": "docx", "EmbedLink": null, "IsActive": 1, "CreatedEpoch": 1735689600000 }
  ],
  "Pagination": { "Returned": 1, "Limit": 20, "Offset": 0 }
}

FileId is what documents download takes.

uip ah documents create

Attach a document to an automation — upload the file's bytes with --file, or link to it with --embed-link (exactly one of the two).

引数

名前	Required	目的
<automation-id>	○	Automation id.

オプション

長押し	値 (Value)	Required	説明
--title <text>	string	○	Document title.
--description <text>	string	○	Document description.
--document-type-id <id>	integer	○	Document type id.
--file <path>	パス	conditionally	Local document file to upload. Exactly one of --file/--embed-link is required. No server-side mimetype allowlist — unrecognized extensions upload as application/octet-stream.
--embed-link <url>	url	conditionally	Link to an already-hosted document. Exactly one of --file/--embed-link is required.
--submitter <email>	メール アドレス	×	Email of the submitting Automation Hub user. Defaults to the caller.

例

uip ah documents create 20 --title "Process definition" --description "PDD v2" --document-type-id 1 --file ./pdd.docx

uip ah documents create 20 --title "Process definition" --description "PDD v2" --document-type-id 1 --embed-link https://acme.sharepoint.com/pdd.docx

データシェイプ(--output json)

{ "Code": "AhDocumentsCreate", "Data": { "AutomationId": 20, "Id": 11, "Title": "Process definition", "FileId": 42, "File": "pdd.docx" } }

With --embed-link, Data carries EmbedLink instead of FileId/File.

uip ah documents download

引数

名前	Required	目的
<file-id>	○	File id — the FileId from documents list <automation-id>.

オプション

長押し	値 (Value)	Required	説明
--destination <path>	パス	○	Local path to write the file to.

例

uip ah documents download 42 --destination ./pdd.pdf

データシェイプ(--output json)

{ "Code": "AhDocumentsDownload", "Data": { "FileId": 42, "Destination": "./pdd.pdf", "Bytes": 20481, "ContentType": "application/pdf" } }

uip ah media

Attach media (screenshots, video) to an automation. Separate from documents — its own upload endpoint, and there's no list or delete.

uip ah media create

引数

名前	Required	目的
<automation-id>	○	Automation id.

オプション

長押し	値 (Value)	Required	説明
--file <path>	パス	○	Local media file to upload — jpg, jpeg, png, gif, or mp4 only; any other extension is rejected client-side.
--submitter <email>	メール アドレス	×	Email of the submitting Automation Hub user. Defaults to the caller.

例

uip ah media create 20 --file ./screen.png

データシェイプ(--output json)

{ "Code": "AhMediaCreate", "Data": { "Id": 7, "MediaFileId": 501, "AutomationId": 20, "File": "screen.png" } }

uip ah store-listings

Read the automations published to the Automation Store. Read-only.

uip ah store-listings list

オプション

長押し	値 (Value)	説明
--search <text>	string	Free-text search.
--category-id <id...>	repeatable	Only these categories.
--application-id <id...>	repeatable	Only listings using these applications.
--business-unit <name>	string	Only this business unit.
--plain-text	フラグ	Convert rich-text fields to plain text.
--limit <n> / --offset <n>	integer	Paging. Default --limit 20.
--all-fields	フラグ	Return the raw payload.

例

uip ah store-listings list

データシェイプ(--output json)

{
  "Code": "AhStoreListingsList",
  "Data": [
    { "Id": 20, "Name": "Invoice intake", "Slug": "invoice-intake", "ReviewCount": 4, "ReviewScore": 4.2, "DownloadCount": 4, "VoteCount": 9, "IsPublished": 1, "BusinessUnit": "EMEA", "UpdatedEpoch": 1738368000000 }
  ],
  "Pagination": { "Returned": 1, "Limit": 20, "Offset": 0 }
}

uip ah store-reviews

Read the Automation Store reviews on an automation. Its own resource group rather than a verb under store-listings. Read-only.

uip ah store-reviews list

引数

名前	Required	目的
<automation-id>	○	Automation id — must be published to the store.

オプション

長押し	説明
--limit <n> / --offset <n>	Paging. Default --limit 20.
--all-fields	Return the raw payload.

例

uip ah store-reviews list 20

データシェイプ(--output json)

{
  "Code": "AhStoreReviewsList",
  "Data": [
    { "Id": 5, "AutomationId": 20, "Score": 5, "Title": "Great automation", "Description": "...", "UserId": 3, "CreatedEpoch": 1735689600000 }
  ],
  "Pagination": { "Returned": 1, "Limit": 20, "Offset": 0 }
}

関連

• uip ah — overview, concepts, audit-logs, auth-info.
• Automations, idea-flows, business-cases, phases, questionnaires, pipelines
• Categories, tags, collaborators, roles, users

参照

• ツール (プラグイン)
• グローバル オプション
• 終了コード