Skip to main content
PATCH
/
api
/
v1
/
templates
/
{id}
Update a question template
curl --request PATCH \
  --url https://app.autousers.ai/api/v1/templates/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "description": "<string>",
  "type": "TEXT_SXS",
  "scaleType": "THREE_POINT",
  "scaleMin": 123,
  "scaleMax": 123,
  "scaleLabels": {},
  "guidelines": "<string>",
  "criteria": [
    {
      "id": "<string>",
      "label": "<string>",
      "description": "<string>"
    }
  ],
  "icon": "<string>",
  "scaleQuestion": "<string>",
  "sseQuestion": "<string>",
  "factors": [
    {
      "id": "<string>",
      "label": "<string>",
      "description": "<string>"
    }
  ],
  "sseCriteria": [
    {
      "id": "<string>",
      "label": "<string>",
      "description": "<string>"
    }
  ],
  "sseScaleLabels": [
    "<string>"
  ],
  "sxsScaleLabels": [
    "<string>"
  ],
  "sseScaleDescriptions": [
    "<string>"
  ],
  "sxsScaleDescriptions": [
    "<string>"
  ],
  "contexts": [
    "ui-ux"
  ],
  "scoringMode": "holistic",
  "sseAnchors": [
    {
      "id": "<string>",
      "label": "<string>",
      "description": "<string>",
      "weight": 1
    }
  ],
  "sseAnchorLabels": [
    "<string>"
  ],
  "sseAnchorDescriptions": [
    "<string>"
  ],
  "sxsScoringMode": "holistic",
  "sxsAnchors": [
    {
      "id": "<string>",
      "label": "<string>",
      "description": "<string>",
      "weight": 1
    }
  ],
  "sxsAnchorLabels": [
    "<string>"
  ],
  "sxsAnchorDescriptions": [
    "<string>"
  ],
  "isPrimary": true,
  "openTextEnabled": true,
  "customQuestions": [
    {
      "id": "<string>",
      "text": "<string>",
      "category": "<string>"
    }
  ],
  "status": "draft"
}
'
{
  "id": "<string>",
  "name": "<string>",
  "isSystem": true,
  "version": 123,
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z",
  "description": "<string>",
  "teamId": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.autousers.ai/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

​
Idempotency-Key
string

Client-generated idempotency key (≤255 chars). Replays the cached response when the same (team, key) pair sees an identical request body within 24h; returns 409 idempotency_key_reused if the body differs. Recommended for every billable POST.

Maximum string length: 255
​
Autousers-Version
string

Date-pinned API version (e.g. 2026-05-04). Omit to receive the latest stable version. Behaves like Stripe's Stripe-Version — pinning a version freezes payload shapes against breaking changes during the 12-month sunset window.

Path Parameters

​
id
string
required

cuid of the resource

Body

application/json
​
name
string
Required string length: 1 - 200
​
description
string
Maximum string length: 2000
​
type
enum<string>
Available options:
TEXT_SXS,
TEXT_SSE,
MEDIA_SXS,
MEDIA_SSE
​
scaleType
enum<string>
Available options:
THREE_POINT,
FIVE_POINT,
SEVEN_POINT
​
scaleMin
integer
​
scaleMax
integer
​
scaleLabels
object
​
guidelines
string
Maximum string length: 50000
​
criteria
object[]
​
icon
string
Required string length: 1 - 100
​
scaleQuestion
string
Maximum string length: 500
​
sseQuestion
string
Maximum string length: 500
​
factors
object[]
​
sseCriteria
object[]
​
sseScaleLabels
string[] | null
Maximum string length: 500
​
sxsScaleLabels
string[] | null
Maximum string length: 500
​
sseScaleDescriptions
string[] | null
Maximum string length: 2000
​
sxsScaleDescriptions
string[] | null
Maximum string length: 2000
​
contexts
enum<string>[]
Available options:
ui-ux,
llm-ai,
design-system,
generic
​
scoringMode
enum<string>
Available options:
holistic,
rubric
​
sseAnchors
object[]
​
sseAnchorLabels
string[]
Maximum string length: 500
​
sseAnchorDescriptions
string[]
Maximum string length: 2000
​
sxsScoringMode
enum<string>
Available options:
holistic,
rubric
​
sxsAnchors
object[]
​
sxsAnchorLabels
string[]
Maximum string length: 500
​
sxsAnchorDescriptions
string[]
Maximum string length: 2000
​
isPrimary
boolean
​
openTextEnabled
boolean
​
customQuestions
object[]
​
status
enum<string>
Available options:
draft,
active,
archived

Response

Updated

​
id
string
required
​
name
string
required
​
isSystem
boolean
required
​
version
integer
required
​
createdAt
string<date-time>
required
​
updatedAt
string<date-time>
required
​
description
string | null
​
teamId
string | null
​
{key}
any