Method jsonResponse

internal/httpapi/outbound.go:22–30

jsonResponse builds an extra OpenAPI response entry for an operation whose handler can return a non-default status with the given body schema. The schema is registered (and reused via $ref) in the API's component registry, so the declared response stays in lockstep with the Go type — no hand-edits t

(bodyType reflect.Type, schemaName, description string)

// to api/openapi.yaml. Used to document the 202 (HITL hold) / 412 / 409 codes
// the typed handlers emit but Huma can't infer from the single DefaultStatus.
func (s *Server) jsonResponse(bodyType reflect.Type, schemaName, description string) *huma.Response {
	schema := s.API.OpenAPI().Components.Schemas.Schema(bodyType, true, schemaName)
	return &huma.Response{
		Description: description,
		Content: map[string]*huma.MediaType{
			"application/json": {Schema: schema},
		},
	}
}

// errorEnvelopeResponse is the generic `default` error response (ErrorEnvelope).
// Huma auto-adds it to every operation, but declaring a custom `Responses` map