Skip to main content
POST
/
api
/
v1
/
templates
Create a question template
curl --request POST \
  --url https://app.autousers.ai/api/v1/templates \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "teamId": "<string>",
  "name": "<string>",
  "description": "<string>",
  "type": "TEXT_SXS",
  "scaleType": "SEVEN_POINT",
  "scaleMin": 1,
  "scaleMax": 7,
  "scaleLabels": {},
  "guidelines": "<string>",
  "criteria": [
    {
      "id": "<string>",
      "label": "<string>",
      "description": "<string>"
    }
  ],
  "icon": "star",
  "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": [],
  "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": false,
  "sourceBuiltInId": "<string>",
  "openTextEnabled": false,
  "customQuestions": [
    {
      "id": "<string>",
      "text": "<string>",
      "category": "<string>"
    }
  ]
}
'
{
  "id": "<string>",
  "name": "<string>",
  "isSystem": true,
  "version": 123,
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z",
  "description": "<string>",
  "teamId": "<string>"
}

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.

Body

application/json
​
teamId
string<cuid>
required
​
name
string
required
Required string length: 1 - 200
​
description
string
Maximum string length: 2000
​
type
enum<string>
default:TEXT_SXS
Available options:
TEXT_SXS,
TEXT_SSE,
MEDIA_SXS,
MEDIA_SSE
​
scaleType
enum<string>
default:SEVEN_POINT
Available options:
THREE_POINT,
FIVE_POINT,
SEVEN_POINT
​
scaleMin
integer
default:1
​
scaleMax
integer
default:7
​
scaleLabels
object
​
guidelines
string
Maximum string length: 50000
​
criteria
object[]
​
icon
string
default:star
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>
default:holistic
Available options:
holistic,
rubric
​
sseAnchors
object[]
​
sseAnchorLabels
string[]
Maximum string length: 500
​
sseAnchorDescriptions
string[]
Maximum string length: 2000
​
sxsScoringMode
enum<string>
default:holistic
Available options:
holistic,
rubric
​
sxsAnchors
object[]
​
sxsAnchorLabels
string[]
Maximum string length: 500
​
sxsAnchorDescriptions
string[]
Maximum string length: 2000
​
isPrimary
boolean
default:false
​
sourceBuiltInId
string
Maximum string length: 200
​
openTextEnabled
boolean
default:false
​
customQuestions
object[]

Response

Created

​
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