Update Identity Data

Description

This method provides a way to update an identity.

HTTP Method

PUT

Path

/identities/{identityId}

Authentication

Requires an authenticated user.

Parameters

Table 34.  Parameters for " Update Identity Data "

NameTypeValue TypeDescription
identityIdPATHlongThe identity which we wish to update.
labelQUERYStringThe label of the identity.
personBODYPersonperson XML node as per Get Identity Data response.

Error Codes

10039 ( Account )

Permission denied, not a new account anymore.

150001 ( Common )

The endpoint requires an authenticated account

40000 ( Identity )

An unhanded exception occured.

40007 ( Identity )

Don't have the permission to access the identity.

40015 ( Identity )

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

40016 ( Identity )

Don't have the permission to execute this request

40018 ( Identity )

Permission denied for updating this identity.

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:complexType>
      <xs:sequence>
        <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:sequence>
    </xs:complexType>
  </xs:element>

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

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

Sample Response

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