API done contacts
These are completed actions, which are equivalent to the top half of Record a Contact in the web application. They are created like this, using the referral number
[POST] https://api.dizions.co.uk/v2/done_contacts/referral/127
The body must contain all of the following keys for creation:
user stage start_date end_date description
Optionally, you can also add:
travel_time travel_mileage transport_method contact_type priority
This will return the id, which can be used for editing, at least one of the required or optional keys, like this:
[PUT] https://api.dizions.co.uk/v2/done_contacts/456
NB the done_contact is also used to complete a due_contact, because conceptually, you are converting a due_contact into a done_contact when completing it. Also see the page on due_contacts
There are various validation rules in the web to make optional fields compulsory for users of the web app, for example if you require a priority for every referral. These settings are not implemented in the API, as the data avilable to the API caller may be different to user of the web app. The assumption is that the caller will perform its own validation.