Update Company Officer

PUT {{baseUrl}}/cas/companies/:companyId/officers/:officerId

Update an existing Officer Transaction in order to complete the change in CAS360

Request Body

KeyDataTypeMandatoryConstraintsNotes
contactIdNumberYesMust be ID of an existing contact
appointDateStringYesISO 8601 date https://en.wikipedia.org/wiki/ISO_8601
positionStringYesMust be one of 'Director','Secretary', 'Alternate', Managing Director, Manager, Nominee Director,Managing Director, Manager, Nominee Director only supported for SG companies
positionStatusStringNoMust be one of 'Appointed, Resigned, Removed, Deceased'
ceaseDateDateNoISO 8601 date https://en.wikipedia.org/wiki/ISO_8601. Only if positionStatus is present and is not ‘Appointed’. Cannot be before ‘appointedDate’
signatoryStatusStringNoMust be one of 'Attendee, Signatory, Chairperson, Form Signatory, Apology, Non Attendee'
alternateContactIdNumberNoThis is the contactID of the existing director\Mandatory if the position is 'Alternate'
alternateTermsStringNoTerms of Alternate appointmentMandatory if the position is 'Alternate'
nominatorContactIdNumberNoThis is the contactID of the existing director\Mandatory if the position is 'Nominee Director'
notesStringNoText
prepareFormBooleanNoTrue or False

Response Body

Returns a list of objects that will contain the below keys

|Key | Datatype | Mandatory | Constraints | | ----------- | -------- | --------- | ---------------------------------------------------- | |id|Number|Yes|Must be ID of an existing Officer transaction| | |contactId|Number |Yes |Must be ID of an existing contact| | |position |String |Yes |Must be one of 'Director','Secretary', 'Alternate', Managing Director, Manager, Nominee Director, | Managing Director, Manager, Nominee Director only supported for SG companies| |positionStatus |String |No |Must be one of 'Appointed, Resigned, Removed, Deceased' | | | ceaseDate | Date | No | ISO 8601 date https://en.wikipedia.org/wiki/ISO_8601. Only if positionStatus is present and is not ‘Appointed’. Cannot be before ‘appointDate’| | | |appointDate|Date |No|ISO 8601 date https://en.wikipedia.org/wiki/ISO_8601. Cannot be after ‘ceaseDate’ | | |signatoryStatus|String |No|Must be one of 'Attendee, Signatory, Chairperson, Form Signatory, Apology, Non Attendee' | | |alternateContactId |Number |No |This is the contactID of the existing director\Mandatory if the position is 'Alternate'| | |alternateTerms|String |No |Terms of Alternate appointmentMandatory if the position is 'Alternate'| | |nominatorContactId |Number |No|This is the contactID of the existing director\Mandatory if the position is 'Nominee Director' | | |notes |String |No |Text | | |prepareForm |Boolean |No|True or False| |

Request Body

{"contactId"=>123456, "position"=>"Director", "positionStatus"=>"Appointed", "appointDate"=>"2021-01-11", "signatoryStatus"=>"Chairperson", "notes"=>"", "prepareDocuments"=>"N"}

HEADERS

KeyDatatypeRequiredDescription
Authorizationstring
Content-Typestring