Skip to main content
PUT
/
studies
/
{studyId}
/
screener
/
questions
/
{questionId}
Update a screener question
curl --request PUT \
  --url https://api.rallyuxr.com/api/public/v1/studies/{studyId}/screener/questions/{questionId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "category": "simple",
  "name": "<string>",
  "description": "<string>",
  "isRequired": true,
  "mappedToPropertyId": "<string>",
  "questionTemplateId": "<string>"
}
'
{
  "category": "simple",
  "name": "<string>",
  "isRequired": true,
  "id": "<string>",
  "workspaceId": "<string>",
  "description": "<string>",
  "mappedToPropertyId": "<string>",
  "questionTemplateId": "<string>"
}

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
studyId
string
required
​
questionId
string
required

Body

application/json

The full replacement body for a single question, discriminated by category. Template-sourced questions are updated through their concrete category with questionTemplateId set. Matrix questions are addressed by their parent question id.

​
category
enum<string>
required
Available options:
simple
​
type
enum<string>
required

Whether the question collects short text, long text, a date, or a number

Available options:
SHORT_FORM,
LONG_FORM,
DATE,
NUMBER
​
name
string
required

The question prompt

​
description
string

Optional helper text shown beneath the question prompt

​
isRequired
boolean
default:true

Whether a response is required before the screener can be submitted

​
mappedToPropertyId
string

Map the response to a person property

​
questionTemplateId
string

Required when updating a question that was created from a template: pass the existing template id to keep the link. Cannot be added to or changed on other questions.

Response

The updated question

A screener question. Template-sourced questions are returned expanded into their concrete category.

​
category
enum<string>
required
Available options:
simple
​
type
enum<string>
required

Whether the question collects short text, long text, a date, or a number

Available options:
SHORT_FORM,
LONG_FORM,
DATE,
NUMBER
​
name
string
required

The question prompt

​
isRequired
boolean
default:true
required

Whether a response is required before the screener can be submitted

​
id
string
required

The question id

​
workspaceId
string
required

The workspace that owns the question

​
description
string

Optional helper text shown beneath the question prompt

​
mappedToPropertyId
string

Map the response to a person property

​
questionTemplateId
string

Present for questions created from a template