The Locations API is for administering Location records in Skills Base which includes adding, retrieving, updating and deleting records.
Endpoint
/1.0/locations
Objects used by this API
Location object
Name | Data type | Read only | Description |
id | integer | Yes | The unique identifier for the record, used to reference the record in other API interactions. |
name | string | No | Location name |
longitude | float | No | Longitude coordinate |
latitude | float | No | Latitude coordinate |
Methods
GET /locations
Returns all Locations in the instance.
GET /locations/:id
Returns a Location matching the given id
POST /locations/search
Searches Location records. See Search APIs for a description of search functionality.
The available search parameters are:
Name | Arrays | Wildcards |
id | Yes | No |
name | No | Yes |
POST /locations
Creates a new Location record.
The following parameters can be POSTed
Name | Required |
name | Yes |
longitude | Yes |
latitude | Yes |
PUT /locations/:id
Updates an existing Location record.
The following fields can be updated:
Name |
name |
longitude |
latitude |
DELETE /locations/:id
Deletes a Location