Skip to main content
PUT
/
users
/
{userid}
Updates the meta data for a user.
curl --request PUT \
  --url https://api.smartermeasure.com/v3/users/{userid} \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "FirstName": "<string>",
  "LastName": "<string>",
  "Email": "<string>",
  "InternalID": "<string>",
  "EthnicityID": 123,
  "AgeRange": "<string>",
  "HowManyCoursesTaken": "<string>"
}
'
{
  "UserId": "10000001",
  "FirstName": "Alice",
  "LastName": "Carter",
  "Email": "alice.carter@example.com",
  "InternalId": "STU-001",
  "AccessCode": "Xk9mPqRt",
  "HowManyCourses": [],
  "AgeRange": [],
  "Gender": [],
  "CompletionPercentage": "0",
  "DateTimeStarted": "2026-03-20T18:40:08Z",
  "DateTimeLastUpdated": "2026-06-09T20:47:42Z",
  "DateTimeCompleted": [],
  "Uri": "/users/10000001",
  "CustomData": [
    {
      "QuestionId": "611",
      "ParameterId": "coid",
      "Response": []
    },
    {
      "QuestionId": "612",
      "ParameterId": "dcc",
      "Response": []
    },
    {
      "QuestionId": "1972",
      "ParameterId": "custom_canvas_user_id",
      "Response": []
    },
    {
      "QuestionId": "2172",
      "ParameterId": "SessionSid",
      "Response": []
    }
  ]
}

Authorizations

Authorization
string
header
required

Basic authentication with username and password

Path Parameters

userid
number
required

User that should be updated.

Body

application/json
FirstName
string
LastName
string
Email
string
InternalID
string
Gender
enum<string>
Available options:
M,
F
EthnicityID
number
AgeRange
string
HowManyCoursesTaken
string

Response

200 - application/json

User metadata updated.

UserId
string
FirstName
string
LastName
string
Email
string<email>
InternalId
string
AccessCode
string

The user's assessment access (PIN) code.

CompletionPercentage
string

Percentage of the assessment completed (0-100).

DateTimeStarted
string<date-time>
DateTimeLastUpdated

Date the assessment was last updated. Empty array if not yet updated.

DateTimeCompleted

Date the assessment was completed. Empty array if not yet completed.

HowManyCourses
any[]
AgeRange
any[]
Gender
any[]
Uri
string

Relative URI for this user.

CustomData
object[]

Custom question responses configured for the account.