umbraco-media

Manage Umbraco media assets via authenticated create, move, trash, update, and upload operations.

4|Updated Mar 6, 2026
One-click install
npx skills add https://github.com/albanistrefi/umbraco_CLI --skill umbraco-media
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: umbraco-media
Source: https://github.com/albanistrefi/umbraco_CLI/tree/main/skills/cli/umbraco-media
Command: npx skills add https://github.com/albanistrefi/umbraco_CLI --skill umbraco-media

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It eliminates slow, error-prone manual work when you need to list, search, and upload media assets in an Umbraco instance through the Management API.

Core Features & Use Cases

  • Read media efficiently: fetch media by ID, list root or children items, search media, and retrieve URLs while controlling response size with field limiting.
  • Perform safe mutations: create media and folders, move items, trash items, update metadata, and upload files with a validation-first workflow.
  • Run agent-friendly operations: supports JSON-first inputs and a dry-run pattern to validate mutating requests before execution.

Quick Start

Use the umbraco-media skill to upload a file into the correct parent folder by providing the upload file path and the desired media type and parent ID while first running a dry-run to verify the request.

Frequently Asked Questions about umbraco-media

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search and retrieve Umbraco media assets via the Management API?

You can search and retrieve Umbraco media assets by sending JSON-driven requests to the Management API to fetch metadata, URLs, and hierarchy results while using field limiting to control response size.

What is the safest way to upload files to Umbraco media folders?

The safest way to upload files to Umbraco media folders is to use a validation-first workflow with a dry-run pattern, verifying the JSON request payload before executing the authenticated mutation.

Can I perform media management mutations like create, move, and trash without risking unintended changes?

Yes, you can perform safe mutations like create, move, and trash by first running a dry-run validation to check the request payload before applying the actual changes to the Umbraco media assets.

Do I need authentication to manage Umbraco media assets through an agent workflow?

Yes, managing Umbraco media assets requires mandatory authentication via the shared umbraco-shared skill, which provides the necessary global flags and safety rules for the agent workflow.

How does field limiting work when fetching Umbraco media hierarchy results?

Field limiting restricts the response payload size when fetching Umbraco media hierarchy results, allowing agent workflows to retrieve only the necessary metadata and URLs instead of the full asset data.