This operation deactivates an organization.
Request
Syntax
POST webservice/organization/organizationId/action/deactivate HTTP/1.1 Host: host name Accept: application/xml | application/json Authtoken: authentication token Content-type: application/xml <deactivate_organization_template.xml>
where <webservice> is the root path used to route the API requests to the Web Server.
For more information, see Available Web Services for REST API.
Request Parameters
Name |
Description |
---|---|
organizationId |
The organization ID for the organization. If the organization ID is not known, use the GET Organization API to retrieve it. The organization ID is the ID in the shortName element. |
Request Headers
Name |
Description |
---|---|
Host |
The host name of the Web Server or the Command Center used in the API request. |
Accept |
The format of the response. Valid values are: application/xml or application/json. |
Authtoken |
The authentication token received after successfully logging on. For details on receiving an authentication token, see Authentication. |
Content-type |
The media type contained in the request body. |
Request Body
Download the XML file required for this request: deactivate_organization_template.xml. The following table displays the parameters for the request body.
Parameter |
Description |
Element |
---|---|---|
disableLogin |
The option to prevent users from logging on. Valid values are: 1, to prevent logging on 0, to allow logging on |
deactivateOptions |
disableBackup |
The option to prevent users from backing up data. Valid values are: 1, to prevent backup operations 0, to allow backup operations |
deactivateOptions |
disableRestore |
The option to prevent users from restoring data. Valid values are: 1, to prevent restore operations 0, to allow restore operations |
deactivateOptions |
Response
Response Parameters
Parameter |
Description |
Element |
---|---|---|
providerDomainName |
The domain name associated with the organization. |
entity |
providerId |
The system-generated ID assigned to the organization. |
entity |
Examples
Sample Request
POST webservice/organization/1/action/deactivate HTTP/1.1
Host: client.mydomain.com
Accept: application/xml
Authtoken: QSDK 38568012f4d1e8ee1841d283a47aa3ba78e124ea58354b5fc60f4dab8a63347d05cf5552484dafda3bfa4c5db84e580b1cb37bcf8e65b39f7f8549a443e6f78a2c7be3f31b3d845e24776c835e498e8e883bb40c46bd15af4f40ca94e823acedcdd4e9659e74b34a07a85c4586cd2ed914b6dce015874783ef768fda78183a4208930954a377f66eb56c8b92cexampl4s437a19317ca6ce7f3233d5a01aca35dbad93468b833f2cf71010809006a937670adce711ca8be46638e8
Content-type: application/xml
<Api_DeactivateOrganizationRequest> <deactivateOptions disableLogin="0" disableBackup="1" disableRestore="0"/>
</Api_DeactivateOrganizationRequest>
Sample Response
<?xml version="1.0" encoding="UTF-8" standalone="no" ?>
<Api_DeactivateOrganizationResponse> <processinginstructioninfo> <attributes name="exitval" value="0"/> </processinginstructioninfo> <response errorCode="0"> <entity GUID="" _type_="61" providerDomainName="mycompany" providerId="1"/> </response>
</Api_DeactivateOrganizationResponse>