+ {{/* Operation Header */}}
+
+
+ {{/* Operation Description */}}
+ {{ with $opDef.description }}
+
+ {{ . | markdownify }}
+
+ {{ end }}
+
+ {{/* Parameters Section */}}
+ {{ $params := $opDef.parameters | default slice }}
+ {{ if gt (len $params) 0 }}
+ {{ partial "api/hugo-native/parameters.html" (dict "parameters" $params "spec" $spec) }}
+ {{ end }}
+
+ {{/* Request Body Section */}}
+ {{ with $opDef.requestBody }}
+ {{ partial "api/hugo-native/request-body.html" (dict "requestBody" . "spec" $spec) }}
+ {{ end }}
+
+ {{/* Responses Section */}}
+ {{ with $opDef.responses }}
+ {{ partial "api/hugo-native/responses.html" (dict "responses" . "spec" $spec) }}
+ {{ end }}
+
+
+
+ {{ $name }}
+ {{ if $required }}
+ required
+ {{ end }}
+ {{ $typeDisplay }}
+
+
+ {{ if $description }}
+
+ {{ $description | markdownify }}
+
+ {{ end }}
+
+ {{/* Show enum values if present */}}
+ {{ if gt (len $enum) 0 }}
+
+ Allowed values:
+ {{ range $i, $val := $enum }}
+ {{ if $i }}, {{ end }}{{ $val }}
+ {{ end }}
+
+ {{ end }}
+
+ {{/* Show default value if present */}}
+ {{ if $default }}
+
+ Default:
+ {{ $default }}
+
+ {{ end }}
+
+
+
Parameters
+
+ {{/* Path Parameters */}}
+ {{ if gt (len $pathParams) 0 }}
+
+
Path parameters
+
+ {{ range $pathParams }}
+ {{ partial "api/hugo-native/parameter-row.html" (dict "param" . "spec" $spec) }}
+ {{ end }}
+
+
+ {{ end }}
+
+ {{/* Query Parameters */}}
+ {{ if gt (len $queryParams) 0 }}
+
+
Query parameters
+
+ {{ range $queryParams }}
+ {{ partial "api/hugo-native/parameter-row.html" (dict "param" . "spec" $spec) }}
+ {{ end }}
+
+
+ {{ end }}
+
+ {{/* Header Parameters */}}
+ {{ if gt (len $headerParams) 0 }}
+
+
Header parameters
+
+ {{ range $headerParams }}
+ {{ partial "api/hugo-native/parameter-row.html" (dict "param" . "spec" $spec) }}
+ {{ end }}
+
+
+ {{ end }}
+
+
+ Request body
+ {{ if $required }}
+ required
+ {{ end }}
+
+
+ {{ if $description }}
+
+ {{ $description | markdownify }}
+
+ {{ end }}
+
+ {{/* Content type indicator */}}
+
+ Content-Type:
+ application/json
+
+
+ {{/* Render schema properties */}}
+ {{ with $resolvedSchema }}
+ {{ partial "api/hugo-native/schema.html" (dict "schema" . "spec" $spec "level" 0) }}
+ {{ end }}
+
+ {{ if gt (len $properties) 0 }}
+
+ {{ range $propName, $propSchema := $properties }}
+ {{ $isRequired := index $requiredMap $propName | default false }}
+ {{ $propType := $propSchema.type | default "string" }}
+ {{ $propDescription := $propSchema.description | default "" }}
+ {{ $propFormat := $propSchema.format | default "" }}
+ {{ $propEnum := $propSchema.enum | default slice }}
+ {{ $propDefault := $propSchema.default }}
+ {{ $propExample := $propSchema.example }}
+
+ {{/* Build type display */}}
+ {{ $typeDisplay := $propType }}
+ {{ if eq $propType "array" }}
+ {{ $itemsType := "object" }}
+ {{ with $propSchema.items }}
+ {{ $itemsType = .type | default "object" }}
+ {{ end }}
+ {{ $typeDisplay = printf "%s[]" $itemsType }}
+ {{ else if $propFormat }}
+ {{ $typeDisplay = printf "%s <%s>" $propType $propFormat }}
+ {{ end }}
+
+
+
+
+ {{ if $propDescription }}
+
+ {{ $propDescription | markdownify }}
+
+ {{ end }}
+
+ {{/* Enum values */}}
+ {{ if gt (len $propEnum) 0 }}
+
+ Allowed:
+ {{ range $i, $val := $propEnum }}
+ {{ if $i }}, {{ end }}{{ $val }}
+ {{ end }}
+
+ {{ end }}
+
+ {{/* Default value */}}
+ {{ if $propDefault }}
+
+ Default:
+ {{ $propDefault }}
+
+ {{ end }}
+
+ {{/* Example value */}}
+ {{ if $propExample }}
+
+ Example:
+ {{ jsonify $propExample }}
+
+ {{ end }}
+
+ {{/* Nested object/array rendering (limit depth to prevent infinite loops) */}}
+ {{ if and (eq $propType "object") (lt $level 2) }}
+ {{ with $propSchema.properties }}
+ {{ partial "api/hugo-native/schema.html" (dict "schema" $propSchema "spec" $spec "level" (add $level 1)) }}
+ {{ end }}
+ {{ else if and (eq $propType "array") (lt $level 2) }}
+ {{ with $propSchema.items }}
+ {{ if isset . "properties" }}
+ {{ partial "api/hugo-native/schema.html" (dict "schema" . "spec" $spec "level" (add $level 1)) }}
+ {{ end }}
+ {{ end }}
+ {{ end }}
+
+ {{ end }}
+
+ {{ end }}
+
+ {{/* Show example at schema level */}}
+ {{ if and $example (eq $level 0) }}
+
+
Example
+
{{ jsonify (dict "indent" " ") $example }}
+
+ {{ end }}
+
+ {{/* Tag Overview/Description */}}
+ {{ if $tagDescription }}
+
+
+ {{ $tagDescription | markdownify }}
+
+
+ {{ end }}
+
+ {{/* Operations List */}}
+
+ {{ range $operations }}
+ {{ partial "api/hugo-native/operation.html" (dict
+ "operation" .
+ "spec" $spec
+ "context" $page
+ ) }}
+ {{ end }}
+
+
+ {{/* Related Guides - displayed at bottom like standard page template */}}
+ {{ if gt (len $tagRelated) 0 }}
+
+ {{ end }}
+