Update a user photo

PUT /api/2.0/people/{userid}/photo

Request

Updates a photo of the user with the ID specified in the request.

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.

Path

useridstringrequired

User ID

Body

Request parameters for updating user photo

filesstring

Avatar photo URL

Examples

PUT /api/2.0/people/8756/photo HTTP/1.1
Accept: application/json
Content-Length: 26
Content-Type: application/json
Host: example.com

{
  "files": "some text"
}
curl --request PUT \
  --url https://example.com/api/2.0/people/8756/photo \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{
  "files": "some text"
}'

Responses

200

Updated thumbnail parameters: original photo, retina, maximum size photo, big, medium, small

originalstring

Original photo

retinastring

Retina

maxstring

Maximum size

bigstring

Big

mediumstring

Medium

smallstring

Small

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).