Configuring HTTP API domain deployments and security schemes in golem.yaml. Use when the user asks to deploy agents to a domain, configure API domains, set up authentication/security schemes (OIDC), or manage the httpApi section of the application manifest.
After adding HTTP mounts and endpoints to agents in code, you must configure a domain deployment in golem.yaml so Golem knows which agents to expose and on which domain. This skill covers the httpApi manifest section, security scheme setup, and the auto-generated OpenAPI specification.
Add an httpApi section to the root golem.yaml:
httpApi:
deployments:
local:
- domain: my-app.localhost:9006
agents:
TaskAgent: {}
UserAgent: {}
httpApi.deployments is a map keyed by environment name (e.g., , , )localstagingproddomain: the (sub)domain to bind to (e.g., my-app.localhost:9006 for local development)agents: a map of agent type names (PascalCase) to their deployment optionswebhookUrl (optional): base URL for webhook callbacksEach agent entry accepts these optional fields: