JSON API » people » people/delete

Deletes a person, and optionally any features they own.

Input parameters

Requires authentication and the administrator or wholesale role privileges.

NameTypeDescriptionRequiredDefault value
auth_usernameStringAuthentication username.Yes
auth_passwordStringAuthentication password.Yes
idIntegerID of person to delete.Yes
featuresInteger1 to also delete any features this person owns, 0 not to.No0

Responses

CodeDescription
204Success.
400Invalid input parameters specified. Check the key and message fields for more details.
401The authentication details provided are invalid.
402Your role does not allow this.
404The person does not exist, or you do not have permission to delete them.

Data returned

No data is returned.

Example: With required parameters

http://enswitch.example.com/api/json/people/delete/?auth_username=user;auth_password=password;id=123

{ "responses":[ { "code":"204", "key":"", "message":"OK" } ] }

Change history

VersionChanges
3.13Function added.