member.delete
Description
Delete a single member object. Please see Deleting Objects for an overview of how the delete method works.
There are special considerations for deleting member objects, please understand them before calling this method. When a member object is deleted, the username associated with that member is not released. Therefore, any subsequence member.create for that same username will fail with a duplicate object error. See member.create.
Parameters
username
A string representing the unique id of the member to delete. You may also pass a json object with a field of id to identify the member you wish to delete.
Response
Delete returns null on success.
Examples
A Sample JSON-RPC Member Delete Request
{ "method": "member.delete", "params": ["example_username"], "id": 1 }
The JSON-RPC Response
{ "result": true, "error": null, "id": 1 }
Permissions Required
The user who owns the key used to authenticate the member.delete call must be a member of one of the following roles
- Administrator
- Program Manager
- Community Manager
See authentication.
Errors
In addition to the standard json-rpc errors and authentication errors, member.delete may also return these errors:
500 | 2003 | Delete Failed | The object could not be deleted. This is the error message of last resort for object deletions and usually indicates a systems integration failure, invalid internal data, or a transient issue. These errors are logged by Mashery. |
Docs Navigation
- API Documentation Portal
- IO Docs Definition
- Mashery API Documentation
- Mashery 3.0 API Guide
- Mashery 2.0 API Guide
- OAuth Supporting Methods
- Examples
- JSON RPC
- Authentication
- API Objects
- Fetching Objects
- Query Language
- Creating Objects
- Updating Objects
- Validating Fields
- Deleting Objects
- Applications
- General Object Methods
- Members
- Packages
- Plans
- Package Keys
- Keys
- Developer Classes
- Services
- Roles
- Mashery 2.0 Reporting API Guide
- Event Trigger API
- Differences between Roles and Portal Access Groups
- Managing a Portal Access Group Using Mashery V2 or V3 API
- Mashery Reporting Event Post API Guide
- Tips and Tricks
- Your Portal
- API Traffic Manager
- I/O Docs WSDL requirements