Send instructions to change email

POST /api/2.0/people/email

Request

Sends a message to the user email with the instructions to change the email address connected to the portal.

Authorization

An API key is a token that you provide when making API calls. Include the token in a cookie parameter called asc_auth_key.

Example: asc_auth_key=864FE52C-1C1C-469F-9308-51DAFEFE7436.

Headers

Acceptenum of string

Can be one of: application/json, text/json, text/plain.

Content-Typeenum of string

Can be one of: application/json, application/*+json, text/json.

Body

Request parameters for updating user information

emailstringformat: email

Email

passwordstring

Password

passwordHashstring

Password hash

typeone of
.enum of string

[All - All, RoomAdmin - Room admin, Guest - Guest, DocSpaceAdmin - DocSpace admin, User - User]

Can be one of: All, RoomAdmin, Guest, DocSpaceAdmin, User.

.enum of integer

[0 - All, 1 - Room admin, 2 - Guest, 3 - DocSpace admin, 4 - User]

Can be one of: 0, 1, 2, 3, 4.

isUserboolean

Specifies if this is a guest or a user

firstNamestring

First name

lastNamestring

Last name

departmentarray of string

List of user departments

titlestring

Title

locationstring

Location

sexone of
.enum of string

[Female - Female, Male - Male]

Can be one of: Female, Male.

.enum of integer

[0 - Female, 1 - Male]

Can be one of: 0, 1.

birthdayobject
utcTimestringformat: date-time

UtcTime

timeZoneOffsetstringformat: date-span

TimeZoneOffset

worksfromobject
utcTimestringformat: date-time

UtcTime

timeZoneOffsetstringformat: date-span

TimeZoneOffset

commentstring

Comment

contactsarray of object

List of user contacts

typestring

Contact type

valuestring

Contact value

filesstring

Avatar photo URL

fromInviteLinkboolean

Specifies if the user is added via the invitation link or not

keystring

Key

cultureNamestring

Language

targetstringformat: uuid

Target

spamboolean

Spam

userIdstring

User ID

disableboolean

Specifies whether to disable a user or not

Examples

POST /api/2.0/people/email HTTP/1.1
Accept: application/json
Content-Length: 896
Content-Type: application/json
Host: example.com

{
  "email": "Vince58@hotmail.com",
  "password": "Iga5elNxPe",
  "passwordHash": "some text",
  "isUser": true,
  "firstName": "Durward",
  "lastName": "Steuber",
  "department": [
    "75a5f745-f697-4418-b38d-0fe0d277e258"
  ],
  "title": "unbranded_steel_car",
  "location": "62615 Gaetano Greens, South Estelle, Cayman Islands",
  "birthday": {
    "utcTime": "2008-04-10T06:30:00.0000000+04:00",
    "timeZoneOffset": "00:00:00"
  },
  "worksfrom": {
    "utcTime": "2008-04-10T06:30:00.0000000+04:00",
    "timeZoneOffset": "00:00:00"
  },
  "comment": "some text",
  "contacts": [
    {
      "value": {
        "type": "GTalk",
        "value": "my@gmail.com"
      }
    }
  ],
  "files": "some text",
  "fromInviteLink": true,
  "key": "some text",
  "cultureName": "some text",
  "target": "75a5f745-f697-4418-b38d-0fe0d277e258",
  "spam": true,
  "userId": "5152",
  "disable": true
}
curl --request POST \
  --url https://example.com/api/2.0/people/email \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{
  "email": "Vince58@hotmail.com",
  "password": "Iga5elNxPe",
  "passwordHash": "some text",
  "isUser": true,
  "firstName": "Durward",
  "lastName": "Steuber",
  "department": [
    "75a5f745-f697-4418-b38d-0fe0d277e258"
  ],
  "title": "unbranded_steel_car",
  "location": "62615 Gaetano Greens, South Estelle, Cayman Islands",
  "birthday": {
    "utcTime": "2008-04-10T06:30:00.0000000+04:00",
    "timeZoneOffset": "00:00:00"
  },
  "worksfrom": {
    "utcTime": "2008-04-10T06:30:00.0000000+04:00",
    "timeZoneOffset": "00:00:00"
  },
  "comment": "some text",
  "contacts": [
    {
      "value": {
        "type": "GTalk",
        "value": "my@gmail.com"
      }
    }
  ],
  "files": "some text",
  "fromInviteLink": true,
  "key": "some text",
  "cultureName": "some text",
  "target": "75a5f745-f697-4418-b38d-0fe0d277e258",
  "spam": true,
  "userId": "5152",
  "disable": true
}'

Responses

200

Message text

400

Incorrect userId or email

401

Unauthorized

403

No permissions to perform this action

404

User not found

Get Help

  • If you have any questions about ONLYOFFICE DocSpace, try the FAQ section first.
  • You can request a feature or report a bug by posting an issue on GitHub.
  • You can also ask our developers on ONLYOFFICE forum (registration required).