---
title: "Create an extra-step template"
method: POST
path: "/api/journey/extra-step-templates"
tags: ["journey"]
---

# Create an extra-step template

`POST /api/journey/extra-step-templates`

## Request body

- CreateExtraStepTemplateRequest — Create a reusable extra-step template for the gallery.
  - `category` string, required — Gallery category (free text)
  - `title` string, required — Step title
  - `description` string, nullable
  - `icon` string — Icon name
  - `contents` union[] — Contents (type-specific payloads)
    - union
      - TextContentPayload
        - `type` 'text'
        - `style` 'title' | 'body', nullable — title or body
        - `text` string, nullable — The text content
        - `metadata` TextContentMetadata
          - `show_when_risk` 'psi' | 'nutri' | 'both', nullable — Show only when the patient is at risk on this side
      - ImageContentPayload
        - `type` 'image'
        - `file_path` string, nullable — Internal file path
        - `variant` 'full', nullable — e.g. full
        - `metadata` ImageContentMetadata
          - `show_when_risk` 'psi' | 'nutri' | 'both', nullable — Show only when the patient is at risk on this side
      - VideoContentPayload
        - `type` 'video'
        - `title` string, nullable
        - `description` string, nullable
        - `url` string, nullable — External video URL
        - `metadata` VideoContentMetadata
          - `duration_seconds` integer, nullable — Video duration in seconds
          - `video_id` union — Linked internal video id
            - string
            - string, uuid
          - `family_course_episode` integer, nullable — Family-course episode number
          - `show_when_risk` 'psi' | 'nutri' | 'both', nullable
      - AudioContentPayload
        - `type` 'audio'
        - `title` string, nullable
        - `description` string, nullable
        - `url` string, nullable — External audio URL
        - `metadata` AudioContentMetadata
          - `duration_seconds` integer, nullable — Audio duration in seconds
          - `show_when_risk` 'psi' | 'nutri' | 'both', nullable
      - PodcastContentPayload
        - `type` 'podcast'
        - `title` string, nullable
        - `description` string, nullable
        - `url` string, nullable — External podcast URL
        - `metadata` PodcastContentMetadata
          - `duration_seconds` integer, nullable — Podcast duration in seconds
          - `show_when_risk` 'psi' | 'nutri' | 'both', nullable
      - PdfContentPayload
        - `type` 'pdf'
        - `title` string, nullable
        - `description` string, nullable
        - `file_path` string, nullable — Internal file path
        - `metadata` PdfContentMetadata
          - `editable` boolean, nullable — Whether the PDF is editable
          - `show_when_risk` 'psi' | 'nutri' | 'both', nullable
      - MicroGameContentPayload
        - `type` 'micro_game'
        - `title` string, nullable
        - `description` string, nullable
        - `game_type` string, nullable — micro_game template identifier
        - `metadata` MicroGameContentMetadata
          - `game_type` string, nullable — micro_game template identifier
          - `show_when_risk` 'psi' | 'nutri' | 'both', nullable
      - QuestionnaireContentPayload
        - `type` 'questionnaire'
        - `title` string, nullable
        - `description` string, nullable
        - `metadata` QuestionnaireContentMetadata
          - `questionnaire_type` string, nullable — Questionnaire identifier
          - `show_when_risk` 'psi' | 'nutri' | 'both', nullable

## Response `201`

Successful Response

- ExtraStepTemplateResponse — A reusable extra-step template from the gallery.
  - `id` string, required — Template id
  - `category` string, required
  - `title` string, required
  - `description` string, nullable
  - `icon` string, required
  - `contents` union[]
    - union
      - TextContentPayload
        - `type` 'text'
        - `style` 'title' | 'body', nullable — title or body
        - `text` string, nullable — The text content
        - `metadata` TextContentMetadata
          - `show_when_risk` 'psi' | 'nutri' | 'both', nullable — Show only when the patient is at risk on this side
      - ImageContentPayload
        - `type` 'image'
        - `file_path` string, nullable — Internal file path
        - `variant` 'full', nullable — e.g. full
        - `metadata` ImageContentMetadata
          - `show_when_risk` 'psi' | 'nutri' | 'both', nullable — Show only when the patient is at risk on this side
      - VideoContentPayload
        - `type` 'video'
        - `title` string, nullable
        - `description` string, nullable
        - `url` string, nullable — External video URL
        - `metadata` VideoContentMetadata
          - `duration_seconds` integer, nullable — Video duration in seconds
          - `video_id` union — Linked internal video id
            - string
            - string, uuid
          - `family_course_episode` integer, nullable — Family-course episode number
          - `show_when_risk` 'psi' | 'nutri' | 'both', nullable
      - AudioContentPayload
        - `type` 'audio'
        - `title` string, nullable
        - `description` string, nullable
        - `url` string, nullable — External audio URL
        - `metadata` AudioContentMetadata
          - `duration_seconds` integer, nullable — Audio duration in seconds
          - `show_when_risk` 'psi' | 'nutri' | 'both', nullable
      - PodcastContentPayload
        - `type` 'podcast'
        - `title` string, nullable
        - `description` string, nullable
        - `url` string, nullable — External podcast URL
        - `metadata` PodcastContentMetadata
          - `duration_seconds` integer, nullable — Podcast duration in seconds
          - `show_when_risk` 'psi' | 'nutri' | 'both', nullable
      - PdfContentPayload
        - `type` 'pdf'
        - `title` string, nullable
        - `description` string, nullable
        - `file_path` string, nullable — Internal file path
        - `metadata` PdfContentMetadata
          - `editable` boolean, nullable — Whether the PDF is editable
          - `show_when_risk` 'psi' | 'nutri' | 'both', nullable
      - MicroGameContentPayload
        - `type` 'micro_game'
        - `title` string, nullable
        - `description` string, nullable
        - `game_type` string, nullable — micro_game template identifier
        - `metadata` MicroGameContentMetadata
          - `game_type` string, nullable — micro_game template identifier
          - `show_when_risk` 'psi' | 'nutri' | 'both', nullable
      - QuestionnaireContentPayload
        - `type` 'questionnaire'
        - `title` string, nullable
        - `description` string, nullable
        - `metadata` QuestionnaireContentMetadata
          - `questionnaire_type` string, nullable — Questionnaire identifier
          - `show_when_risk` 'psi' | 'nutri' | 'both', nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/corabea/apis/corabea-api.md) · [All operations](https://skmtc.dev/corabea/apis/corabea-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/corabea/corabea-api/revisions/13c1bce1bdc4/schema)