Password management

Manage all your passwords in your Vault account.

The following API operations are supported:

  • Create a new password
  • Update password
  • Get passwords
  • Get password with ID
  • Sharing a password with multiple users
  • Bulk share passwords with users
  • Bulk share passwords with user groups
  • Sharing passwords with third-parties
  • Sharing a password with a user
  • Get user sharing details for passwords
  • Update user sharing details for passwords
  • User group sharing details for a password
  • Update user group sharing details for a password
  • Delete a password

Create a new password

Create a new password in your Vault account.

OAUTH Scope

ZohoVault.secrets.CREATE

CopiedPOST /api/rest/json/v1/secrets

Request Example

Copied$ curl https://vault.zoho.com/api/rest/json/v1/secrets \
    -H "Content-Type: application/json;charset=UTF-8"\
    -H "Authorization: Zoho-authtoken <YourValidAuthtoken>"\
    -d 'INPUT_DATA
    {
	  "secrettypeid": "1000000004293",
	  "secretname": "Password Name",
	  "logo": "",
	  "policyid": "1000000000041",
	  "classification": "E",
	  "isshared": "YES",
	  "secretdata": {
	    "username": "QAHvqSPqglkxJKnDgq4=",
	    "password": "QAEMRCPqgln0Fh6W/LI=",
	    "file": "2gKN1MWdgVk="
	  },
	  "securenote": "QQHI6yPqglk=",
	  "customcolumnnew": "eyJjdXN0b21jb2wiOltdfQ==",
	  "files": [],
	  "chamberid": "1000000023041",
	  "totp": "xAEfLLiU4me07/3ZlxznoGg2WlrNM80wsqNuBjP6CBPh6K/i+nceCyTUpQbhalrs=",
	  "description": "Description of Password",
	  "secreturls": [
	    "https://zilkar.com/"
	  ],
	  "tags": "tags"
	}'

Response Example

CopiedHTTP/1.1 201 Created
Content-Type:application/json;charset=UTF-8
{
	"totp": "xAEfLLiU4me07/3ZlxznoGg2WlrNM80wsqNuBjP6CBPh6K/i+nceCyTUpQbhalrs=",
	"notes": "QQHI6yPqglk=",
	"accesssctrlconfigured": "false",
	"accounttype": "1000000004293",
	"description": "Description of Password",
	"istrashed": false,
	"userid": 2000000000392,
	"secretData": "{\"password\":\"QAEMRCPqgln0Fh6W/LI=\",\"file\":\"2gKN1MWdgVk=\",\"username\":\"QAHvqSPqglkxJKnDgq4=\"}",
	"displayaccctrlicon": false,
	"isfavourites": false,
	"secreturl": "https://zilkar.com/",
	"policyid": "1000000000041",
	"autosubmit": true,
	"encdescription": "",
	"onetimeacess": false,
	"sharinglevel": 10,
	"secretmultipleurl": [
		"https://zilkar.com/"
	],
	"changepassword": false,
	"isshared": "YES",
	"customcolumn": "eyJjdXN0b21jb2wiOltdfQ==",
	"secretid": "2000000015007",
	"encsecretname": "",
	"classification": "E",
	"passwordmodifiedtime": 1742902457656,
	"ownerdetails": {
		"USERNAME": "John",
		"EMAIL": "john@zylker.com"
	},
	"autologon": false,
	"tags": "tags",
	"accesscontrolconfigured": "false",
	"POLICYID": "1000000000041",
	"creationtime": 1742902457656,
	"secretname": "Password Name"
}

Update passwords

Update the existing passwords in your Vault account.

OAUTH Scope

ZohoVault.secrets.UPDATE

CopiedPUT /api/rest/json/v1/secrets/{secretid}

Request Example

Copied$ curl https://vault.zoho.com/api/rest/json/v1/secrets/{secretid} \
    -H "Content-Type: application/json;charset=UTF-8" \
    -H "Authorization: Zoho-authtoken <YourValidAuthtoken>" \
    -d 'INPUT_DATA
{
 "secertdata":{
  "password":"QAEMRCPqgln0Fh6W/LI=",
  "file":"2gKN1MWdgVk=",
  "username":"QAHvqSPqglkxJKnDgq4="
 },
 "secretname":"Secret Name",
 "classification":"E",
 "securenote":"QQHI6yPqglk=",
 "tags":"tags",
 "description":"description about secret",
 "passwordmodified":false,
 "policyid":"1000000000041",
 "secreturl":"https://tumbler.com",
 "secreters":["https://tumbler.com"],
"secrettypeid":"1000000004293"
}'

Get passwords

View the existing passwords in your Vault account.

Arguments

  • isAsc - for sorting order on password name*
  • passwordName - if you are searching for a password with its' name
  • pageNum - Page Number*
  • rowPerPage - Rows per pages*
  • filter - any of the following [OWNED_BY_ME, RECENTLY_USED, MOST_USED, FAVOURITE, SHARED_BY_ME, SHARED_TO_ME, ALL_SHARED, PERSONAL, RECENTLY_ADDED, ENTERPRISE]
  • passwordType - Password Type ID
  • chamberId - folder ID

OAUTH Scope

ZohoVault.secrets.READ

CopiedGET /api/rest/json/v1/secrets

Response Example

CopiedHTTP/1.1 200 OK
Content-Type:application/json;charset=UTF-8
{
"operation":
{
"result":
{
"message": "",
"status": "Success"
}
,
"Details": [

{
"changepassword": false,
"issharedtousers": false,
"notes": "bQEPkfCpgVnSO2CSRHPVTEvqpnGv3GKonaH+wyAjGImu",
"isshared": "YES",
"accesssctrlconfigured": "false",
"accounttype": "2000000000015",
"secretid": "2000000015007",
"classification": "E",
"userid": "2000000000384",
"secretData": "{"password":"bAH0OPCpgVmpgls=","file":"","username":"bAEhrPCpgVkePKIrQA=="}",
"autologon": false,
"displayaccctrlicon": false,
"isfavourites": false,
"secreturl": "http://URL",
"policyid": "null",
"autosubmit": true,
"onetimeacess": false,
"sharinglevel": 10,
"requeststatus": -1,
"secretname": "ZohoVaultTestSecret 08"
}
,

{
"changepassword": false,
"issharedtousers": false,
"notes": "",
"isshared": "YES",
"accesssctrlconfigured": "false",
"accounttype": "2000000000015",
"secretid": "2000000015009",
"classification": "E",
"userid": "2000000000384",
"secretData": "{"password":"cQHB6fCpgVntzpjb4j4NWXyK","file":"","username":"cQGwCvCpgVkSAggiUw=="}",
"autologon": false,
"displayaccctrlicon": false,
"isfavourites": false,
"secreturl": "http://autologonurl.com",
"policyid": "null",
"autosubmit": true,
"onetimeacess": false,
"sharinglevel": 10,
"requeststatus": -1,
"secretname": "File attachment"
}
,

{
"changepassword": false,
"issharedtousers": false,
"notes": "fwGfiPCpgVlIa2mR5McwmOxzJ6lQZtIBbVo7/U/K/GH6AnHf0qcRySpCwQRaVzXgFfV+9SHY1VHeRFFf+eQHzX+P4hoSI94NqGpZbSppk9FYd2SStIAOUwsvgdEDzdA5nmoyeLr5ebxkI7Hq7xonL3iRQBzArl6cTHEOoQwjNN9vTpNbZj1IeG0X3Da2fzUQ8PmrTpMnBZF1iAbGh0i8WcjVCCz6ohRPTYON8kZ3w1lwWW4y50zYoJfYPX4rPyKWi9v3fdccVJ+vG7+/76vzZGeMrKkVaxIVRDmRfjmsj6/A1cR1ytBSEcIBp8GUnkqW9UnwX/iKWQ3psVf7f1iRBA1wHNjYdWM6in2FTcvB1CuQ4KFb1fiugvoq6PtMJosNqrYTuifYnzJEh1MCE0zCokohdnfVCoBYuTAnCyNEcI/lK37dncLAOJt7+9/Wk0lV32yC8VvDWAjdVOLYFr/HYNOftceVh/NnrmbReyJek54Y9DR5JZz1GDkeTi6eYfUB1HOcLPoHi+eH5pG9ggWgO2fsLBrXZgV+ZjVsOcP5YL+efWE75vyxDpLTM8SgeKHULB81uSRZy/RpvCI2HG3CAdzkhJ32y7neyAEBVtbrb640fzValUcT00DbmUqEWV1reWSJUG8bIDbVQAigZDbil8jpr+c/8bb3E2h7zt3CSxTVdsTxWT7ephvOvlrj7E7+Gc4YjIXyCkQwAntN3DRxHxI=",
"isshared": "YES",
"accesssctrlconfigured": "false",
"accounttype": "2000000000015",
"secretid": "2000000015011",
"classification": "E",
"userid": "2000000000384",
"secretData": "{"password":"fwG+QfCpgVn2p6UhIr+fCfU=","file":"","username":"fwHRmPCpgVlJN7qHRlCqJcmuiRaF"}",
"autologon": false,
"displayaccctrlicon": false,
"isfavourites": false,
"secreturl": "http://accounts.csez.zohocorpin.com",
"policyid": "null",
"autosubmit": true,
"onetimeacess": false,
"sharinglevel": 10,
"requeststatus": -1,
"secretname": "Aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
}
,

{
"changepassword": false,
"issharedtousers": false,
"notes": "",
"isshared": "YES",
"accesssctrlconfigured": "false",
"accounttype": "2000000000015",
"secretid": "2000000015013",
"classification": "E",
"userid": "2000000000384",
"secretData": "{"password":"iAGdn/CpgVniZpq4LcRsXiaG","file":"","username":"iAFQjfCpgVlsEPlhaw=="}",
"autologon": false,
"displayaccctrlicon": false,
"isfavourites": false,
"secreturl": "http://accounts.zoho.com",
"policyid": "null",
"autosubmit": true,
"onetimeacess": false,
"sharinglevel": 10,
"requeststatus": -1,
"secretname": "One"
}
,

{
"changepassword": false,
"issharedtousers": false,
"notes": "",
"isshared": "YES",
"accesssctrlconfigured": "false",
"customcolumn": "eyJjdXN0b21jb2wiOlt7ImNvbG5hbWUiOiJOL0EiLCJ2YWx1ZSI6Imp3RmlXUENwZ1ZsWkZteDJtSXJ5bXdlcXg1NzBkUT09IiwidHlwZSI6InRleHQifSx7ImNvbG5hbWUiOiJOL0EiLCJ2YWx1ZSI6Imp3R3BQL0NwZ1ZsbXZnPT0iLCJ0eXBlIjoidGV4dCJ9XX0=",
"accounttype": "2000000000015",
"secretid": "2000000015015",
"classification": "E",
"userid": "2000000000384",
"secretData": "{"password":"kQGUrvCpgVkBvjzqZRcwJw==","file":"","username":"kQEBJfCpgVkNENMIVNd1YunXPDgs"}",
"autologon": false,
"displayaccctrlicon": false,
"isfavourites": false,
"secreturl": "http://facebook.com/login.php",
"policyid": "null",
"autosubmit": true,
"onetimeacess": false,
"sharinglevel": 10,
"requeststatus": -1,
"secretname": "vault-test-lap"
}

Get passwords with ID

View existing passwords in Vault account with your password ID.

OAUTH Scope

ZohoVault.secrets.READ

CopiedGET /api/rest/json/v1/secrets/{secretid}

Response Example

CopiedHTTP/1.1 200 OK
Content-Type:application/json;charset=UTF-8
{
"operation":
{
"result":
{
"message": "",
"status": "Success"
}
,

"Details": [

{
"issharedtousers": true,
"notes": "GwDxdmqqgVk=",
"isshared": "YES",
"accesssctrlconfigured": "false",
"accounttype": "2000000000015",
"secretid": "2000000015041",
"classification": "E",
"userid": "2000000000392",
"secretData": "{"password":"GwCXgmqqgVlCp4dXAaEA2UTB","file":"GwDJ+GqqgVk=","username":"GwB+wGqqgVlzuHuG+g=="}",
"autologon": false,
"tags": "",
"isfavourites": false,
"secreturl": "http://accounts.zoho.com",
"autosubmit": true,
"sharinglevel": 30,
"secretname": "One"
}

],

"name": "GET_SECRET"
}

}

Sharing passwords with a user

Share passwords with a user in your Vault account.

OAUTH Scope

ZohoVault.secrets.UPDATE

Request Example

Copied$ curl https://vault.zoho.com/api/rest/json/v1/sharing/secret/bulkshare/{userid} \
    -H "Content-Type: application/json;charset=UTF-8" \
    -H "Authorization: Zoho-authtoken <YourValidAuthtoken>" \
    -d 'INPUT_DATA=
{
"logonsecrets" : JSONArray,
"viewsecrets" : JSONArray,
"modifysecrets" : JSONArray,
"managesecrets" : JSONArray
}
secrets - array of Secret Objects (need to be sent if secret is not encrypted with org key)
[{"changepassword":false,"issharedtousers":false,"notes":"0gN23IMvGls=","isshared":"YES","accesssctrlconfigured":"false","customcolumn":"eyJjdXN0b21jb2wiOlt7ImNvbG5hbWUiOiJmaWxlIiwidmFsdWUiOiIwZ1Bnem9NdkdsdnA2Njl1NjM3c3NyWHAvR0hTU2o4dUNDWT0iLCJ0eXBlIjoiZmlsZSIsImlkIjoiY3VzdENvbERpdl8wIn1dfQ==","accounttype":"151000000000015","secretid":"151000000221027","description":"","classification":"E","userid":"151000000009003","secretData":"{\"password\":\"sAMIMIMvGlt843HDe43yAAuFdA==\",\"file\":\"0QM0ooMvGlv2kp2I\",\"username\":\"0QMtbIMvGlumrb6FJyrV\"}","autologon":false,"displayaccctrlicon":false,"isfavourites":false,"secreturl":"","policyid":"151000000000051","autosubmit":true,"onetimeacess":false,"sharinglevel":10,"files":"[{\"expirydate\":\"\",\"size\":4937,\"name\":\"check.html\",\"column\":\"file\",\"fileId\":\"151000000221029\"},{\"expirydate\":\"\",\"size\":66677,\"name\":\"TBTAM00628340000002462.pdf\",\"column\":\"customattrivalue_0\",\"fileId\":\"151000000221030\"}]","requeststatus":-1,"secretname":"!!!file"}]

Response Example

CopiedHTTP/1.1 200 OK
Content-Type:application/json;charset=UTF-8
{
    "operation": {
        "result": {
            "message": "Secret shared with the user.",
            "status": "Success"
        },
        "Details": {
            "secretArray": [
                {
                    "notes": "0gN23IMvGls=",
                    "accesssctrlconfigured": "false",
                    "accounttype": "151000000000015",
                    "description": "",
                    "userid": "151000000009003",
                    "secretData": "{\"password\":\"sAMIMIMvGlt843HDe43yAAuFdA==\",\"file\":\"0QM0ooMvGlv2kp2I\",\"username\":\"0QMtbIMvGlumrb6FJyrV\"}",
                    "displayaccctrlicon": false,
                    "isfavourites": false,
                    "secreturl": "",
                    "policyid": "151000000000051",
                    "autosubmit": true,
                    "onetimeacess": false,
                    "sharinglevel": 10,
                    "sharingtype": "SHARED_BY_ME",
                    "lastmodifiedtime": 1528442421725,
                    "changepassword": false,
                    "issharedtousers": true,
                    "isshared": "YES",
                    "customcolumn": "eyJjdXN0b21jb2wiOlt7ImNvbG5hbWUiOiJmaWxlIiwidmFsdWUiOiIwZ1Bnem9NdkdsdnA2Njl1NjM3c3NyWHAvR0hTU2o4dUNDWT0iLCJ0eXBlIjoiZmlsZSIsImlkIjoiY3VzdENvbERpdl8wIn1dfQ==",
                    "secretid": "151000000221027",
                    "passwordmodifiedtime": 1528441499471,
                    "classification": "E",
                    "autologon": false,
                    "tags": "",
                    "POLICYID": "151000000000051",
                    "files": "[{\"expirydate\":\"\",\"size\":4937,\"name\":\"check.html\",\"column\":\"file\",\"fileId\":\"151000000221029\"},{\"expirydate\":\"\",\"size\":66677,\"name\":\"TBTAM00628340000002462.pdf\",\"column\":\"customattrivalue_0\",\"fileId\":\"151000000221030\"}]",
                    "creationtime": 1528441499471,
                    "secretname": "!!!file"
                }
            ]
        },
        "name": "SHARE_SECRETS_TO_USER"
    }
}

Bulk share passwords with users

Share passwords with users in bulk.

OAUTH Scope

ZohoVault.secrets.READ

CopiedPUT /api/rest/json/v1/sharing/secret/users/bulkshare

Request Example

Copied$ curl https://vault.zoho.com/api/rest/json/v1/sharing/secret/users/bulkshare \
    -H "Content-Type: application/json;charset=UTF-8" \
    -H "Authorization: Zoho-authtoken <YourValidAuthtoken>" \
    -d 'INPUT_DATA= {
   "secretids":[

   ],
   "INPUT_DATA":{
      "viewusers":[

      ],
      "logonusers":[

      ],
      "modifyusers":[

      ],
      "manageusers":[

      ]
   }
}'

Bulk share paswords to user groups

Share passwords with user groups in bulk.

OAUTH Scope

ZohoVault.secrets.READ

CopiedPUT /api/rest/json/v1/sharing/secret/usergroup/bulkshare

Request Example

Copied$ curl https://vault.zoho.com/api/rest/json/v1/sharing/secret/usergroup/bulkshare \
    -H "Content-Type: application/json;charset=UTF-8" \
    -H "Authorization: Zoho-authtoken <YourValidAuthtoken>" \
    -d 'INPUT_DATA= {
   "secretids":[

   ],
   "INPUT_DATA":{
      "viewusers":[

      ],
      "logonusers":[

      ],
      "modifyusers":[

      ],
      "manageusers":[

      ]
   }
}'

Sharing password with third-parties

Share passwords with third-parties.

OAUTH Scope

ZohoVault.secrets.CREATE

CopiedPOST /api/rest/json/v1/sharing/secret/outsider/{secretid}

Request Example

Copied$ curl https://vault.zoho.com/api/rest/json/v1/sharing/secret/outsider/{secretid} \
    -H "Content-Type: application/json;charset=UTF-8" \
    -H "Authorization: Zoho-authtoken <YourValidAuthtoken>" \
    -d 'INPUT_DATA= "keyAuth":"QQGhdYYsPVodnktuy5HgKvmAbvxEt6lpOVpB6ouPxQiLYrPiNY
r4oZhw+BLEamYSF7ZSUG/394qb3BTcfhjN+gDgoPeoUx00FWohdpBTzkpefAZ
/Up+mDVdtIBbMFDRDz3jslF8bZ9uNowQz4eKsuNiyT96O4Y1irE9t+WZePKsf2
iBviGgFvC7A4MjJ8rCLajBz1VGtBCCVlOVA67CWObv7HBKvF2V0UQdD9rXTlD8  vdTJn3KclzKOfYZFARRAIl5FgR4i7bARdvPqw150X+G0JfVefZX4T7Lr++K5RMJ 3ChFwOV/VtzbQmHfx3J/PJ08PLUDtLp/VJVNfwXJB5sb/famNrDCENC3T0g/WZ0 kkqDvsvlK3qFi62+BG8Wsq3vR56suU/bf4Kb85HLs/jgmrz881NCPdnd1mq2JUSPc   deS+0WXrbkyQSlfrkLGRHY1kX5xsP9H5rU/yExG2rMqrqMmB2N1dXuBoiwctseXJ    BaVJ+CMHqF8gvQm/VFlW03cg51P+lZz2E8NhMbx5mqRSD/24Gwa/LslrbJepEhZc
        ea0i6QkVIdGeeuYOuCLN0RCEF5+SJfTyR51UNbxN2cKbAq",
        "salt":"03d32b3815372059a736e3650ddba4ef",
        "iteration":"1000",
        "email":"john@zylker.com",
        "message":"secret sharing",
        "file":"[{'name':'Screen Shot 2017-12-22 at 4.28.48 PM.png','column':'file',
        'size':90731,'secretID':'1000000003009','data':'U2FsdGVkX1+RteXmvh
        c4QGRIqpiulnSgu5Ed9FGU2aS8nTT0BuibwBpTRgt1KhBSnethPJiQt6AbaYbleIONK+    9SK96q4ATmD4TCUvI4Q8xvvJJGs7PcrV8m21PlJYvJJmPcFFbsqyWo4y1QxgAjH6jJFLk   0yw0MNYFgRjr18qQHMB9RxJA9oVD6sGRmpeOIHsHLK6KUP4rJPE+ZneXhnrluWiiPkdwJRKEOez2    85aCjVee5uklq4FxlAXBByn/acM82WiSs8CkLtHs3ym2f66HV8eJgrcbI26TQUub3MvkJ0Fp/Vjcu   sH4I+1tIMxHO9nUOkFnWIa5b10NkcTSnzYi58ofdsoKYB4LenxLFGs9FWbub7IJ2K7iVRlqW2oV+UKL 6QcRsnDxUBZEh4MgO/xTSQqGKF1hfxV7F2xKIH/89bHSzeGSjd4gX8sEI9sNZPHpLncfMoDHxfo78Yy
        cZ0hKMbUaYagQh7uqHQuSknNWTtoIJP0erJLpZYO3GQiOGaMu18YrEJblTAeckRUvqg6zWNe7f3Tpo7 J2dcNMbwGAprKoiJ2M7gDY97lBgDKCa+bvIkIVOJxQ5lmNgmiSG28/m1njIYCaZFmb8Y9LovezC7sK  XA5edKjY9S4IZfzitluT61/fBDr/iqbE7Tz/C0jfYnpAWMffIIkv73AXC29GZgQZWqL9WUbAOiaOfb  HLXWxyBcAF/OynGxQ3c5aELBP+sleqKrbjhOyULd3eRL4cwu8wCQB59KdKq7P8IJHVwaC2V8xyyVm0t SEUFgpal5nEX+6dY0v8sYXaDrYvAu2Uz6/CcqNbgdw5XrxaHhE+kDjVe8asUFEyS4qZsT4nqeqlI9vRt    iSD7gVb5jwGoqD6ap7SGklwh9vKD8Fl/v+JqzzJIj+oUxc4KjnDA+JWG3hfryyzQaCZfKV9YDRouIPxAFC  QKLkKAHsg1Eu3CplolmQWjVFYidYhl12hm5C46hggNEOLrIlFHvcbxhzHBR22iQH2H4vdPZV8JKxD77qq   41ymQxUzQDCmSJ75d4SEvt0IXw+dQuGGT1PV4HZVXwmM0MqKnVXoRVWAO9nlmYfS3qfa2QxExbY5lfpERMq SngfTsZkqOJyM5Y4UzitXopLqx16TFk8ot12cVn6WRdkP+EK5W7/Y+StS4omqF3ICFnMOX4/ZATY78wQcHxy    6Yqyo3/3xeEaTUHpzYI8n7o3l3x2rxhmmRd8B32u3sBf2KzGR7z0SywO+dR99Gvc5EBqiuLl73mYsxBMr/K0qw
        BVmu+1UIw/fFOZMN1XuoqWN6v2E2xL8iiDWYaAdLvRq+Z6r0fQnXvWWPLE6+8b'}]"'

Response Example

CopiedHTTP/1.1 200 OK
Content-Type:application/json;charset=UTF-8
{
        "operation":{
        "result":{
        "message":"",
        "status":"Success"
        },
        "Details":{
        "notes":"UAPZNXcsPVo=",
        "accesssctrlconfigured":"false",
        "accounttype":"1000000000015",
        "description":"",
        "userid":"1000000002001",
        "secretData":"{"password":"HAOLrXcsPVpx2HJVzPeZ","file":"TQNsJHcsPVohtTlq","username":"HAPXQ3csPVrEfEYd3g=="}",
        "displayaccctrlicon":false,
        "isfavourites":false,
        "secreturl":"",
        "policyid":"1000000000041",
        "autosubmit":true,
        "onetimeacess":true,
        "sharinglevel":10,
        "sharingtype":"SHARED_BY_ME",
        "lastmodifiedtime":1513958519916,
        "changepassword":false,
        "issharedtousers":true,
        "isshared":"YES",
        "customcolumn":"eyJjdXN0b21jb2wiOltdfQ==",
        "secretid":"1000000003009",
        "passwordmodifiedtime":1513957537802,
        "classification":"E",
        "autologon":false,
        "tags":"",
        "POLICYID":"1000000000041",
        "files":"[{"expirydate":"","size":90731,"name":"Screen Shot 2017-12-22 at 4.28.48 PM.png","column":"file","fileId":"1000000003028"}]",
        "creationtime":1513957537802,
        "secretname":"sample"
        },
        "name":"OUTSIDER_SHARING"
        }
}

Sharing a password with a user

Get the list of passwords shared to a specific user by email.

Arguments

  • isAsc - True/false
  • passwordName - For searching (optional)
  • pageNum - Page number
  • rowPerPage - Rows per page ### OAUTH Scope

ZohoVault.secrets.READ

CopiedGET /api/rest/json/v1/sharing/secret/sharedsecrets/{email}

Get user sharing details for passwords

Get all the user sharing details for the password.

OAUTH Scope

ZohoVault.secrets.READ

CopiedGET /api/rest/json/v1/sharing/secret/user/{secretid}

Response Example

CopiedHTTP/1.1 200 OK
Content-Type:application/json;charset=UTF-8
{
"operation":
{
"result":
{
"message": "",
"status": "Success"
}
,

"Details":
{
"viewusers": [],
"logonusers": [],
"modifyusers": [],
"notshared": [

{
"unique-id": "3322",
"enabled": 1,
"email": "john@zylker.com",
"user_auto_id": "2000000000390",
"username": "Johnny"
}
,


{
"unique-id": "404",
"enabled": 1,
"email": " john@zylker.com",
"user_auto_id": "2000000000394",
"username": "John"
}
,


{
"unique-id": "702",
"enabled": 1,
"email": " john@zylker.com",
"user_auto_id": "2000000000396",
"username": "John"
}

],

"ownerid": "2000000000392",
"secretname": "One",
"manageusers": [

{
"unique-id": "204",
"enabled": 1,
"email": "john@zylker.com",
"user_auto_id": "2000000000384",
"username": "John"
}

],

"secret_auto_id": "2000000015041"
}
,

"name": "GET_SECRET_USER_SHARING"
}

}

Update user sharing details for passwords

Update the user sharing details for the passwords.

OAUTH Scope

ZohoVault.secrets.UPDATE

CopiedPUT /api/rest/json/v1/sharing/secret/user/{secretid}

Request Example

Copied$ curl https://vault.zoho.com/api/rest/json/v1/sharing/secret/user/{secretid} \
    -H "Content-Type: application/json;charset=UTF-8" \
    -H "Authorization: Zoho-authtoken <YourValidAuthtoken>" \
    -d 'INPUT_DATA= INPUT_DATA- JSONObject
{
"logonusers" : JSONArray,
"viewusers" : JSONArray,
"modifyusers" : JSONArray,
"manageusers" : JSONArray
}'

User group sharing details for a password

Get the user group sharing details for a password.

OAUTH Scope

ZohoVault.secrets.READ

CopiedGET /api/rest/json/v1/sharing/secret/usergroup/(secretid)

Response Example

CopiedHTTP/1.1 200 OK
Content-Type:application/json;charset=UTF-8
{
"operation":
{
"result":
{
"message": "",
"status": "Success"
}
,

"Details":
{
"viewusers": [],
"logonusers": [],
"modifyusers": [],
"notshared": [

{
"usergroup_auto_id": "2000000018005",
"usergroupname": "Admins"
}

],

"ownerid": "2000000000392",
"secretname": "One",
"manageusers": [],
"secret_auto_id": "2000000015041"
}
,

"name": "GET_SECRET_USERGROUP_SHARING"
}

}

Update user group sharing details for a password

Update the user group sharing details for passwords.

OAUTH Scope

ZohoVault.secrets.UPDATE

CopiedPUT /api/rest/json/v1/sharing/secret/usergroup/{secretid}

Request Example

Copied$ curl https://vault.zoho.com/api/rest/json/v1/sharing/secret/usergroup/{secretid} \
    -H "Content-Type: application/json;charset=UTF-8" \
    -H "Authorization: Zoho-authtoken <YourValidAuthtoken>" \
    -d 'INPUT_DATA= INPUT_DATA- JSONObject
{
"logonusers" : JSONArray,
"viewusers" : JSONArray,
"modifyusers" : JSONArray,
"manageusers" : JSONArray
}'

Delete a password

Delete a password from your Vault account.

OAUTH Scope

ZohoVault.secrets.DELETE

CopiedDELETE /api/rest/json/v1/secrets/{secretid}

Response Example

CopiedHTTP/1.1 200 OK
Content-Type:application/json;charset=UTF-8
{
"operation":
{
"result":
{
"message": "",
"status": "Success"
}
,

"Details": [
 "2000000015019"
],

"name": "DELETE_SECRET"
}
}