JSON API » plugins » plugins/update

Updates an existing plugin.

Input parameters

Requires authentication and the plugins role privilege.

NameTypeDescriptionRequiredDefault value
auth_usernameStringAuthentication username.Yes
auth_passwordStringAuthentication password.Yes
idIntegerID of plugin to update.Yes
answerInteger1 to answer before executing, 0 not to. Setting to 0 may cause billing problems.NoCurrent value.
commandStringCommand to execute.NoCurrent value.
customerIntegerID of customer who may use this plugin. -1 for all.NoCurrent value.
descriptionStringDescription.NoCurrent value.
nameStringName.NoCurrent value.
panelInteger1 to display in control panel, 0 not to.NoCurrent value.
validationInteger1 to validate input then return, 0 for full action.No0

Responses

CodeDescription
201Input passed validation. Only returned if validation=1.
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 plugin does not exist.

Data returned

No data is returned.

Example: Changing the name

http://enswitch.example.com/api/json/plugins/update/?auth_username=user;auth_password=password;id=123;name=example

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

Change history

VersionChanges
3.13Function added.