---
title: "Get section"
method: GET
path: "/documents/sections/{sectionID}"
tags: ["Guided Sections"]
---

# Get section

`GET /documents/sections/{sectionID}`

Returns the section with its published version fully resolved (inheritance chain walked
to fill missing fields). To see raw authored values without inheritance, use
GET /documents/sections/{sectionID}/versions/{versionID}.

## Response `200`

OK

- GuidedSection — Section metadata as returned by the LIST /documents/sections endpoint. Does not include the resolved `publishedVersion` — use GET /documents/sections/{sectionID} to fetch a single section with its published version resolved.
  - `id` string, uuid, required — The UUID of the section.
  - `inheritedFromId` string, uuid, nullable — Reference to the section to inherit generation configuration from. Inherits from published version by default.
  - `autoGenerated` boolean — True if the section was auto-generated as part of an inline section-composed POST /documents request.
  - `source` 'user' | 'corti' | 'project' — Whether this section was created by the user, a project-related API Client or is a Corti standard resource.
  - `name` string, required — The name of the section.
  - `languages` string[], required — BCP 47 languages this section has been tweaked for. Empty means no language-specific tweaks.
  - `regions` string[], required — ISO 3166-1 alpha-3 country codes this section has been tweaked for. Empty means no region-specific tweaks.
  - `specialties` string[], required — Clinical specialties this section has been tweaked for. Empty means no specialty-specific tweaks.
  - `description` string — The description for the section.
  - `labels` GuidedLabel[], required — The labels available to use as query param filter in the LIST /sections endpoint.
    - `key` string, required
    - `value` string, required
  - `createdBy` string, uuid — The UUID of the creator of this section.
  - `createdAt` string, date-time, required — The original timestamp when the section was created.
  - `updatedAt` string, date-time, required — The original timestamp when the section was last updated.
  - `deletedAt` string, date-time, nullable — Present when the section has been deleted. GET by ID still returns the full resource with this field populated.
  - `publishedVersion` GuidedSectionVersion — A section version. When embedded inside a Section resource (e.g. GET /sections/:id), inheritance is fully resolved. When returned directly from version endpoints (GET/LIST/POST .../versions/...), contains raw authored values without inheritance.
    - `id` string, uuid, required — The UUID of the section version.
    - `versionNumber` integer, required — Starts at 0 and auto-increments.
    - `deletedAt` string, date-time, nullable — Present when the section version has been deleted.
    - `generation` GuidedSectionGeneration, required
      - `heading` string, required — The heading of this section. Passed to the LLM.
      - `instructions` GuidedSectionInstructions, required
        - `contentPrompt` string, required — The content prompt instructs the model what to include for synthesis. For `documentationMode: routed_parallel` this impacts what facts to route to this section.
        - `writingStylePrompt` string — The writingStyle prompt instructs the model in what tone and style to output.
        - `miscPrompt` string — Optional free-form prompt for any instructions that don't fit contentPrompt or writingStylePrompt.
      - `outputSchema` union, required
        - GuidedStringNode
          - `type` 'string', required
          - `description` string — Guide the LLM in what to output for this node. Supplements the section-level instructions.
          - `default` string, nullable — If nothing is outputted, this default is used. When `enum` is set, the default must be one of the enum values.
          - `enum` string[] — Can be used to guide the LLM with specific values to output.
          - `pattern` string, nullable — Can be used to constrain the LLM to output a specific pattern.
        - GuidedNumberNode
          - `type` 'number', required
          - `description` string — Guide the LLM in what to output for this node. Supplements the section-level instructions.
          - `default` number, nullable — If nothing is outputted, this default is used.
          - `enum` number[] — Can be used to guide the LLM with specific values to output.
          - `minimum` number, nullable — Use if a minimum value applies.
          - `maximum` number, nullable — Use if a maximum value applies.
        - GuidedBoolNode
          - `type` 'boolean', required
          - `description` string — Guide the LLM in what to output for this node. Supplements the section-level instructions.
          - `default` boolean, nullable — If nothing is outputted, this default is used.
        - GuidedArrayNode
          - `type` 'array', required
          - `description` string — Guide the LLM in what to output for this node. Supplements the section-level instructions.
          - `items` GuidedOutputSchema, required — recursive
          - `itemFormat` string — Format string used to render each array item in the generated output. Use the `{item}` placeholder for the item value.
          - `minItems` integer, nullable — Minimum number of array items to generate.
          - `maxItems` integer, nullable — Maximum number of array items to generate.
        - GuidedObjectNode
          - `type` 'object', required
          - `description` string — Guide the LLM in what to output for this node. Supplements the section-level instructions.
          - `fieldFormat` string — Free-form format string that controls how an object's fields are rendered into the final text output. Operates in one of two modes determined by which placeholders appear: **Subheading mode** (default: `"{key}: {value}\n"`): triggered when the format contains both `{key}` and `{value}`. Applied per field — each field becomes a key/value line. When a field has no relevant input/output and no `default` is set, the entire key/value line for that field is omitted from the rendered output. **Object mode** (e.g. `"{name} ({age})"`): triggered when `{key}` and `{value}` are absent. Placeholders must be actual field keys defined in `fields`. Applied once for the whole object, composing all fields into a single string. When a field has no relevant input/output and no `default` is set, its placeholder is replaced with an empty string (`""`). Validation rules: format must not be empty; if either `{key}` or `{value}` appears, both must be present; in subheading mode no extra placeholders are allowed; in object mode every placeholder must match a defined field key.
          - `fields` GuidedFieldDefinition[] — Define what fields are possible to return in the object.
            - `key` string, required — Use to set a key to reference.
            - `description` string, required — Guide the LLM in what to output for this node. Supplements the section-level instructions.
            - `value` GuidedOutputSchema, required — recursive
            - `default` string, nullable — If nothing is outputted for this field, this default value is used in the rendered output.

## Other responses

- `404` — Not Found

---

[API](https://skmtc.net/corti/apis/admin-api.md) · [All operations](https://skmtc.net/corti/apis/admin-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/corti/admin-api/versions/5d1895a1b3fc/schema)
