umbraco-openapi-client

Generate a type-safe TypeScript OpenAPI client for Umbraco custom APIs.

4|Updated Mar 6, 2026

Search Tags:#typescript #authentication #api #openapi #umbraco #client generation

Ready to run

npx skills add https://github.com/albanist/umbraco_CLI --skill umbraco-openapi-client-albanist

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: umbraco-openapi-client
Source: https://github.com/albanist/umbraco_CLI/tree/main/skills/backend/umbraco-openapi-client
Command: npx skills add https://github.com/albanist/umbraco_CLI --skill umbraco-openapi-client-albanist

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @hey-api/openapi-ts, @hey-api/client-fetch, chalk, node-fetch, and includes scripts (resource) components.

What problem does it solve?

This Skill ensures that your Umbraco backoffice frontend can securely and reliably communicate with custom Umbraco APIs by generating and configuring an OpenAPI client, preventing common 401 Unauthorized errors.

Core Features & Use Cases

Automated Client Generation: Generates type-safe TypeScript clients from your C# API's OpenAPI specification.
Authentication Handling: Automatically configures the client with Umbraco's required bearer token authentication.
Use Case: When developing a new custom API in Umbraco, use this Skill to generate the necessary frontend client code, ensuring seamless and authenticated integration with your new endpoints.

Quick Start

Run the script to generate the OpenAPI client for your custom Umbraco API.

Frequently Asked Questions about umbraco-openapi-client

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

FAQPage Schema

How do I fix 401 Unauthorized errors when calling custom Umbraco APIs from the backoffice frontend?▼

An OpenAPI client for Umbraco generates type-safe TypeScript code from your C# API's Swagger specification. It ensures seamless and authenticated integration by automatically applying the required bearer token, allowing your backoffice frontend to securely communicate with custom endpoints.

How do I generate a type-safe TypeScript client from my Umbraco C# API?▼

Yes, you can use this generated OpenAPI client with custom C# API controllers. It is specifically designed to support custom Umbraco APIs that have Swagger or OpenAPI documentation, generating the necessary frontend client code for seamless endpoint integration.

Do I need Swagger documentation to generate a TypeScript client for Umbraco?▼

This OpenAPI client generation approach uses @hey-api/openapi-ts and @hey-api/client-fetch to produce type-safe TypeScript code. It specifically resolves Umbraco backoffice authentication context issues, distinguishing it from generic client generators that do not configure required bearer tokens.

What dependencies are required to configure an OpenAPI client for Umbraco?▼

To configure an OpenAPI client for Umbraco, the required dependencies include @hey-api/openapi-ts and @hey-api/client-fetch for client generation, along with chalk and node-fetch. These packages support the generation scripts and entry point configuration for authentication context.