Skip to content

Update Employee Portraits

Operation
wsdlUpdateEmployeePortraits
SOAP Action
uri:FlexForce/wsdlUpdateEmployeePortraits
Service
FlexForce
Port
FlexForcePort
Style
rpc

Upload portraits for one or more employees. Per-employee validationErrors flag any individual failures.


Request

Message: wsdlUpdateEmployeePortraitsRequest

apiKeystring

API key of the unit.

employeePortraitsArray<UpdateEmployeePortrait>

Array of UpdateEmployeePortrait records — one per employee to update.

itemUpdateEmployeePortrait

Portrait payload for a single employee, used by wsdlUpdateEmployeePortraits.

badgeNostringrequired

Badge number of the employee whose portrait is being uploaded.

portraitstringrequired

Base64-encoded image to use as the employee's portrait.

validationErrorsArray<xsd:string>required

Returned in the response only. Array of error strings if the update failed for this employee; empty array on success.

curl -X POST 'https://api.quinyx.com/FlexForceWebServices.php' \
  -H 'Content-Type: text/xml; charset=utf-8' \
  -H 'SOAPAction: "uri:FlexForce/wsdlUpdateEmployeePortraits"' \
  --data @- <<'EOF'
<?xml version="1.0" encoding="UTF-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" xmlns:tns="https://api.quinyx.com/soap/FlexForce">
  <soap:Body>
    <tns:wsdlUpdateEmployeePortraits>
    <apiKey xsi:type="xsd:string">string</apiKey>
    <employeePortraits xsi:type="SOAP-ENC:Array" SOAP-ENC:arrayType="tns:UpdateEmployeePortrait[1]">
      <item xsi:type="tns:UpdateEmployeePortrait">
        <badgeNo xsi:type="xsd:string">string</badgeNo>
        <portrait xsi:type="xsd:string">string</portrait>
        <validationErrors xsi:type="SOAP-ENC:Array" SOAP-ENC:arrayType="xsd:string[1]">
          <item xsi:type="xsd:string">string</item>
        </validationErrors>
      </item>
    </employeePortraits>
    </tns:wsdlUpdateEmployeePortraits>
  </soap:Body>
</soap:Envelope>
EOF

Response

Message: wsdlUpdateEmployeePortraitsResponse

returnArray<UpdateEmployeePortrait>

Array of UpdateEmployeePortrait records reflecting the saved state.

itemUpdateEmployeePortrait

Portrait payload for a single employee, used by wsdlUpdateEmployeePortraits.

badgeNostringrequired

Badge number of the employee whose portrait is being uploaded.

portraitstringrequired

Base64-encoded image to use as the employee's portrait.

validationErrorsArray<xsd:string>required

Returned in the response only. Array of error strings if the update failed for this employee; empty array on success.

<?xml version="1.0" encoding="UTF-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" xmlns:tns="https://api.quinyx.com/soap/FlexForce">
  <soap:Body>
    <tns:wsdlUpdateEmployeePortraitsResponse>
    <return xsi:type="SOAP-ENC:Array" SOAP-ENC:arrayType="tns:UpdateEmployeePortrait[1]">
      <item xsi:type="tns:UpdateEmployeePortrait">
        <badgeNo xsi:type="xsd:string">string</badgeNo>
        <portrait xsi:type="xsd:string">string</portrait>
        <validationErrors xsi:type="SOAP-ENC:Array" SOAP-ENC:arrayType="xsd:string[1]">
          <item xsi:type="xsd:string">string</item>
        </validationErrors>
      </item>
    </return>
    </tns:wsdlUpdateEmployeePortraitsResponse>
  </soap:Body>
</soap:Envelope>