Upload Profile Image


Updates the card profile image

HTTP Method





Requires an authenticated user.


Table 37.  Parameters for " Upload Profile Image "

NameTypeValue TypeDescription
identityIdPATHlongThe identity/account id for which to update the profile image.
avatarIdQUERYlong(optional, considered only if no picture is provided) you can use one of the supported avatars as default image for this identity
pictureBODYInputStreamThe background image data as bytes.

Error Codes

150001 ( Common )

The endpoint requires an authenticated account

40001 ( Identity )

Error while trying to upload a picture.

40007 ( Identity )

Don't have the permission to access the identity.

40008 ( Identity )

The image type is not supported. Supported image formats are: jpeg, png, bmp, gif.

40015 ( Identity )

The provided ID doesn't point to a valid identity.

40016 ( Identity )

Don't have the permission to execute this request

40017 ( Identity )

Invalid avatar provided

Response Schema

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<xs:schema elementFormDefault="qualified" version="1.0" targetNamespace="http://xsd.poken.com" xmlns:tns="http://xsd.poken.com" xmlns:xs="http://www.w3.org/2001/XMLSchema">

  <xs:element name="response">
        <xs:element name="success" type="tns:Status" default="FAILURE" minOccurs="0"/>
        <xs:element name="error" type="tns:Error" nillable="true" minOccurs="0" maxOccurs="unbounded"/>

  <xs:complexType name="Error">
      <xs:element name="code" type="xs:string"/>
      <xs:element name="description" type="xs:string"/>

  <xs:simpleType name="Status">
    <xs:restriction base="xs:string">
      <xs:enumeration value="SUCCESS"/>
      <xs:enumeration value="FAILURE"/>

Sample Response

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<response xmlns="http://xsd.poken.com">