v1

latestOpenAPI 3.0.0Apache 2.02026-07-2410185524.2 KB
Users

update user

Update the specified user.

For custom components:

RaiselyComponents.api.one('users', '{uuid}').patch(data = {}, params = {}, headers = {}) => Promise<{result}>

:fa-gears: See Restie Response Data for a more detailed overview of responses through the client wrapper

patch/users/{uuid}

Path parameters

uuidstring required

The uuid of the record

Query parameters

privateboolean

Returns the full record when authenticated

Headers

Authorizationstring

A valid HTTP Bearer token, required to access private records.

Request body

overwriteCustomFieldsboolean

If passed, replace the existing public and private values on the record with the values provided with this payload

Example request

{
  "data": {
    "address1": "31 Sunset Boulevard",
    "address2": "Unit 31b",
    "country": "AU",
    "email": "harveymilk@example.com",
    "firstName": "Leila",
    "fullName": "Leila Norma de Lima",
    "isSamlLogin": true,
    "lastName": "de Lima",
    "phoneNumber": "+1 123-456-7890",
    "photoUrl": "https://raisely-images.imgix.net/www/uploads/t-03-arl-8-es-uhhqua-4-pr-f-4865431-df-58-512-png-08e3f5.png",
    "postcode": "AAA BBBB",
    "preferredName": "Norma",
    "private": {
      "fieldA": "one",
      "fieldB": "yes"
    },
    "public": {
      "fieldA": "one",
      "fieldB": "yes"
    },
    "state": "Victoria",
    "suburb": "Melbourne"
  }
}

Response

The updated User record

Example response

{
  "data": {
    "accessToken": "aaabbbccc",
    "address1": "31 Sunset Boulevard",
    "address2": "Unit 31b",
    "adminSettings": {
      "v4BetaOptin": true,
      "starredCampaigns": [
        "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
        "ffffffff-gggg-hhhh-iiii-jjjjjjjjjjjj"
      ]
    },
    "country": "AU",
    "createdAt": "2020-12-03T06:52:46.330Z",
    "email": "harveymilk@example.com",
    "facebookId": "fb_someurl",
    "firstName": "Leila",
    "fullName": "Leila Norma de Lima",
    "internal": {},
    "isAdmin": true,
    "isSamlLogin": true,
    "lastName": "de Lima",
    "organisationUuid": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa",
    "permission": "PARTICIPANT",
    "phoneNumber": "+1 123-456-7890",
    "photoUrl": "https://raisely-images.imgix.net/www/uploads/t-03-arl-8-es-uhhqua-4-pr-f-4865431-df-58-512-png-08e3f5.png",
    "postcode": "AAA BBBB",
    "preferredName": "Norma",
    "private": {
      "fieldA": "one",
      "fieldB": "yes"
    },
    "public": {
      "fieldA": "one",
      "fieldB": "yes"
    },
    "state": "Victoria",
    "status": "ACTIVE",
    "suburb": "Melbourne",
    "tags": [
      {
        "color": "#ff0000",
        "createdAt": "2020-12-03T06:52:46.330Z",
        "internal": {},
        "isPrivate": true,
        "label": "My Custom Tag",
        "organisationUuid": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa",
        "path": "example-path",
        "recordType": "user",
        "updatedAt": "2020-12-03T06:52:46.330Z",
        "uuid": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa"
      }
    ],
    "unsubscribedAt": "2020-12-03T06:52:46.330Z",
    "updatedAt": "2020-12-03T06:52:46.330Z",
    "username": "harveymilk@example.com",
    "uuid": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa"
  }
}