REresearchanddesire
DTT Templates

Update DTT training program

Changed on

Update one or more fields on a training program. Only include the fields you want to change — all fields are optional.

If Segment is provided, it replaces the entire segment list (existing segments are deleted).

Ultra-only fields: handsFreeMode, tagline, and iconId require an Ultra subscription or higher. Setting these to their "off" values (false / null) is always allowed.

patch/dtt/templates/{id}

Request

  • Base URL
    https://dashboard.researchanddesire.com/api/v1
  • Auth
    • HTTP bearer
    • or OAuth 2
      Authorization code/oauth/authorize
      Token URL/oauth/token
      Scopesdtt:write

Path parameters

idinteger required
Example:1

The DTT template (training program) ID

Request body

namestring

Program name (4–128 characters, cannot be blank)

targetWindownumber

Target window size

targetDepthnumber

Target depth percentage

toyIdinteger nullable

Associated toy ID (0 or null to unset)

messagestring nullable

Completion message (max 50 chars, defaults to "Good Work!")

handsFreeModeboolean

Enable hands-free mode (Ultra only)

taglinestring nullable

Short tagline (Ultra only, max 25 chars)

toyTaglinestring nullable

Toy tagline (max 25 chars)

iconIdinteger nullable

Icon ID (Ultra only)

isPublicboolean

Whether the program is publicly shared

descriptionstring nullable

Program description (max 500 chars)

Response

Updated template with segments

oktrue required

Changes

  • cad555a1bf4bRevision changes
    • breaking

      the //// response's property type changed from integer to number for status

    • info

      the // request property type was generalized from integer to number

  • 2411203b3c10Revision changes
    • info

      the endpoint scheme security bearerAuth was added to the API

    • info

      the endpoint scheme security oauth2 was added to the API