skills.rest
albanist
albanistCOMMUNITY
Explore all skills by this author →
GitHub

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
One-click install
npx skills add https://github.com/albanist/umbraco_CLI --skill umbraco-openapi-client-albanist
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
umbracoumbraco
26

umbraco-openapi-client

Generate an OpenAPI client with bearer token authentication for Umbraco backoffice APIs.

Official
Advanced
1k-off1k-off
1

umbraco-openapi-client

Configure a generated OpenAPI TypeScript client with Umbraco bearer-token authentication.

Community
Intermediate
albanistrefialbanistrefi
4

umbraco-openapi-client

Generate an authenticated TypeScript OpenAPI client for Umbraco backoffice APIs.

Community
Intermediate
kraftvaerkkraftvaerk

umbraco-openapi-client

Sets up authenticated OpenAPI clients for Umbraco backoffice frontend integrations.

Official
Intermediate