---
title: "Get active DTT template"
method: GET
path: "/dtt/templates/active"
tags: ["DTT Templates"]
---

# Get active DTT template

`GET /dtt/templates/active`

## Request

- Base URL: `https://dashboard.researchanddesire.com/api/v1`
- URL: `https://dashboard.researchanddesire.com/api/v1/dtt/templates/active`
- Auth: one of:
  - HTTP bearer
  - OAuth 2
    - Authorization code: `/oauth/authorize`
    - Token URL: `/oauth/token` scopes: `dtt:read`

Returns the currently active training program template. Returns null in the data field if no template is active.

## Response `200`

Active template or null

- ActiveDttTemplateResponse
  - `ok` true, required
  - `data` DttTemplateDetail
    - `id` integer: Template ID
    - `bubbleId` string: Unique public identifier
    - `ownerId` integer: Owner user ID
    - `name` string: Program name
    - `description` string: Program description
    - `tagline` string: Short tagline
    - `message` string: Welcome message
    - `isPublic` boolean: Whether publicly visible
    - `isActive` boolean: Whether currently active
    - `handsFreeMode` boolean: Hands-free mode enabled
    - `targetDepth` integer: Target depth percentage
    - `targetWindow` integer: Target window size
    - `toyId` integer, nullable: Associated toy ID
    - `createdDate` string, date-time: Creation date
    - `updatedAt` string, date-time: Last update time
    - `Segment` DttSegment[]
      - `id` integer
      - `type` 'repetition' | 'endurance' | 'freeform' | 'bounce': Segment type
      - `duration` integer: Duration (meaning varies by type)
      - `speed` number: Speed setting (1–1000)
      - `repeat` integer: Number of times to repeat
      - `order` integer: Position in the segment list (0-based)
      - `passFailEnabled` boolean: Whether pass/fail grading is enabled
      - `passGradeThreshold` integer: Minimum grade to pass (0–100)
      - `failureText` string, nullable: Message shown on failure
  - `message` string: Message when no active template

## Other responses

- `401`: Authentication required or token invalid
- `500`: Internal server error

## Changes

- **2026-09-28** `cad555a1bf4b`: 1 breaking
  - the `data/oneOf[#/components/schemas/DttTemplateDetail]/allOf[subschema #2]/Segment/items/speed` response's property type changed from `integer` to `number` for status `200`
- **2026-09-22** `2411203b3c10`: 2 info
  - the endpoint scheme security `bearerAuth` was added to the API
  - the endpoint scheme security `oauth2` was added to the API

[Operation history](https://skmtc.dev/researchanddesire/apis/research-and-desire-api/changes/dtt/templates/active/get.md)

---

[API](https://skmtc.dev/researchanddesire/apis/research-and-desire-api.md) - [All operations](https://skmtc.dev/researchanddesire/apis/research-and-desire-api/llms.txt) - [OpenAPI document](https://skmtc.dev/researchanddesire/apis/research-and-desire-api/revisions/682fc4d7f6d5?raw)