The employer UPDATE LOCATION function modifies information about a specific job location from the authorised account. The request must provide the id field.

URL

https://apprenticeshipcentral.com.au/api/employer/update/

Request

• id (int) – the location id number. Can be retrieved by the Employer list API call. Required.
• type (string) – location. Required.
• fields (object) – fields that require update information (at least one would be useful)
  • id (int) – the location id.
  • location_primary (bool) – the main location.
  • location_address (string) – location address.
  • location_suburb (string) – location suburb.
  • location_region (string) – the region in slug format.
  • location_state (string) – state in slug format.
  • location_postcode (char4) – post code.
  • agency_employer_id (int) – for caller use (not used by AC)

Response

• response
  • success_count (int) – set to 1 if the query ran without errors.
  • error_count (int) – set to 1 if there was a query error.

Errors

• 201 – No valid type passed.
• 202 – Database query error – these should be reported.
• 203 – Database update error – these should be reported.

Notes

At this point, only limited data integrity checking is performed on the update operation, so it it is up to the developer to ensure that consistent data is provided in the fields. Also the latitude and longitude data normally associated with the location will not initially available in the API – but will soon follow.

Return to Employer API Update