skills.rest
Rust-soham
Rust-sohamCOMMUNITY
Explore all skills by this author →
GitHub

golem-configure-api-domain

Configure HTTP API domain deployments and authentication in golem.yaml.

Updated May 17, 2026
Search Tags:#openapi#http api#agent authentication#golem.yaml#domain deployment#oidc security#webhook configuration
One-click install
npx skills add https://github.com/Rust-soham/golem-claw --skill golem-configure-api-domain-rust-soham
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: golem-configure-api-domain
Source: https://github.com/Rust-soham/golem-claw/tree/main/packages/golem/.agents/skills/golem-configure-api-domain
Command: npx skills add https://github.com/Rust-soham/golem-claw --skill golem-configure-api-domain-rust-soham

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It solves the challenge of correctly exposing agent endpoints on a domain and securing them with the right authentication settings in your golem.yaml.

Core Features & Use Cases

  • HTTP API domain deployment setup: Configure httpApi.deployments per environment with domain binding and agent exposure.
  • Security scheme management for OIDC: Create and reference OIDC security schemes (including common providers and custom OIDC).
  • Development authentication via test session headers: Use testSessionHeaderName to simulate an OIDC session without a real identity provider.
  • Operational readiness: Automatically serves OpenAPI at /openapi.yaml for all deployed endpoints on a domain.

Quick Start

Update your root golem.yaml by adding an httpApi deployments entry for your environment and set the target agent’s securityScheme (or testSessionHeaderName for development), then run golem deploy --yes to apply the changes.

Frequently Asked Questions about golem-configure-api-domain

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

FAQPage Schema
How do I configure an HTTP API domain deployment for my agents in golem.yaml?▼

To configure HTTP API domain deployment in golem.yaml, define httpApi.deployments by environment, map agent names in PascalCase to per-agent options, and run golem deploy --yes to apply the changes.

What is the best way to secure agent endpoints with OIDC in golem.yaml?▼

The best way to secure agent endpoints with OIDC is to create and reference a named securityScheme in golem.yaml and wire it to the target agent within the httpApi.deployments configuration.

Can I simulate OIDC authentication during local development without a real identity provider?▼

Yes, you can simulate OIDC authentication during local development by wiring a JSON-backed testSessionHeaderName to the agent's per-agent options, simulating an OIDC session without a real identity provider.

Does deploying an HTTP API domain in golem.yaml generate an OpenAPI specification?▼

Yes, deploying an HTTP API domain automatically serves the OpenAPI specification at the /openapi.yaml endpoint for all deployed agent endpoints on that domain, which you can use for operational validation.

How do I expose different agents across local, staging, and production environments?▼

To expose different agents across local, staging, and production environments, define separate httpApi.deployments entries in golem.yaml for each environment with specific domain binding and per-agent security options.

Related Skills

Explore More Software Engineering Skills→
justcoonjustcoon
1

golem-configure-api-domain

Configure API domain deployments and security schemes in golem.yaml files.

Community
Intermediate
CarbeneAICarbeneAI
9

setup-deploy

Detect deployment platforms and write Deploy Configuration sections to CLAUDE.md.

Community
Intermediate
Rust-sohamRust-soham

golem-add-http-auth-ts

Adds authentication to TypeScript HTTP endpoints via decorator flags and golem.yaml security schemes.

Community
Intermediate
KenTaniguchi-RKenTaniguchi-R

Pier CLI Tool Management

Add, edit, and remove Pier CLI tools via conversational prompts.

Community
Intermediate