{ "item": [ { "id": "b078842d-46b3-4c96-8f37-283d99badddd", "name": "Spaces", "description": { "content": "Create, read, duplicate, and update spaces, and resolve a user's role within them.", "type": "text/plain" }, "item": [ { "id": "3d0d98d0-6f49-4f11-9e48-3b3e76d79e46", "name": "Duplicate a space", "request": { "name": "Duplicate a space", "description": {}, "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "duplicate" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "Vani.teams.UPDATE Vani.spaces.UPDATE Vani.spaces.DELETE Vani.zones.READ Vani.editions.UPDATE Vani.spaces.CREATE Vani.teams.CREATE Vani.spaces.READ Vani.editions.CREATE Vani.zones.CREATE Vani.teams.READ Vani.editions.READ Vani.teams.DELETE" }, { "key": "accessTokenUrl", "value": "https://accounts.zoho.com/oauth/v2/token" }, { "key": "authUrl", "value": "https://accounts.zoho.com/oauth/v2/auth" }, { "key": "grant_type", "value": "authorization_code" } ] }, "body": { "mode": "raw", "raw": "{\n \"duplicate_space\": {\n \"space_name\": \"ꄬ襉\",\n \"deep_copy\": true,\n \"team_id\": \"string\",\n \"copy_members\": false,\n \"copy_comments\": false\n }\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "c0669893-6aa6-4d97-8a40-0a48e9139540", "name": "Successful response", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "duplicate" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"duplicate_space\": {\n \"space_name\": \"ꄬ襉\",\n \"deep_copy\": true,\n \"team_id\": \"string\",\n \"copy_members\": false,\n \"copy_comments\": false\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"space_info\": {\n \"created_time\": \"Sat, 08 Mar 2025, 17:40:07\",\n \"last_modified_time\": \"Sat, 08 Mar 2025, 17:40:07\",\n \"is_favorite\": \"false\",\n \"space_name\": \"Vision board - 1\",\n \"publish\": \"false\",\n \"owner_zuid\": \"80215739\",\n \"can_edit\": \"true\",\n \"team_id\": \"3009000000002003\",\n \"allow_embed\": \"false\",\n \"space_id\": \"3009000000239341\",\n \"last_author_zuid\": \"80215739\",\n \"status\": \"ACTIVE\"\n }\n },\n \"message\": \"Space duplicated successfully\",\n \"request_uri\": \"/vani/api/v1/editions/96499735/spaces/3009000000232005/duplicate\",\n \"status\": \"success\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d70675ad-c065-4e83-83f7-851b70e60e09", "name": "Invalid request - validation failed", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "duplicate" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"duplicate_space\": {\n \"space_name\": \"ꄬ襉\",\n \"deep_copy\": true,\n \"team_id\": \"string\",\n \"copy_members\": false,\n \"copy_comments\": false\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"details\": {\n \"sdk_error_code\": \"string\",\n \"error_code\": \"string\",\n \"message\": \"string\"\n }\n },\n \"request_uri\": \"string\",\n \"status\": \"string\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a77ba21b-79ae-4a9e-a05f-bbb61af8df93", "name": "Unauthorized - missing or invalid access token", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "duplicate" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"duplicate_space\": {\n \"space_name\": \"ꄬ襉\",\n \"deep_copy\": true,\n \"team_id\": \"string\",\n \"copy_members\": false,\n \"copy_comments\": false\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"details\": {\n \"edition_id\": \"96499735\",\n \"current_user_id\": \"80215739\",\n \"error_code\": \"A1003\",\n \"message\": \"The user doesn't have permission to perform this action\",\n \"space_id\": \"3009000000093003\"\n }\n },\n \"request_uri\": \"/vani/api/v1/editions/96499735/spaces/3009000000093003/duplicate\",\n \"status\": \"error\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "09176fa7-e4ca-4a4d-9381-b878f7b9c6ab", "name": "Not found - a resource named in the path does not exist, or is not visible to the caller", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "duplicate" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"duplicate_space\": {\n \"space_name\": \"ꄬ襉\",\n \"deep_copy\": true,\n \"team_id\": \"string\",\n \"copy_members\": false,\n \"copy_comments\": false\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"details\": {\n \"edition_id\": \"96499735\",\n \"current_user_id\": \"80215739\",\n \"error_code\": \"S1009\",\n \"message\": \"Space not found\",\n \"space_id\": \"300900000093003\"\n }\n },\n \"request_uri\": \"/vani/api/v1/editions/96499735/spaces/300900000093003/duplicate\",\n \"status\": \"error\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a15b6cf6-dc9e-470f-97a8-3822aef05271", "name": "Rate limit exceeded - this operation allows 30 requests per minute per user", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "duplicate" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"duplicate_space\": {\n \"space_name\": \"ꄬ襉\",\n \"deep_copy\": true,\n \"team_id\": \"string\",\n \"copy_members\": false,\n \"copy_comments\": false\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"details\": {\n \"sdk_error_code\": \"string\",\n \"error_code\": \"string\",\n \"message\": \"string\"\n }\n },\n \"request_uri\": \"string\",\n \"status\": \"string\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "645753dc-2b29-4972-a812-488476a3ba40", "name": "Internal server error - the request was well-formed but could not be completed", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "duplicate" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"duplicate_space\": {\n \"space_name\": \"ꄬ襉\",\n \"deep_copy\": true,\n \"team_id\": \"string\",\n \"copy_members\": false,\n \"copy_comments\": false\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"details\": {\n \"sdk_error_code\": \"string\",\n \"error_code\": \"string\",\n \"message\": \"string\"\n }\n },\n \"request_uri\": \"string\",\n \"status\": \"string\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "8bd15240-c7d2-4618-914b-345f7121232f", "name": "Get a space", "request": { "name": "Get a space", "description": {}, "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "key": "fields", "value": "last_published_time", "description": "Specifies the fields (comma-separated) to retrieve. Allowed values: space_name, space_id, owner_zuid, team_id, last_author_zuid, created_time, last_modified_time, last_saved_version, publish, published_version_id, last_published_time, thumb_image_id, client_import_id, is_private_space, file_size, allow_embed, status, can_edit, is_favorite, space_member_count, state_modified_time, uri, open_url" } ], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "Vani.teams.UPDATE Vani.spaces.UPDATE Vani.spaces.DELETE Vani.zones.READ Vani.editions.UPDATE Vani.spaces.CREATE Vani.teams.CREATE Vani.spaces.READ Vani.editions.CREATE Vani.zones.CREATE Vani.teams.READ Vani.editions.READ Vani.teams.DELETE" }, { "key": "accessTokenUrl", "value": "https://accounts.zoho.com/oauth/v2/token" }, { "key": "authUrl", "value": "https://accounts.zoho.com/oauth/v2/auth" }, { "key": "grant_type", "value": "authorization_code" } ] } }, "response": [ { "id": "03ff89ff-33b9-42cd-9f0e-52d64829762a", "name": "Successful response", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "fields", "value": "last_published_time" } ], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"space_info\": {\n \"is_favorite\": \"false\",\n \"can_edit\": \"true\",\n \"team_id\": \"1303000000002003\"\n }\n },\n \"message\": \"Space fetched successfully.\",\n \"request_uri\": \"/vani/api/v1/editions/60029715808/spaces/1303000000492291\",\n \"status\": \"success\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6d6a17d8-d4d6-49f1-a7b7-284051127328", "name": "Invalid request - validation failed", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "fields", "value": "last_published_time" } ], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"details\": {\n \"sdk_error_code\": \"string\",\n \"error_code\": \"string\",\n \"message\": \"string\"\n }\n },\n \"request_uri\": \"string\",\n \"status\": \"string\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c06e68df-2fba-4205-803a-c20132c1fad6", "name": "Unauthorized - missing or invalid access token", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "fields", "value": "last_published_time" } ], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"details\": {\n \"current_user_id\": \"96384499\",\n \"error_code\": \"A1003\",\n \"message\": \"The user doesn't have permission to perform this action\"\n }\n },\n \"request_uri\": \"/vani/api/v1/editions/96499735/spaces/300900000009300\",\n \"status\": \"error\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "be43fc86-b96b-48fa-816b-2b9e3d433b97", "name": "Not found - a resource named in the path does not exist, or is not visible to the caller", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "fields", "value": "last_published_time" } ], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"details\": {\n \"sdk_error_code\": \"string\",\n \"error_code\": \"string\",\n \"message\": \"string\"\n }\n },\n \"request_uri\": \"string\",\n \"status\": \"string\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1b167146-00c3-48d6-9637-46308993ca4d", "name": "Rate limit exceeded - this operation allows 60 requests per minute per user", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "fields", "value": "last_published_time" } ], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"details\": {\n \"sdk_error_code\": \"string\",\n \"error_code\": \"string\",\n \"message\": \"string\"\n }\n },\n \"request_uri\": \"string\",\n \"status\": \"string\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0905ae5b-dfd2-49e0-958e-0d92063ab867", "name": "Internal server error - the request was well-formed but could not be completed", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "fields", "value": "last_published_time" } ], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"details\": {\n \"sdk_error_code\": \"string\",\n \"error_code\": \"string\",\n \"message\": \"string\"\n }\n },\n \"request_uri\": \"string\",\n \"status\": \"string\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "aac77324-d079-46cb-beae-888a156c09de", "name": "Get the current user's role in a space", "request": { "name": "Get the current user's role in a space", "description": {}, "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "users", "me", "permission" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "Vani.teams.UPDATE Vani.spaces.UPDATE Vani.spaces.DELETE Vani.zones.READ Vani.editions.UPDATE Vani.spaces.CREATE Vani.teams.CREATE Vani.spaces.READ Vani.editions.CREATE Vani.zones.CREATE Vani.teams.READ Vani.editions.READ Vani.teams.DELETE" }, { "key": "accessTokenUrl", "value": "https://accounts.zoho.com/oauth/v2/token" }, { "key": "authUrl", "value": "https://accounts.zoho.com/oauth/v2/auth" }, { "key": "grant_type", "value": "authorization_code" } ] } }, "response": [ { "id": "0c3ec20d-50af-4833-8902-18538fb82707", "name": "Successful response", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "users", "me", "permission" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"user_permission_info\": {\n \"edition_id\": \"96499735\",\n \"role\": \"CREATOR\",\n \"current_user_id\": \"96384499\",\n \"space_id\": \"3009000000093003\"\n }\n },\n \"message\": \"User permissions fetched successfully\",\n \"request_uri\": \"/vani/api/v1/editions/96499735/spaces/3009000000093003/users/me/permission\",\n \"status\": \"success\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9d48075e-74ff-45b4-bccf-eaf3f180824b", "name": "Invalid request - validation failed", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "users", "me", "permission" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"details\": {\n \"sdk_error_code\": \"string\",\n \"error_code\": \"string\",\n \"message\": \"string\"\n }\n },\n \"request_uri\": \"string\",\n \"status\": \"string\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bf4a0620-1f8c-4a94-a0da-75aef88ebb69", "name": "Unauthorized - missing or invalid access token", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "users", "me", "permission" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"details\": {\n \"sdk_error_code\": \"string\",\n \"error_code\": \"string\",\n \"message\": \"string\"\n }\n },\n \"request_uri\": \"string\",\n \"status\": \"string\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "35237964-fda8-4a1c-b2a7-cc84e3791ef2", "name": "Not found - a resource named in the path does not exist, or is not visible to the caller", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "users", "me", "permission" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"details\": {\n \"edition_id\": \"96499735\",\n \"current_user_id\": \"96384499\",\n \"error_code\": \"S1015\",\n \"message\": \"Member is not part of the Space\",\n \"space_id\": \"3009000000298005\"\n }\n },\n \"request_uri\": \"/vani/api/v1/editions/96499735/spaces/3009000000298005/users/me/permission\",\n \"status\": \"error\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bf4bbb40-f42c-412c-acc9-7aab6eaa71ed", "name": "Rate limit exceeded - this operation allows 60 requests per minute per user", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "users", "me", "permission" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"details\": {\n \"sdk_error_code\": \"string\",\n \"error_code\": \"string\",\n \"message\": \"string\"\n }\n },\n \"request_uri\": \"string\",\n \"status\": \"string\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f67727fd-26c4-49e5-8c40-dc6ebc9de56c", "name": "Internal server error - the request was well-formed but could not be completed", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "users", "me", "permission" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"details\": {\n \"sdk_error_code\": \"string\",\n \"error_code\": \"string\",\n \"message\": \"string\"\n }\n },\n \"request_uri\": \"string\",\n \"status\": \"string\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "a8aaf403-4f7a-4902-8d62-9b0985ea65ef", "name": "Get a user's role in a space", "request": { "name": "Get a user's role in a space", "description": {}, "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "users", ":user_id", "permission" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "disabled": false, "type": "any", "value": "string", "key": "user_id", "description": "(Required) The unique identifier of the user" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "Vani.teams.UPDATE Vani.spaces.UPDATE Vani.spaces.DELETE Vani.zones.READ Vani.editions.UPDATE Vani.spaces.CREATE Vani.teams.CREATE Vani.spaces.READ Vani.editions.CREATE Vani.zones.CREATE Vani.teams.READ Vani.editions.READ Vani.teams.DELETE" }, { "key": "accessTokenUrl", "value": "https://accounts.zoho.com/oauth/v2/token" }, { "key": "authUrl", "value": "https://accounts.zoho.com/oauth/v2/auth" }, { "key": "grant_type", "value": "authorization_code" } ] } }, "response": [ { "id": "05c45d20-a1b3-487a-be49-f479cf884a8c", "name": "Successful response", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "users", ":user_id", "permission" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "disabled": false, "type": "any", "value": "string", "key": "user_id", "description": "(Required) The unique identifier of the user" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"user_permission_info\": {\n \"edition_id\": \"96499735\",\n \"role\": \"EDITOR\",\n \"current_user_id\": \"96384499\",\n \"space_id\": \"3009000000303003\",\n \"zuid\": \"80215739\"\n }\n },\n \"message\": \"User permissions fetched successfully\",\n \"request_uri\": \"/vani/api/v1/editions/96499735/spaces/3009000000303003/users/80215739/permission\",\n \"status\": \"success\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5282e643-c4db-4dae-9bc8-34110c386de1", "name": "Invalid request - validation failed", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "users", ":user_id", "permission" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "disabled": false, "type": "any", "value": "string", "key": "user_id", "description": "(Required) The unique identifier of the user" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"details\": {\n \"sdk_error_code\": \"string\",\n \"error_code\": \"string\",\n \"message\": \"string\"\n }\n },\n \"request_uri\": \"string\",\n \"status\": \"string\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "84297ac2-52e1-4cb5-92d1-3f4500bbc2d1", "name": "Unauthorized - missing or invalid access token", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "users", ":user_id", "permission" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "disabled": false, "type": "any", "value": "string", "key": "user_id", "description": "(Required) The unique identifier of the user" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"details\": {\n \"edition_id\": \"96499735\",\n \"current_user_id\": \"96384499\",\n \"error_code\": \"S1020\",\n \"message\": \"User is not the owner of the Space\",\n \"space_id\": \"3009000000298005\"\n }\n },\n \"request_uri\": \"/vani/api/v1/editions/96499735/spaces/3009000000298005/users/80215739/permission\",\n \"status\": \"error\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ae904e6c-6b67-4695-98a0-db63f9983034", "name": "Not found - a resource named in the path does not exist, or is not visible to the caller", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "users", ":user_id", "permission" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "disabled": false, "type": "any", "value": "string", "key": "user_id", "description": "(Required) The unique identifier of the user" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"details\": {\n \"edition_id\": \"96499735\",\n \"current_user_id\": \"96384499\",\n \"error_code\": \"S1015\",\n \"message\": \"Member is not part of the Space\",\n \"space_id\": \"3009000000303003\",\n \"zuid\": \"80215739\"\n }\n },\n \"request_uri\": \"/vani/api/v1/editions/96499735/spaces/3009000000303003/users/80215739/permission\",\n \"status\": \"error\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3c2ef115-12c2-4b5f-b288-225a466fb9e1", "name": "Rate limit exceeded - this operation allows 60 requests per minute per user", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "users", ":user_id", "permission" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "disabled": false, "type": "any", "value": "string", "key": "user_id", "description": "(Required) The unique identifier of the user" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"details\": {\n \"sdk_error_code\": \"string\",\n \"error_code\": \"string\",\n \"message\": \"string\"\n }\n },\n \"request_uri\": \"string\",\n \"status\": \"string\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bcd68d42-c506-4426-9dd6-a86e44b8915a", "name": "Internal server error - the request was well-formed but could not be completed", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "users", ":user_id", "permission" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "disabled": false, "type": "any", "value": "string", "key": "user_id", "description": "(Required) The unique identifier of the user" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"details\": {\n \"sdk_error_code\": \"string\",\n \"error_code\": \"string\",\n \"message\": \"string\"\n }\n },\n \"request_uri\": \"string\",\n \"status\": \"string\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "b76bc56c-7eed-4223-bd3c-c3b78e0ad33e", "name": "Update space metadata", "request": { "name": "Update space metadata", "description": {}, "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "meta" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "Vani.teams.UPDATE Vani.spaces.UPDATE Vani.spaces.DELETE Vani.zones.READ Vani.editions.UPDATE Vani.spaces.CREATE Vani.teams.CREATE Vani.spaces.READ Vani.editions.CREATE Vani.zones.CREATE Vani.teams.READ Vani.editions.READ Vani.teams.DELETE" }, { "key": "accessTokenUrl", "value": "https://accounts.zoho.com/oauth/v2/token" }, { "key": "authUrl", "value": "https://accounts.zoho.com/oauth/v2/auth" }, { "key": "grant_type", "value": "authorization_code" } ] }, "body": { "mode": "raw", "raw": "{\n \"action_type\": \"FAVORITE\",\n \"space_name\": \"砮櫢䍟빨ỹ僛෨ͱ멘\",\n \"value\": false\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "e18e3561-4d99-4817-a07a-74daaf681ab7", "name": "Successful response", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "meta" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"action_type\": \"FAVORITE\",\n \"space_name\": \"砮櫢䍟빨ỹ僛෨ͱ멘\",\n \"value\": false\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"edition_id\": \"96499735\",\n \"current_user_id\": \"96384499\",\n \"is_favourite\": false,\n \"space_id\": \"3009000000141003\"\n },\n \"message\": \"Space meta updated successfully.\",\n \"request_uri\": \"/vani/api/v1/editions/96499735/spaces/3009000000141003/meta\",\n \"status\": \"success\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9b976465-0a63-4bd9-a758-34d1b58f6b0f", "name": "Invalid request - validation failed", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "meta" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"action_type\": \"FAVORITE\",\n \"space_name\": \"砮櫢䍟빨ỹ僛෨ͱ멘\",\n \"value\": false\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"details\": {\n \"sdk_error_code\": \"string\",\n \"error_code\": \"string\",\n \"message\": \"string\"\n }\n },\n \"request_uri\": \"string\",\n \"status\": \"string\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6d1da01c-87d7-449a-8425-7670c0db0780", "name": "Unauthorized - missing or invalid access token", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "meta" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"action_type\": \"FAVORITE\",\n \"space_name\": \"砮櫢䍟빨ỹ僛෨ͱ멘\",\n \"value\": false\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"details\": {\n \"edition_id\": \"96499735\",\n \"current_user_id\": \"96384499\",\n \"error_code\": \"A1003\",\n \"message\": \"The user doesn't have permission to perform this action\",\n \"space_id\": \"300900000014100\"\n }\n },\n \"request_uri\": \"/vani/api/v1/editions/96499735/spaces/300900000014100/meta\",\n \"status\": \"error\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d2a1031c-29a4-454c-984b-eb1e5b8c6261", "name": "Not found - a resource named in the path does not exist, or is not visible to the caller", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "meta" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"action_type\": \"FAVORITE\",\n \"space_name\": \"砮櫢䍟빨ỹ僛෨ͱ멘\",\n \"value\": false\n}", "options": { "raw": { "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"details\": {\n \"sdk_error_code\": \"string\",\n \"error_code\": \"string\",\n \"message\": \"string\"\n }\n },\n \"request_uri\": \"string\",\n \"status\": \"string\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7585d0cc-f55c-442f-8b41-5888d18d75e9", "name": "Conflict - the requested change conflicts with the current resource state", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "meta" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"action_type\": \"FAVORITE\",\n \"space_name\": \"砮櫢䍟빨ỹ僛෨ͱ멘\",\n \"value\": false\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"details\": {\n \"edition_id\": \"96499735\",\n \"current_user_id\": \"96384499\",\n \"error_code\": \"S1018\",\n \"message\": \"Space is not favourite\",\n \"space_id\": \"3009000000141003\"\n }\n },\n \"request_uri\": \"/vani/api/v1/editions/96499735/spaces/3009000000141003/meta\",\n \"status\": \"error\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5d0463ad-51cb-459b-80d9-597c1732e714", "name": "Rate limit exceeded - this operation allows 30 requests per minute per user", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "meta" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"action_type\": \"FAVORITE\",\n \"space_name\": \"砮櫢䍟빨ỹ僛෨ͱ멘\",\n \"value\": false\n}", "options": { "raw": { "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"details\": {\n \"sdk_error_code\": \"string\",\n \"error_code\": \"string\",\n \"message\": \"string\"\n }\n },\n \"request_uri\": \"string\",\n \"status\": \"string\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b0f38a60-bb6e-4b57-9dcd-a54e500e7fd1", "name": "Internal server error - the request was well-formed but could not be completed", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "meta" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"action_type\": \"FAVORITE\",\n \"space_name\": \"砮櫢䍟빨ỹ僛෨ͱ멘\",\n \"value\": false\n}", "options": { "raw": { "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"details\": {\n \"sdk_error_code\": \"string\",\n \"error_code\": \"string\",\n \"message\": \"string\"\n }\n },\n \"request_uri\": \"string\",\n \"status\": \"string\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "9b1de3cc-9207-40dc-b36d-8fdc8c0c1ba3", "name": "Create a new space", "request": { "name": "Create a new space", "description": {}, "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "Vani.teams.UPDATE Vani.spaces.UPDATE Vani.spaces.DELETE Vani.zones.READ Vani.editions.UPDATE Vani.spaces.CREATE Vani.teams.CREATE Vani.spaces.READ Vani.editions.CREATE Vani.zones.CREATE Vani.teams.READ Vani.editions.READ Vani.teams.DELETE" }, { "key": "accessTokenUrl", "value": "https://accounts.zoho.com/oauth/v2/token" }, { "key": "authUrl", "value": "https://accounts.zoho.com/oauth/v2/auth" }, { "key": "grant_type", "value": "authorization_code" } ] }, "body": { "mode": "raw", "raw": "{\n \"create_space\": {\n \"team_id\": \"string\",\n \"workspace_id\": \"string\",\n \"template_name\": \"姊\\ud958씃똃鍲\",\n \"space_name\": \"\",\n \"zone_name\": \"ㅼ⠍\",\n \"template_id\": \"string\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "2906ef0c-9a6d-44be-a974-ddb4a7b6e72d", "name": "Successful response", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"create_space\": {\n \"team_id\": \"string\",\n \"workspace_id\": \"string\",\n \"template_name\": \"姊\\ud958씃똃鍲\",\n \"space_name\": \"\",\n \"zone_name\": \"ㅼ⠍\",\n \"template_id\": \"string\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"edition_id\": \"96499735\",\n \"current_user_id\": \"96384499\",\n \"space_id\": \"3009000000145003\",\n \"uri\": \"/vani/api/v1/editions/96499735/spaces/3009000000145003\"\n },\n \"message\": \"Space created successfully.\",\n \"request_uri\": \"/vani/api/v1/editions/96499735/spaces/\",\n \"status\": \"success\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "51238ff4-c891-4ddf-902b-a4a6f050bd57", "name": "Invalid request - validation failed", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"create_space\": {\n \"team_id\": \"string\",\n \"workspace_id\": \"string\",\n \"template_name\": \"姊\\ud958씃똃鍲\",\n \"space_name\": \"\",\n \"zone_name\": \"ㅼ⠍\",\n \"template_id\": \"string\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"details\": {\n \"sdk_error_code\": \"string\",\n \"error_code\": \"string\",\n \"message\": \"string\"\n }\n },\n \"request_uri\": \"string\",\n \"status\": \"string\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "17fe63c7-51f3-48d4-87ef-930a4ad8ecc6", "name": "Unauthorized - missing or invalid access token", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"create_space\": {\n \"team_id\": \"string\",\n \"workspace_id\": \"string\",\n \"template_name\": \"姊\\ud958씃똃鍲\",\n \"space_name\": \"\",\n \"zone_name\": \"ㅼ⠍\",\n \"template_id\": \"string\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"details\": {\n \"current_user_id\": \"96384499\",\n \"error_code\": \"T1006\",\n \"message\": \"User is not a member of the team\"\n }\n },\n \"request_uri\": \"/vani/api/v1/editions/75918186/spaces/\",\n \"status\": \"error\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6a8f0e7b-e0f5-44bd-9777-72e414f54a6c", "name": "Not found - a resource named in the path does not exist, or is not visible to the caller", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"create_space\": {\n \"team_id\": \"string\",\n \"workspace_id\": \"string\",\n \"template_name\": \"姊\\ud958씃똃鍲\",\n \"space_name\": \"\",\n \"zone_name\": \"ㅼ⠍\",\n \"template_id\": \"string\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"details\": {\n \"edition_id\": \"60029715808\",\n \"current_user_id\": \"60029267674\",\n \"error_code\": \"S1030\",\n \"message\": \"Template not found\"\n }\n },\n \"request_uri\": \"/vani/api/v1/editions/60029715808/spaces/\",\n \"status\": \"error\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f5bba83d-6a09-4109-a70f-2bf2dc758e18", "name": "Rate limit exceeded - this operation allows 30 requests per minute per user", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"create_space\": {\n \"team_id\": \"string\",\n \"workspace_id\": \"string\",\n \"template_name\": \"姊\\ud958씃똃鍲\",\n \"space_name\": \"\",\n \"zone_name\": \"ㅼ⠍\",\n \"template_id\": \"string\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"details\": {\n \"sdk_error_code\": \"string\",\n \"error_code\": \"string\",\n \"message\": \"string\"\n }\n },\n \"request_uri\": \"string\",\n \"status\": \"string\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2a0cee1b-ec3e-42c3-9d51-18a43d436c0e", "name": "Internal server error - the request was well-formed but could not be completed", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"create_space\": {\n \"team_id\": \"string\",\n \"workspace_id\": \"string\",\n \"template_name\": \"姊\\ud958씃똃鍲\",\n \"space_name\": \"\",\n \"zone_name\": \"ㅼ⠍\",\n \"template_id\": \"string\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"details\": {\n \"sdk_error_code\": \"string\",\n \"error_code\": \"string\",\n \"message\": \"string\"\n }\n },\n \"request_uri\": \"string\",\n \"status\": \"string\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "517aefdd-3bab-44bf-9a5e-093709d49dce", "name": "Get all spaces in an edition", "request": { "name": "Get all spaces in an edition", "description": {}, "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "key": "team_id", "value": "string", "description": "The ID of the team within the edition" }, { "disabled": false, "key": "action_type", "value": "FAVOURITES", "description": "(Required) Specifies the category or context of Spaces. Allowed values: ALL_SPACES, SHARED_SPACES, SHARED_BY_ME, SHARED_BY_OTHERS, PUBLISHED_WITH_TEAM, PUBLISHED_WITH_ORG, FAVOURITES, DRAFT_SPACES, RECENT_ALL_SPACES_ORG, RECENTLY_TRASHED_SPACES, RECENTLY_TRASHED, RECENTLY_TRASHED_ZONES, NON_TEAM_MEMBER_SHARED_SPACE" }, { "disabled": false, "key": "sort_by", "value": "RECENTLY_MODIFIED_BY_USER", "description": "(Required) Specifies the field used to sort the results. Allowed values: TIME_CREATED, TIME_DELETED_ASC, TIME_DELETED_DESC, A_Z, Z_A, RECENTLY_OPENED, RECENTLY_TRASHED, RECENTLY_ACCESSED_BY_USER, RECENTLY_MODIFIED_BY_USER" }, { "disabled": false, "key": "filter_by", "value": "string", "description": "Parameter: filter_by. Max length: 100" }, { "disabled": false, "key": "search", "value": "ꂅ칐", "description": "The keyword or phrase to search for" }, { "disabled": false, "key": "from", "value": "688200", "description": "The starting index from where the results should be fetched. Default value is 0" }, { "disabled": false, "key": "limit", "value": "4", "description": "The maximum number of results to return in the response. Default value is 20" }, { "disabled": false, "key": "need_total_count", "value": "true", "description": "Set this to true if you want to include the total count of items in the response. By default, this is false" }, { "disabled": false, "key": "fields", "value": "last_published_time", "description": "Specifies the fields (comma-separated) to retrieve. Allowed values: space_name, space_id, owner_zuid, team_id, last_author_zuid, created_time, last_modified_time, last_saved_version, publish, published_version_id, last_published_time, thumb_image_id, client_import_id, is_private_space, file_size, allow_embed, status, can_edit, is_favorite, space_member_count, state_modified_time, uri, open_url" } ], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "Vani.teams.UPDATE Vani.spaces.UPDATE Vani.spaces.DELETE Vani.zones.READ Vani.editions.UPDATE Vani.spaces.CREATE Vani.teams.CREATE Vani.spaces.READ Vani.editions.CREATE Vani.zones.CREATE Vani.teams.READ Vani.editions.READ Vani.teams.DELETE" }, { "key": "accessTokenUrl", "value": "https://accounts.zoho.com/oauth/v2/token" }, { "key": "authUrl", "value": "https://accounts.zoho.com/oauth/v2/auth" }, { "key": "grant_type", "value": "authorization_code" } ] } }, "response": [ { "id": "df18f608-581b-4137-8bdb-c9f4cee37308", "name": "Successful response", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "team_id", "value": "string" }, { "key": "action_type", "value": "FAVOURITES" }, { "key": "sort_by", "value": "RECENTLY_MODIFIED_BY_USER" }, { "key": "filter_by", "value": "string" }, { "key": "search", "value": "ꂅ칐" }, { "key": "from", "value": "688200" }, { "key": "limit", "value": "4" }, { "key": "need_total_count", "value": "true" }, { "key": "fields", "value": "last_published_time" } ], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"space_count\": 1,\n \"spaces_info\": [\n {\n \"created_time\": \"Fri, 24 Jan 2025, 12:25:29\",\n \"last_modified_time\": \"Fri, 24 Jan 2025, 12:25:29\",\n \"is_favorite\": \"true\",\n \"space_name\": \"Business case template\",\n \"publish\": \"false\",\n \"owner_zuid\": \"96384499\",\n \"can_edit\": \"true\",\n \"team_id\": \"3009000000002003\",\n \"space_member_count\": \"1\",\n \"space_id\": \"3009000000093779\",\n \"last_author_zuid\": \"96384499\",\n \"status\": \"ACTIVE\"\n }\n ]\n },\n \"message\": \"Space fetched successfully.\",\n \"request_uri\": \"/vani/api/v1/editions/96499735/spaces\",\n \"status\": \"success\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bb18ff56-7147-4ff0-bec1-c9bd2452e572", "name": "Invalid request - validation failed", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "team_id", "value": "string" }, { "key": "action_type", "value": "FAVOURITES" }, { "key": "sort_by", "value": "RECENTLY_MODIFIED_BY_USER" }, { "key": "filter_by", "value": "string" }, { "key": "search", "value": "ꂅ칐" }, { "key": "from", "value": "688200" }, { "key": "limit", "value": "4" }, { "key": "need_total_count", "value": "true" }, { "key": "fields", "value": "last_published_time" } ], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"details\": {\n \"sdk_error_code\": \"string\",\n \"error_code\": \"string\",\n \"message\": \"string\"\n }\n },\n \"request_uri\": \"string\",\n \"status\": \"string\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d6b6b4d2-4fb1-40ee-9651-ffe73a950746", "name": "Unauthorized - missing or invalid access token", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "team_id", "value": "string" }, { "key": "action_type", "value": "FAVOURITES" }, { "key": "sort_by", "value": "RECENTLY_MODIFIED_BY_USER" }, { "key": "filter_by", "value": "string" }, { "key": "search", "value": "ꂅ칐" }, { "key": "from", "value": "688200" }, { "key": "limit", "value": "4" }, { "key": "need_total_count", "value": "true" }, { "key": "fields", "value": "last_published_time" } ], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"details\": {\n \"sdk_error_code\": \"string\",\n \"error_code\": \"string\",\n \"message\": \"string\"\n }\n },\n \"request_uri\": \"string\",\n \"status\": \"string\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0daacaab-fc4a-4a44-8adf-805a702d26ec", "name": "Not found - a resource named in the path does not exist, or is not visible to the caller", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "team_id", "value": "string" }, { "key": "action_type", "value": "FAVOURITES" }, { "key": "sort_by", "value": "RECENTLY_MODIFIED_BY_USER" }, { "key": "filter_by", "value": "string" }, { "key": "search", "value": "ꂅ칐" }, { "key": "from", "value": "688200" }, { "key": "limit", "value": "4" }, { "key": "need_total_count", "value": "true" }, { "key": "fields", "value": "last_published_time" } ], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"details\": {\n \"sdk_error_code\": \"string\",\n \"error_code\": \"string\",\n \"message\": \"string\"\n }\n },\n \"request_uri\": \"string\",\n \"status\": \"string\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "29b40cb9-e416-455b-a947-66a87a3edbc6", "name": "Rate limit exceeded - this operation allows 60 requests per minute per user", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "team_id", "value": "string" }, { "key": "action_type", "value": "FAVOURITES" }, { "key": "sort_by", "value": "RECENTLY_MODIFIED_BY_USER" }, { "key": "filter_by", "value": "string" }, { "key": "search", "value": "ꂅ칐" }, { "key": "from", "value": "688200" }, { "key": "limit", "value": "4" }, { "key": "need_total_count", "value": "true" }, { "key": "fields", "value": "last_published_time" } ], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"details\": {\n \"sdk_error_code\": \"string\",\n \"error_code\": \"string\",\n \"message\": \"string\"\n }\n },\n \"request_uri\": \"string\",\n \"status\": \"string\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "99b5a670-bae3-4659-90c2-4cf823c9eba6", "name": "Internal server error - the request was well-formed but could not be completed", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "team_id", "value": "string" }, { "key": "action_type", "value": "FAVOURITES" }, { "key": "sort_by", "value": "RECENTLY_MODIFIED_BY_USER" }, { "key": "filter_by", "value": "string" }, { "key": "search", "value": "ꂅ칐" }, { "key": "from", "value": "688200" }, { "key": "limit", "value": "4" }, { "key": "need_total_count", "value": "true" }, { "key": "fields", "value": "last_published_time" } ], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"details\": {\n \"sdk_error_code\": \"string\",\n \"error_code\": \"string\",\n \"message\": \"string\"\n }\n },\n \"request_uri\": \"string\",\n \"status\": \"string\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "c97c188d-4108-42ac-a684-8af92c1e709d", "name": "Update space state", "request": { "name": "Update space state", "description": {}, "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "state" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "Vani.teams.UPDATE Vani.spaces.UPDATE Vani.spaces.DELETE Vani.zones.READ Vani.editions.UPDATE Vani.spaces.CREATE Vani.teams.CREATE Vani.spaces.READ Vani.editions.CREATE Vani.zones.CREATE Vani.teams.READ Vani.editions.READ Vani.teams.DELETE" }, { "key": "accessTokenUrl", "value": "https://accounts.zoho.com/oauth/v2/token" }, { "key": "authUrl", "value": "https://accounts.zoho.com/oauth/v2/auth" }, { "key": "grant_type", "value": "authorization_code" } ] }, "body": { "mode": "raw", "raw": "{\n \"space_state\": \"RESTORE\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "f9855d47-e94a-40bd-a53e-dfaa747e5e94", "name": "Successful response", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "state" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"space_state\": \"RESTORE\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"edition_id\": \"96499735\",\n \"space_state\": \"RESTORE\",\n \"current_user_id\": \"96384499\",\n \"space_id\": \"3009000000093854\"\n },\n \"message\": \"Space state updated successfully.\",\n \"request_uri\": \"/vani/api/v1/editions/96499735/spaces/3009000000093854/state\",\n \"status\": \"success\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0a284f25-84c0-44b2-a880-28bce757bc77", "name": "Invalid request - validation failed", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "state" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"space_state\": \"RESTORE\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"details\": {\n \"current_user_id\": \"96384499\",\n \"error_code\": \"S1012\",\n \"message\": \"Space is not in an active state\"\n }\n },\n \"request_uri\": \"/vani/api/v1/editions/96499735/spaces/3009000000093854/state\",\n \"status\": \"error\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1f0575b6-bf44-4a69-a138-252f1583dfbd", "name": "Unauthorized - missing or invalid access token", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "state" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"space_state\": \"RESTORE\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"details\": {\n \"current_user_id\": \"96384499\",\n \"error_code\": \"A1003\",\n \"message\": \"The user doesn't have permission to perform this action\"\n }\n },\n \"request_uri\": \"/vani/api/v1/editions/96499735/spaces/300900000000003/state\",\n \"status\": \"error\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "239c23be-0949-470d-b919-d868418c8355", "name": "Not found - a resource named in the path does not exist, or is not visible to the caller", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "state" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"space_state\": \"RESTORE\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"details\": {\n \"sdk_error_code\": \"string\",\n \"error_code\": \"string\",\n \"message\": \"string\"\n }\n },\n \"request_uri\": \"string\",\n \"status\": \"string\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "353e7b13-bc08-45e5-93da-6cd957a21108", "name": "Rate limit exceeded - this operation allows 30 requests per minute per user", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "state" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"space_state\": \"RESTORE\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"details\": {\n \"sdk_error_code\": \"string\",\n \"error_code\": \"string\",\n \"message\": \"string\"\n }\n },\n \"request_uri\": \"string\",\n \"status\": \"string\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a4dc5a8b-2fab-40eb-80e9-f67b060a82e3", "name": "Internal server error - the request was well-formed but could not be completed", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "state" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"space_state\": \"RESTORE\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"details\": {\n \"sdk_error_code\": \"string\",\n \"error_code\": \"string\",\n \"message\": \"string\"\n }\n },\n \"request_uri\": \"string\",\n \"status\": \"string\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "event": [] }, { "id": "71d02cc0-3dcb-4516-9217-1a3dd39fca70", "name": "Space Members", "description": { "content": "Add, update, remove, and list the members of a space.", "type": "text/plain" }, "item": [ { "id": "53e72ddf-4f12-43a8-b219-c8fd64e75a00", "name": "Remove a member from a space", "request": { "name": "Remove a member from a space", "description": {}, "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "members", ":member_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "disabled": false, "type": "any", "value": "string", "key": "member_id", "description": "(Required) The unique identifier of the member" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "Vani.teams.UPDATE Vani.spaces.UPDATE Vani.spaces.DELETE Vani.zones.READ Vani.editions.UPDATE Vani.spaces.CREATE Vani.teams.CREATE Vani.spaces.READ Vani.editions.CREATE Vani.zones.CREATE Vani.teams.READ Vani.editions.READ Vani.teams.DELETE" }, { "key": "accessTokenUrl", "value": "https://accounts.zoho.com/oauth/v2/token" }, { "key": "authUrl", "value": "https://accounts.zoho.com/oauth/v2/auth" }, { "key": "grant_type", "value": "authorization_code" } ] } }, "response": [ { "id": "1766c0bd-92a2-4e7f-af07-9e57c4345ea7", "name": "Successful response", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "members", ":member_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "disabled": false, "type": "any", "value": "string", "key": "member_id", "description": "(Required) The unique identifier of the member" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"edition_id\": \"97375109\",\n \"removed_zuid\": \"80473960\",\n \"current_user_id\": \"96384499\",\n \"space_id\": \"1505000000039107\"\n },\n \"message\": \"Space member deleted successfully.\",\n \"request_uri\": \"/vani/api/v1/editions/97375109/spaces/1505000000039107/members\",\n \"status\": \"success\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "35cc0808-ee6d-4ae6-b65e-43fec672487f", "name": "Invalid request - validation failed", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "members", ":member_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "disabled": false, "type": "any", "value": "string", "key": "member_id", "description": "(Required) The unique identifier of the member" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"details\": {\n \"sdk_error_code\": \"string\",\n \"error_code\": \"string\",\n \"message\": \"string\"\n }\n },\n \"request_uri\": \"string\",\n \"status\": \"string\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6aae1db6-1c18-4e16-9cba-64ad8b334795", "name": "Unauthorized - missing or invalid access token", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "members", ":member_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "disabled": false, "type": "any", "value": "string", "key": "member_id", "description": "(Required) The unique identifier of the member" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"details\": {\n \"edition_id\": \"97375109\",\n \"current_user_id\": \"96384499\",\n \"error_code\": \"A1003\",\n \"message\": \"The user doesn't have permission to perform this action\",\n \"space_id\": \"1505000000045043\"\n }\n },\n \"request_uri\": \"/vani/api/v1/editions/97375109/spaces/1505000000045043/members\",\n \"status\": \"error\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "76005f8d-23d2-4d60-a0aa-a7b20714ed49", "name": "Forbidden - the caller is authenticated but not allowed to perform this operation", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "members", ":member_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "disabled": false, "type": "any", "value": "string", "key": "member_id", "description": "(Required) The unique identifier of the member" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"details\": {\n \"edition_id\": \"97375109\",\n \"current_user_id\": \"96384499\",\n \"error_code\": \"S1002\",\n \"message\": \"Space owner cannot be removed\",\n \"space_id\": \"1505000000045043\"\n }\n },\n \"request_uri\": \"/vani/api/v1/editions/97375109/spaces/1505000000045043/members\",\n \"status\": \"error\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f49dfc19-16b0-44cf-a657-83fac2551810", "name": "Not found - a resource named in the path does not exist, or is not visible to the caller", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "members", ":member_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "disabled": false, "type": "any", "value": "string", "key": "member_id", "description": "(Required) The unique identifier of the member" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"details\": {\n \"edition_id\": \"97375109\",\n \"current_user_id\": \"96384499\",\n \"error_code\": \"S1015\",\n \"message\": \"Member is not part of the Space\",\n \"space_id\": \"1505000000039107\"\n }\n },\n \"request_uri\": \"/vani/api/v1/editions/97375109/spaces/1505000000039107/members\",\n \"status\": \"error\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "dd9c7ab1-4b29-4b5a-a2b9-c33f1bfd5f64", "name": "Rate limit exceeded - this operation allows 30 requests per minute per user", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "members", ":member_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "disabled": false, "type": "any", "value": "string", "key": "member_id", "description": "(Required) The unique identifier of the member" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"details\": {\n \"sdk_error_code\": \"string\",\n \"error_code\": \"string\",\n \"message\": \"string\"\n }\n },\n \"request_uri\": \"string\",\n \"status\": \"string\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "35d488b6-0036-4602-9ebf-a846f6c97663", "name": "Internal server error - the request was well-formed but could not be completed", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "members", ":member_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "disabled": false, "type": "any", "value": "string", "key": "member_id", "description": "(Required) The unique identifier of the member" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"details\": {\n \"sdk_error_code\": \"string\",\n \"error_code\": \"string\",\n \"message\": \"string\"\n }\n },\n \"request_uri\": \"string\",\n \"status\": \"string\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "841f1b18-b711-49ff-8863-d1cab925260e", "name": "Update a space member's role", "request": { "name": "Update a space member's role", "description": {}, "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "members", ":member_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "disabled": false, "type": "any", "value": "string", "key": "member_id", "description": "(Required) The unique identifier of the member" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "Vani.teams.UPDATE Vani.spaces.UPDATE Vani.spaces.DELETE Vani.zones.READ Vani.editions.UPDATE Vani.spaces.CREATE Vani.teams.CREATE Vani.spaces.READ Vani.editions.CREATE Vani.zones.CREATE Vani.teams.READ Vani.editions.READ Vani.teams.DELETE" }, { "key": "accessTokenUrl", "value": "https://accounts.zoho.com/oauth/v2/token" }, { "key": "authUrl", "value": "https://accounts.zoho.com/oauth/v2/auth" }, { "key": "grant_type", "value": "authorization_code" } ] }, "body": { "mode": "raw", "raw": "{\n \"role\": \"ORGANISER\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "157c3273-54f3-42ff-8e60-53498fc31788", "name": "Successful response", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "members", ":member_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "disabled": false, "type": "any", "value": "string", "key": "member_id", "description": "(Required) The unique identifier of the member" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"role\": \"ORGANISER\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"new_role\": \"EDITOR\",\n \"edition_id\": \"97375109\",\n \"current_user_id\": \"96384499\",\n \"space_id\": \"1505000000005005\",\n \"zuid\": \"80473960\"\n },\n \"message\": \"Space member updated successfully.\",\n \"request_uri\": \"/vani/api/v1/editions/97375109/spaces/1505000000005005/members\",\n \"status\": \"success\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2cac3046-7bdb-4972-a131-b843f9079a4f", "name": "Invalid request - validation failed", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "members", ":member_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "disabled": false, "type": "any", "value": "string", "key": "member_id", "description": "(Required) The unique identifier of the member" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"role\": \"ORGANISER\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"details\": {\n \"sdk_error_code\": \"string\",\n \"error_code\": \"string\",\n \"message\": \"string\"\n }\n },\n \"request_uri\": \"string\",\n \"status\": \"string\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "11192ca4-1fdc-4bdd-8389-72321b192a83", "name": "Unauthorized - missing or invalid access token", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "members", ":member_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "disabled": false, "type": "any", "value": "string", "key": "member_id", "description": "(Required) The unique identifier of the member" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"role\": \"ORGANISER\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"details\": {\n \"edition_id\": \"75918186\",\n \"current_user_id\": \"96384499\",\n \"error_code\": \"A1003\",\n \"message\": \"The user doesn't have permission to perform this action\",\n \"space_id\": \"693000000536005\"\n }\n },\n \"request_uri\": \"/vani/api/v1/editions/75918186/spaces/693000000536005/members\",\n \"status\": \"error\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b0fcba7d-8aaa-416e-8b6f-d25c9eff3a4b", "name": "Forbidden - the caller is authenticated but not allowed to perform this operation", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "members", ":member_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "disabled": false, "type": "any", "value": "string", "key": "member_id", "description": "(Required) The unique identifier of the member" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"role\": \"ORGANISER\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"details\": {\n \"edition_id\": \"97375109\",\n \"current_user_id\": \"96384499\",\n \"error_code\": \"R1001\",\n \"message\": \"Cannot update own role\",\n \"space_id\": \"1505000000045043\",\n \"zuid\": \"96384499\"\n }\n },\n \"request_uri\": \"/vani/api/v1/editions/97375109/spaces/1505000000045043/members\",\n \"status\": \"error\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "74ed005d-092e-43f3-9eb1-ed02fd6882bf", "name": "Not found - a resource named in the path does not exist, or is not visible to the caller", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "members", ":member_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "disabled": false, "type": "any", "value": "string", "key": "member_id", "description": "(Required) The unique identifier of the member" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"role\": \"ORGANISER\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"details\": {\n \"edition_id\": \"96499735\",\n \"current_user_id\": \"96384499\",\n \"error_code\": \"S1015\",\n \"message\": \"Member is not part of the Space\",\n \"space_id\": \"3009000000067027\",\n \"zuid\": \"80585905\"\n }\n },\n \"request_uri\": \"/vani/api/v1/editions/96499735/spaces/3009000000067027/members\",\n \"status\": \"error\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ca05cbf2-73cd-436d-b9f8-83c986186002", "name": "Conflict - the requested change conflicts with the current resource state", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "members", ":member_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "disabled": false, "type": "any", "value": "string", "key": "member_id", "description": "(Required) The unique identifier of the member" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"role\": \"ORGANISER\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"details\": {\n \"edition_id\": \"97375109\",\n \"current_user_id\": \"96384499\",\n \"error_code\": \"M1001\",\n \"message\": \"The member already has the specified role\",\n \"space_id\": \"1505000000005005\",\n \"zuid\": \"80473960\"\n }\n },\n \"request_uri\": \"/vani/api/v1/editions/97375109/spaces/1505000000005005/members/80473960\",\n \"status\": \"error\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "aab1f71b-7b6a-4c55-9f78-3b80fc7b9e77", "name": "Rate limit exceeded - this operation allows 30 requests per minute per user", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "members", ":member_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "disabled": false, "type": "any", "value": "string", "key": "member_id", "description": "(Required) The unique identifier of the member" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"role\": \"ORGANISER\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"details\": {\n \"sdk_error_code\": \"string\",\n \"error_code\": \"string\",\n \"message\": \"string\"\n }\n },\n \"request_uri\": \"string\",\n \"status\": \"string\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d0d2a0f1-0526-4bd0-91ea-fe3bbc1588b9", "name": "Internal server error - the request was well-formed but could not be completed", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "members", ":member_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "disabled": false, "type": "any", "value": "string", "key": "member_id", "description": "(Required) The unique identifier of the member" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"role\": \"ORGANISER\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"details\": {\n \"sdk_error_code\": \"string\",\n \"error_code\": \"string\",\n \"message\": \"string\"\n }\n },\n \"request_uri\": \"string\",\n \"status\": \"string\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "c690fa39-c6b2-4733-b646-4400e7b020ef", "name": "Add members to a space", "request": { "name": "Add members to a space", "description": {}, "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "members" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "Vani.teams.UPDATE Vani.spaces.UPDATE Vani.spaces.DELETE Vani.zones.READ Vani.editions.UPDATE Vani.spaces.CREATE Vani.teams.CREATE Vani.spaces.READ Vani.editions.CREATE Vani.zones.CREATE Vani.teams.READ Vani.editions.READ Vani.teams.DELETE" }, { "key": "accessTokenUrl", "value": "https://accounts.zoho.com/oauth/v2/token" }, { "key": "authUrl", "value": "https://accounts.zoho.com/oauth/v2/auth" }, { "key": "grant_type", "value": "authorization_code" } ] }, "body": { "mode": "raw", "raw": "{\n \"members_info\": [\n {\n \"zuid\": \"string\",\n \"role\": \"EDITOR\",\n \"type\": \"USER\",\n \"restrict_zone_ids\": \"0eE9DF0e-78fA-15ef-6E02-0CFaBaEa13f2\",\n \"access_state\": \"partial_access\"\n }\n ],\n \"requester_zuid\": \"string\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "e0598f2e-b415-4458-90cf-99e3a4cd9f9b", "name": "Successful response", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "members" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"members_info\": [\n {\n \"zuid\": \"string\",\n \"role\": \"EDITOR\",\n \"type\": \"USER\",\n \"restrict_zone_ids\": \"0eE9DF0e-78fA-15ef-6E02-0CFaBaEa13f2\",\n \"access_state\": \"partial_access\"\n }\n ],\n \"requester_zuid\": \"string\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"added_members\": [\n {\n \"role_name\": \"VIEWER\",\n \"added_type_name\": \"USER\",\n \"added_time\": \"Tue, 04 Feb 2025, 11:18:40\",\n \"mail_id\": \"lucas.bryant@boxicle.com\",\n \"added_by\": \"96384499\",\n \"display_name\": \"Lucas Bryant\",\n \"zuid\": \"98722154\"\n },\n {\n \"role_name\": \"EDITOR\",\n \"added_type_name\": \"TEAM\",\n \"added_time\": \"Tue, 04 Feb 2025, 11:18:40\",\n \"added_by\": \"96384499\",\n \"display_name\": \"TEAM VANI\",\n \"zuid\": \"1505000000002005\"\n }\n ]\n },\n \"message\": \"Space member added successfully.\",\n \"request_uri\": \"/vani/api/v1/editions/97375109/spaces/1505000000039170/members\",\n \"status\": \"success\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d4593398-81de-4fa5-9ade-f93c981624fd", "name": "Successful response", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "members" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"members_info\": [\n {\n \"zuid\": \"string\",\n \"role\": \"EDITOR\",\n \"type\": \"USER\",\n \"restrict_zone_ids\": \"0eE9DF0e-78fA-15ef-6E02-0CFaBaEa13f2\",\n \"access_state\": \"partial_access\"\n }\n ],\n \"requester_zuid\": \"string\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Partial Content", "code": 206, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"failed_members\": [\n {\n \"error_message\": \"Member already part of Space\",\n \"error_code\": \"S1019\",\n \"zuid\": \"98722154\"\n }\n ],\n \"added_members\": [\n {\n \"role_name\": \"EDITOR\",\n \"added_type_name\": \"TEAM\",\n \"added_time\": \"Tue, 04 Feb 2025, 11:14:23\",\n \"added_by\": \"96384499\",\n \"display_name\": \"CloudSpark\",\n \"zuid\": \"1505000000002005\"\n }\n ]\n },\n \"message\": \"Partial success: Some members added, others failed.\",\n \"request_uri\": \"/vani/api/v1/editions/97375109/spaces/1505000000039170/members\",\n \"status\": \"success\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b2d2201c-ee47-4356-9570-acf581364297", "name": "Invalid request - validation failed", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "members" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"members_info\": [\n {\n \"zuid\": \"string\",\n \"role\": \"EDITOR\",\n \"type\": \"USER\",\n \"restrict_zone_ids\": \"0eE9DF0e-78fA-15ef-6E02-0CFaBaEa13f2\",\n \"access_state\": \"partial_access\"\n }\n ],\n \"requester_zuid\": \"string\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"details\": {\n \"failed_members\": [\n {\n \"error_message\": \"User is inactive and cannot be added to project\",\n \"error_code\": \"U1001\",\n \"zuid\": \"80215739\"\n }\n ],\n \"error_code\": \"S1008\",\n \"message\": \"Space member add failed\"\n }\n },\n \"request_uri\": \"/vani/api/v1/editions/75918186/spaces/693000000536104/members\",\n \"status\": \"error\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2c9866b4-8fb6-420e-bb24-b672fd577372", "name": "Unauthorized - missing or invalid access token", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "members" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"members_info\": [\n {\n \"zuid\": \"string\",\n \"role\": \"EDITOR\",\n \"type\": \"USER\",\n \"restrict_zone_ids\": \"0eE9DF0e-78fA-15ef-6E02-0CFaBaEa13f2\",\n \"access_state\": \"partial_access\"\n }\n ],\n \"requester_zuid\": \"string\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"details\": {\n \"edition_id\": \"96499735\",\n \"current_user_id\": \"96384499\",\n \"error_code\": \"A1003\",\n \"message\": \"The user doesn't have permission to perform this action\",\n \"space_id\": \"300900000014503\"\n }\n },\n \"request_uri\": \"/vani/api/v1/editions/96499735/spaces/300900000014503/members\",\n \"status\": \"error\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "931b1546-d1e7-4395-aab6-05e38506f447", "name": "Not found - a resource named in the path does not exist, or is not visible to the caller", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "members" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"members_info\": [\n {\n \"zuid\": \"string\",\n \"role\": \"EDITOR\",\n \"type\": \"USER\",\n \"restrict_zone_ids\": \"0eE9DF0e-78fA-15ef-6E02-0CFaBaEa13f2\",\n \"access_state\": \"partial_access\"\n }\n ],\n \"requester_zuid\": \"string\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"details\": {\n \"sdk_error_code\": \"string\",\n \"error_code\": \"string\",\n \"message\": \"string\"\n }\n },\n \"request_uri\": \"string\",\n \"status\": \"string\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "25f786de-8903-4b45-bdbb-72e417a38ccf", "name": "Rate limit exceeded - this operation allows 30 requests per minute per user", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "members" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"members_info\": [\n {\n \"zuid\": \"string\",\n \"role\": \"EDITOR\",\n \"type\": \"USER\",\n \"restrict_zone_ids\": \"0eE9DF0e-78fA-15ef-6E02-0CFaBaEa13f2\",\n \"access_state\": \"partial_access\"\n }\n ],\n \"requester_zuid\": \"string\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"details\": {\n \"sdk_error_code\": \"string\",\n \"error_code\": \"string\",\n \"message\": \"string\"\n }\n },\n \"request_uri\": \"string\",\n \"status\": \"string\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fb9e0d61-014d-407c-9660-9a236c42177c", "name": "Internal server error - the request was well-formed but could not be completed", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "members" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"members_info\": [\n {\n \"zuid\": \"string\",\n \"role\": \"EDITOR\",\n \"type\": \"USER\",\n \"restrict_zone_ids\": \"0eE9DF0e-78fA-15ef-6E02-0CFaBaEa13f2\",\n \"access_state\": \"partial_access\"\n }\n ],\n \"requester_zuid\": \"string\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"details\": {\n \"sdk_error_code\": \"string\",\n \"error_code\": \"string\",\n \"message\": \"string\"\n }\n },\n \"request_uri\": \"string\",\n \"status\": \"string\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "5118e976-f6a4-436e-8b4c-a9918e182386", "name": "Get the members of a space", "request": { "name": "Get the members of a space", "description": {}, "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "members" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "key": "roles", "value": "VIEWER", "description": "Parameter: roles. Allowed values: CREATOR, EDITOR, COMMENTER, VIEWER, ORGANISER" }, { "disabled": false, "key": "sort_by", "value": "ROLE_ASC", "description": "Specifies the field used to sort the results. Allowed values: ROLE_ASC, ROLE_DESC" }, { "disabled": false, "key": "search", "value": "久", "description": "The keyword or phrase to search for" }, { "disabled": false, "key": "fields", "value": "added_by", "description": "Specifies the fields (comma-separated) to retrieve. Allowed values: added_type_name, display_name, zuid, added_time, mail_id, role_name, added_by" }, { "disabled": false, "key": "from", "value": "688200", "description": "The starting index from where the results should be fetched. Default value is 0" }, { "disabled": false, "key": "limit", "value": "4", "description": "The maximum number of results to return in the response. Default value is 20" } ], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "Vani.teams.UPDATE Vani.spaces.UPDATE Vani.spaces.DELETE Vani.zones.READ Vani.editions.UPDATE Vani.spaces.CREATE Vani.teams.CREATE Vani.spaces.READ Vani.editions.CREATE Vani.zones.CREATE Vani.teams.READ Vani.editions.READ Vani.teams.DELETE" }, { "key": "accessTokenUrl", "value": "https://accounts.zoho.com/oauth/v2/token" }, { "key": "authUrl", "value": "https://accounts.zoho.com/oauth/v2/auth" }, { "key": "grant_type", "value": "authorization_code" } ] } }, "response": [ { "id": "07c79da3-1c8d-45a6-8cf7-6c2ff385a26c", "name": "Successful response", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "members" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "roles", "value": "VIEWER" }, { "key": "sort_by", "value": "ROLE_ASC" }, { "key": "search", "value": "久" }, { "key": "fields", "value": "added_by" }, { "key": "from", "value": "688200" }, { "key": "limit", "value": "4" } ], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"space_members\": [\n {\n \"role_name\": \"EDITOR\",\n \"display_name\": \"Emma Carter\",\n \"zuid\": \"80473960\"\n },\n {\n \"role_name\": \"VIEWER\",\n \"display_name\": \"CloudSpark\",\n \"zuid\": \"1505000000002005\"\n },\n {\n \"role_name\": \"CREATOR\",\n \"display_name\": \"Ryan Mitchell\",\n \"zuid\": \"96384499\"\n }\n ]\n },\n \"message\": \"Space members fetched successfully.\",\n \"request_uri\": \"/vani/api/v1/editions/97375109/spaces/1505000000022005/members\",\n \"status\": \"success\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d7ad1970-d78a-45b6-a48d-4481395c8b70", "name": "Invalid request - validation failed", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "members" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "roles", "value": "VIEWER" }, { "key": "sort_by", "value": "ROLE_ASC" }, { "key": "search", "value": "久" }, { "key": "fields", "value": "added_by" }, { "key": "from", "value": "688200" }, { "key": "limit", "value": "4" } ], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"details\": {\n \"sdk_error_code\": \"string\",\n \"error_code\": \"string\",\n \"message\": \"string\"\n }\n },\n \"request_uri\": \"string\",\n \"status\": \"string\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2d50edee-d272-4c89-bac7-cfce3834c76e", "name": "Unauthorized - missing or invalid access token", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "members" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "roles", "value": "VIEWER" }, { "key": "sort_by", "value": "ROLE_ASC" }, { "key": "search", "value": "久" }, { "key": "fields", "value": "added_by" }, { "key": "from", "value": "688200" }, { "key": "limit", "value": "4" } ], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"details\": {\n \"edition_id\": \"96499735\",\n \"current_user_id\": \"96384499\",\n \"error_code\": \"A1003\",\n \"message\": \"The user doesn't have permission to perform this action\",\n \"space_id\": \"300900000038005\"\n }\n },\n \"request_uri\": \"/vani/api/v1/editions/96499735/spaces/300900000038005/members\",\n \"status\": \"error\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f7bad016-9dc9-4835-ae3f-841777e41101", "name": "Not found - a resource named in the path does not exist, or is not visible to the caller", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "members" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "roles", "value": "VIEWER" }, { "key": "sort_by", "value": "ROLE_ASC" }, { "key": "search", "value": "久" }, { "key": "fields", "value": "added_by" }, { "key": "from", "value": "688200" }, { "key": "limit", "value": "4" } ], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"details\": {\n \"sdk_error_code\": \"string\",\n \"error_code\": \"string\",\n \"message\": \"string\"\n }\n },\n \"request_uri\": \"string\",\n \"status\": \"string\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e88b6f0d-023d-4ae4-894d-8a14b5e6a9bc", "name": "Rate limit exceeded - this operation allows 60 requests per minute per user", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "members" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "roles", "value": "VIEWER" }, { "key": "sort_by", "value": "ROLE_ASC" }, { "key": "search", "value": "久" }, { "key": "fields", "value": "added_by" }, { "key": "from", "value": "688200" }, { "key": "limit", "value": "4" } ], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"details\": {\n \"sdk_error_code\": \"string\",\n \"error_code\": \"string\",\n \"message\": \"string\"\n }\n },\n \"request_uri\": \"string\",\n \"status\": \"string\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "44c64e5d-c1ad-4813-8563-5acecf111401", "name": "Internal server error - the request was well-formed but could not be completed", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "members" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "roles", "value": "VIEWER" }, { "key": "sort_by", "value": "ROLE_ASC" }, { "key": "search", "value": "久" }, { "key": "fields", "value": "added_by" }, { "key": "from", "value": "688200" }, { "key": "limit", "value": "4" } ], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"details\": {\n \"sdk_error_code\": \"string\",\n \"error_code\": \"string\",\n \"message\": \"string\"\n }\n },\n \"request_uri\": \"string\",\n \"status\": \"string\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "event": [] }, { "id": "7195b2af-1e42-433e-b822-4ca7c955225f", "name": "Space Requests", "description": { "content": "Raise, list, accept, and reject requests to join a space.", "type": "text/plain" }, "item": [ { "id": "cd188284-a915-4a47-a630-3d229a9f1a8f", "name": "Raise a request to join a space", "request": { "name": "Raise a request to join a space", "description": {}, "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "requests" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "Vani.teams.UPDATE Vani.spaces.UPDATE Vani.spaces.DELETE Vani.zones.READ Vani.editions.UPDATE Vani.spaces.CREATE Vani.teams.CREATE Vani.spaces.READ Vani.editions.CREATE Vani.zones.CREATE Vani.teams.READ Vani.editions.READ Vani.teams.DELETE" }, { "key": "accessTokenUrl", "value": "https://accounts.zoho.com/oauth/v2/token" }, { "key": "authUrl", "value": "https://accounts.zoho.com/oauth/v2/auth" }, { "key": "grant_type", "value": "authorization_code" } ] }, "body": { "mode": "raw", "raw": "{\n \"role\": \"ORGANISER\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "1832ef72-7782-47f2-829c-aeea9fb0231c", "name": "Successful response", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "requests" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"role\": \"ORGANISER\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"edition_id\": \"96499735\",\n \"updated_at\": \"Wed, 06 Aug 2025, 10:12:18\",\n \"request_id\": \"3009000000793049\",\n \"space_id\": \"3009000000694083\",\n \"zuid\": \"80473960\",\n \"status\": \"PENDING\"\n },\n \"message\": \"Space join request created successfully\",\n \"request_uri\": \"/vani/api/v1/editions/96499735/spaces/3009000000694083/requests\",\n \"status\": \"success\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1df278cd-7be3-4e09-8dfd-edb52ff7fc0f", "name": "Invalid request - validation failed", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "requests" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"role\": \"ORGANISER\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"details\": {\n \"sdk_error_code\": \"string\",\n \"error_code\": \"string\",\n \"message\": \"string\"\n }\n },\n \"request_uri\": \"string\",\n \"status\": \"string\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "11257fab-e3a1-4b02-91bf-5d5ad08a8142", "name": "Unauthorized - missing or invalid access token", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "requests" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"role\": \"ORGANISER\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"details\": {\n \"sdk_error_code\": \"string\",\n \"error_code\": \"string\",\n \"message\": \"string\"\n }\n },\n \"request_uri\": \"string\",\n \"status\": \"string\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1c7eb88f-3d28-4509-b413-e2712bfd75a2", "name": "Forbidden - the caller is authenticated but not allowed to perform this operation", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "requests" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"role\": \"ORGANISER\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"details\": {\n \"edition_id\": \"96499735\",\n \"current_user_id\": \"80473960\",\n \"error_code\": \"R1011\",\n \"message\": \"Requesting for downgrade is not allowed\"\n }\n },\n \"request_uri\": \"/vani/api/v1/editions/96499735/spaces/3009000000694083/requests\",\n \"status\": \"error\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "92ce85e6-3bf4-4112-93b7-c1ac21071c1a", "name": "Not found - a resource named in the path does not exist, or is not visible to the caller", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "requests" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"role\": \"ORGANISER\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"details\": {\n \"edition_id\": \"96499735\",\n \"current_user_id\": \"80473960\",\n \"error_code\": \"T1012\",\n \"message\": \"Member not part of team\"\n }\n },\n \"request_uri\": \"/vani/api/v1/editions/96499735/spaces/3009000000694083/requests\",\n \"status\": \"error\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5c35c50b-559b-4821-a477-3f115f7353e0", "name": "Conflict - the requested change conflicts with the current resource state", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "requests" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"role\": \"ORGANISER\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"details\": {\n \"edition_id\": \"96499735\",\n \"current_user_id\": \"80473960\",\n \"error_code\": \"M1001\",\n \"message\": \"The member already has the specified role\"\n }\n },\n \"request_uri\": \"/vani/api/v1/editions/96499735/spaces/3009000000694083/requests\",\n \"status\": \"error\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "26fff63e-d29d-40b6-8703-e22eac41cef9", "name": "Rate limit exceeded - this operation allows 30 requests per minute per user", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "requests" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"role\": \"ORGANISER\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"details\": {\n \"sdk_error_code\": \"string\",\n \"error_code\": \"string\",\n \"message\": \"string\"\n }\n },\n \"request_uri\": \"string\",\n \"status\": \"string\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b4412f61-621a-4a8b-a1a5-0539972cf04a", "name": "Internal server error - the request was well-formed but could not be completed", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "requests" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"role\": \"ORGANISER\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"details\": {\n \"sdk_error_code\": \"string\",\n \"error_code\": \"string\",\n \"message\": \"string\"\n }\n },\n \"request_uri\": \"string\",\n \"status\": \"string\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "97085d19-0708-4d61-ae54-69a23d632d92", "name": "Get the join requests for a space", "request": { "name": "Get the join requests for a space", "description": {}, "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "requests" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "key": "fields", "value": "name", "description": "Specifies the fields (comma-separated) to retrieve. Allowed values: requested_time, requested_by, name, request_id, status, role" }, { "disabled": false, "key": "from", "value": "688200", "description": "The starting index from where the results should be fetched. Default value is 0" }, { "disabled": false, "key": "limit", "value": "4", "description": "The maximum number of results to return in the response. Default value is 20" } ], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "Vani.teams.UPDATE Vani.spaces.UPDATE Vani.spaces.DELETE Vani.zones.READ Vani.editions.UPDATE Vani.spaces.CREATE Vani.teams.CREATE Vani.spaces.READ Vani.editions.CREATE Vani.zones.CREATE Vani.teams.READ Vani.editions.READ Vani.teams.DELETE" }, { "key": "accessTokenUrl", "value": "https://accounts.zoho.com/oauth/v2/token" }, { "key": "authUrl", "value": "https://accounts.zoho.com/oauth/v2/auth" }, { "key": "grant_type", "value": "authorization_code" } ] } }, "response": [ { "id": "ec848dda-1445-4a64-a5e8-e1317705c6de", "name": "Successful response", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "requests" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "fields", "value": "name" }, { "key": "from", "value": "688200" }, { "key": "limit", "value": "4" } ], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"requests\": [\n {\n \"requested_time\": \"Wed, 06 Aug 2025, 16:05:37\",\n \"requested_by\": \"80215739\",\n \"role\": \"VIEWER\",\n \"name\": \"naga.vg\",\n \"request_id\": \"3009000000789151\",\n \"status\": \"PENDING\"\n },\n {\n \"requested_time\": \"Wed, 06 Aug 2025, 16:10:51\",\n \"requested_by\": \"80473960\",\n \"role\": \"VIEWER\",\n \"name\": \"naga.vg\",\n \"request_id\": \"3009000000789147\",\n \"status\": \"PENDING\"\n }\n ]\n },\n \"message\": \"Space join requests fetched successfully\",\n \"request_uri\": \"/vani/api/v1/editions/96499735/spaces/3009000000701079/requests\",\n \"status\": \"success\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "13620236-aa20-4c11-8a00-6ab6c4af3fd6", "name": "Invalid request - validation failed", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "requests" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "fields", "value": "name" }, { "key": "from", "value": "688200" }, { "key": "limit", "value": "4" } ], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"details\": {\n \"sdk_error_code\": \"string\",\n \"error_code\": \"string\",\n \"message\": \"string\"\n }\n },\n \"request_uri\": \"string\",\n \"status\": \"string\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "42915ad5-749e-4325-b3d3-604d264ba535", "name": "Unauthorized - missing or invalid access token", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "requests" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "fields", "value": "name" }, { "key": "from", "value": "688200" }, { "key": "limit", "value": "4" } ], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"details\": {\n \"edition_id\": \"96499735\",\n \"current_user_id\": \"80473960\",\n \"error_code\": \"A1003\",\n \"team_id\": \"3009000000694083\",\n \"message\": \"The user doesn't have permission to perform this action\"\n }\n },\n \"request_uri\": \"/vani/api/v1/editions/96499735/spaces/3009000000694083/requests\",\n \"status\": \"error\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "90aa362a-b535-46a6-88b7-b25443d3d25b", "name": "Not found - a resource named in the path does not exist, or is not visible to the caller", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "requests" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "fields", "value": "name" }, { "key": "from", "value": "688200" }, { "key": "limit", "value": "4" } ], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"details\": {\n \"edition_id\": \"96499735\",\n \"current_user_id\": \"96384499\",\n \"error_code\": \"S1009\",\n \"team_id\": \"300900000064083\",\n \"message\": \"Space not found\"\n }\n },\n \"request_uri\": \"/vani/api/v1/editions/96499735/spaces/300900000064083/requests\",\n \"status\": \"error\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "efdbdc4c-8cc2-4f2c-b07c-b2bd60fc42c4", "name": "Rate limit exceeded - this operation allows 30 requests per minute per user", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "requests" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "fields", "value": "name" }, { "key": "from", "value": "688200" }, { "key": "limit", "value": "4" } ], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"details\": {\n \"sdk_error_code\": \"string\",\n \"error_code\": \"string\",\n \"message\": \"string\"\n }\n },\n \"request_uri\": \"string\",\n \"status\": \"string\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a1c381ef-9651-431a-9ca2-0af7092def26", "name": "Internal server error - the request was well-formed but could not be completed", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "requests" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "fields", "value": "name" }, { "key": "from", "value": "688200" }, { "key": "limit", "value": "4" } ], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"details\": {\n \"sdk_error_code\": \"string\",\n \"error_code\": \"string\",\n \"message\": \"string\"\n }\n },\n \"request_uri\": \"string\",\n \"status\": \"string\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "6b40ed2e-1871-42d6-9339-b6ed0f0d4446", "name": "Accept a request to join a space", "request": { "name": "Accept a request to join a space", "description": {}, "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "requests", ":request_id", "accept" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "disabled": false, "type": "any", "value": "string", "key": "request_id", "description": "(Required) The unique identifier of the request" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "Vani.teams.UPDATE Vani.spaces.UPDATE Vani.spaces.DELETE Vani.zones.READ Vani.editions.UPDATE Vani.spaces.CREATE Vani.teams.CREATE Vani.spaces.READ Vani.editions.CREATE Vani.zones.CREATE Vani.teams.READ Vani.editions.READ Vani.teams.DELETE" }, { "key": "accessTokenUrl", "value": "https://accounts.zoho.com/oauth/v2/token" }, { "key": "authUrl", "value": "https://accounts.zoho.com/oauth/v2/auth" }, { "key": "grant_type", "value": "authorization_code" } ] } }, "response": [ { "id": "2eb2a743-7da0-4bc8-9236-b51bf4683426", "name": "Successful response", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "requests", ":request_id", "accept" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "disabled": false, "type": "any", "value": "string", "key": "request_id", "description": "(Required) The unique identifier of the request" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"role_name\": \"VIEWER\",\n \"edition_id\": \"96499735\",\n \"updated_at\": \"Wed, 06 Aug 2025, 20:07:20\",\n \"request_id\": \"3009000000789147\",\n \"space_id\": \"3009000000701079\",\n \"zuid\": \"80473960\",\n \"status\": \"ACCEPTED\"\n },\n \"message\": \"Space join request accepted successfully\",\n \"request_uri\": \"/vani/api/v1/editions/96499735/spaces/3009000000701079/requests/3009000000789147/accept\",\n \"status\": \"success\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5031cddd-beba-4542-b22e-e8006760e404", "name": "Invalid request - validation failed", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "requests", ":request_id", "accept" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "disabled": false, "type": "any", "value": "string", "key": "request_id", "description": "(Required) The unique identifier of the request" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"details\": {\n \"edition_id\": \"96499735\",\n \"current_user_id\": \"96384499\",\n \"error_code\": \"R1003\",\n \"team_id\": \"3009000000694083\",\n \"message\": \"Invalid request ID\"\n }\n },\n \"request_uri\": \"/vani/api/v1/editions/96499735/spaces/3009000000694083/requests/3009000000777013/accept\",\n \"status\": \"error\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3a48a0b0-afa2-491d-8e6d-352beffcf305", "name": "Unauthorized - missing or invalid access token", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "requests", ":request_id", "accept" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "disabled": false, "type": "any", "value": "string", "key": "request_id", "description": "(Required) The unique identifier of the request" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"details\": {\n \"edition_id\": \"96499735\",\n \"current_user_id\": \"80473960\",\n \"error_code\": \"A1003\",\n \"team_id\": \"3009000000694083\",\n \"message\": \"The user doesn't have permission to perform this action\"\n }\n },\n \"request_uri\": \"/vani/api/v1/editions/96499735/spaces/3009000000694083/requests/3009000000777109/accept\",\n \"status\": \"error\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2e00b9d9-a3a0-42f9-8b70-d85496e1713d", "name": "Not found - a resource named in the path does not exist, or is not visible to the caller", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "requests", ":request_id", "accept" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "disabled": false, "type": "any", "value": "string", "key": "request_id", "description": "(Required) The unique identifier of the request" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"details\": {\n \"sdk_error_code\": \"string\",\n \"error_code\": \"string\",\n \"message\": \"string\"\n }\n },\n \"request_uri\": \"string\",\n \"status\": \"string\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9339fb80-4b50-41f1-88ba-9bc0a30edb5c", "name": "Rate limit exceeded - this operation allows 30 requests per minute per user", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "requests", ":request_id", "accept" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "disabled": false, "type": "any", "value": "string", "key": "request_id", "description": "(Required) The unique identifier of the request" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"details\": {\n \"sdk_error_code\": \"string\",\n \"error_code\": \"string\",\n \"message\": \"string\"\n }\n },\n \"request_uri\": \"string\",\n \"status\": \"string\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "580410f7-1366-4b4e-bf58-2b8543f73de9", "name": "Internal server error - the request was well-formed but could not be completed", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "requests", ":request_id", "accept" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "disabled": false, "type": "any", "value": "string", "key": "request_id", "description": "(Required) The unique identifier of the request" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"details\": {\n \"sdk_error_code\": \"string\",\n \"error_code\": \"string\",\n \"message\": \"string\"\n }\n },\n \"request_uri\": \"string\",\n \"status\": \"string\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "df3102e8-d445-467a-a03b-e0c0c26dfa3d", "name": "Get the current user's join requests for a space", "request": { "name": "Get the current user's join requests for a space", "description": {}, "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "requests", "my-requests" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "key": "fields", "value": "name", "description": "Specifies the fields (comma-separated) to retrieve. Allowed values: requested_time, requested_by, name, request_id, status, role" } ], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "Vani.teams.UPDATE Vani.spaces.UPDATE Vani.spaces.DELETE Vani.zones.READ Vani.editions.UPDATE Vani.spaces.CREATE Vani.teams.CREATE Vani.spaces.READ Vani.editions.CREATE Vani.zones.CREATE Vani.teams.READ Vani.editions.READ Vani.teams.DELETE" }, { "key": "accessTokenUrl", "value": "https://accounts.zoho.com/oauth/v2/token" }, { "key": "authUrl", "value": "https://accounts.zoho.com/oauth/v2/auth" }, { "key": "grant_type", "value": "authorization_code" } ] } }, "response": [ { "id": "6441e0ed-bc37-431f-9ddc-c5301ef23da9", "name": "Successful response", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "requests", "my-requests" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "fields", "value": "name" } ], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"requests\": {\n \"requested_time\": \"Wed, 06 Aug 2025, 16:10:51\",\n \"requested_by\": \"80473960\",\n \"role\": \"VIEWER\",\n \"request_id\": \"3009000000789147\",\n \"status\": \"PENDING\"\n }\n },\n \"message\": \"Space join request fetched successfully\",\n \"request_uri\": \"/vani/api/v1/editions/96499735/spaces/3009000000701079/requests/my-requests\",\n \"status\": \"success\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "aab8b30d-7c81-4328-ac7d-2d254b5b985e", "name": "Invalid request - validation failed", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "requests", "my-requests" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "fields", "value": "name" } ], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"details\": {\n \"sdk_error_code\": \"string\",\n \"error_code\": \"string\",\n \"message\": \"string\"\n }\n },\n \"request_uri\": \"string\",\n \"status\": \"string\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7d204f9f-4b9c-4af9-9630-55ae5e4a27f1", "name": "Unauthorized - missing or invalid access token", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "requests", "my-requests" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "fields", "value": "name" } ], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"details\": {\n \"sdk_error_code\": \"string\",\n \"error_code\": \"string\",\n \"message\": \"string\"\n }\n },\n \"request_uri\": \"string\",\n \"status\": \"string\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c8528e0c-7abd-4479-b5d4-c41298775f86", "name": "Not found - a resource named in the path does not exist, or is not visible to the caller", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "requests", "my-requests" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "fields", "value": "name" } ], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"details\": {\n \"edition_id\": \"96499735\",\n \"current_user_id\": \"80473960\",\n \"error_code\": \"R1014\",\n \"team_id\": \"3009000000694083\",\n \"message\": \"Space join request not found\"\n }\n },\n \"request_uri\": \"/vani/api/v1/editions/96499735/spaces/3009000000694083/requests/my-requests\",\n \"status\": \"error\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "cf19c90e-f22b-4219-b4f2-bc781d104886", "name": "Rate limit exceeded - this operation allows 30 requests per minute per user", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "requests", "my-requests" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "fields", "value": "name" } ], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"details\": {\n \"sdk_error_code\": \"string\",\n \"error_code\": \"string\",\n \"message\": \"string\"\n }\n },\n \"request_uri\": \"string\",\n \"status\": \"string\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "52e63ea7-ca55-4b84-945a-3c3e75376b66", "name": "Internal server error - the request was well-formed but could not be completed", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "requests", "my-requests" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "fields", "value": "name" } ], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"details\": {\n \"sdk_error_code\": \"string\",\n \"error_code\": \"string\",\n \"message\": \"string\"\n }\n },\n \"request_uri\": \"string\",\n \"status\": \"string\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "9f3bdd92-ff96-408c-9d51-622d552a7cec", "name": "Reject a request to join a space", "request": { "name": "Reject a request to join a space", "description": {}, "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "requests", ":request_id", "reject" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "disabled": false, "type": "any", "value": "string", "key": "request_id", "description": "(Required) The unique identifier of the request" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "Vani.teams.UPDATE Vani.spaces.UPDATE Vani.spaces.DELETE Vani.zones.READ Vani.editions.UPDATE Vani.spaces.CREATE Vani.teams.CREATE Vani.spaces.READ Vani.editions.CREATE Vani.zones.CREATE Vani.teams.READ Vani.editions.READ Vani.teams.DELETE" }, { "key": "accessTokenUrl", "value": "https://accounts.zoho.com/oauth/v2/token" }, { "key": "authUrl", "value": "https://accounts.zoho.com/oauth/v2/auth" }, { "key": "grant_type", "value": "authorization_code" } ] } }, "response": [ { "id": "3b6a675f-fe28-49b9-843f-4014ed7960e3", "name": "Successful response", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "requests", ":request_id", "reject" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "disabled": false, "type": "any", "value": "string", "key": "request_id", "description": "(Required) The unique identifier of the request" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"edition_id\": \"112255940\",\n \"updated_at\": \"Fri, 21 Aug 2026, 20:10:08\",\n \"request_id\": \"5777000000922022\",\n \"space_id\": \"5777000000919096\",\n \"zuid\": \"97049596\",\n \"status\": \"REJECTED\"\n },\n \"message\": \"Space join request rejected successfully\",\n \"request_uri\": \"/vani/api/v1/editions/112255940/spaces/5777000000919096/requests/5777000000922022/reject\",\n \"status\": \"success\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2a2bd738-5f72-4aef-a18f-069b0ac2203e", "name": "Invalid request - validation failed", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "requests", ":request_id", "reject" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "disabled": false, "type": "any", "value": "string", "key": "request_id", "description": "(Required) The unique identifier of the request" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"details\": {\n \"sdk_error_code\": \"string\",\n \"error_code\": \"string\",\n \"message\": \"string\"\n }\n },\n \"request_uri\": \"string\",\n \"status\": \"string\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "db9e1f5f-d41a-4d77-8c98-5aac66862f15", "name": "Unauthorized - missing or invalid access token", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "requests", ":request_id", "reject" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "disabled": false, "type": "any", "value": "string", "key": "request_id", "description": "(Required) The unique identifier of the request" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"details\": {\n \"edition_id\": \"96499735\",\n \"current_user_id\": \"80473960\",\n \"error_code\": \"A1003\",\n \"team_id\": \"3009000000694083\",\n \"message\": \"The user doesn't have permission to perform this action\"\n }\n },\n \"request_uri\": \"/vani/api/v1/editions/96499735/spaces/3009000000694083/requests/3009000000777117/reject\",\n \"status\": \"error\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "cf1c93cb-fc36-4def-bc4f-d5dee6b4099b", "name": "Not found - a resource named in the path does not exist, or is not visible to the caller", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "requests", ":request_id", "reject" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "disabled": false, "type": "any", "value": "string", "key": "request_id", "description": "(Required) The unique identifier of the request" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"details\": {\n \"sdk_error_code\": \"string\",\n \"error_code\": \"string\",\n \"message\": \"string\"\n }\n },\n \"request_uri\": \"string\",\n \"status\": \"string\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a521d0f6-98de-4a19-82b6-82a51d5d8b47", "name": "Conflict - the requested change conflicts with the current resource state", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "requests", ":request_id", "reject" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "disabled": false, "type": "any", "value": "string", "key": "request_id", "description": "(Required) The unique identifier of the request" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"details\": {\n \"edition_id\": \"96499735\",\n \"current_user_id\": \"96384499\",\n \"error_code\": \"R1015\",\n \"team_id\": \"3009000000694083\",\n \"message\": \"Space join request is already rejected\"\n }\n },\n \"request_uri\": \"/vani/api/v1/editions/96499735/spaces/3009000000694083/requests/3009000000777117/reject\",\n \"status\": \"error\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f9bc7195-6884-4964-b5f2-2f2d6ac99990", "name": "Rate limit exceeded - this operation allows 30 requests per minute per user", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "requests", ":request_id", "reject" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "disabled": false, "type": "any", "value": "string", "key": "request_id", "description": "(Required) The unique identifier of the request" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"details\": {\n \"sdk_error_code\": \"string\",\n \"error_code\": \"string\",\n \"message\": \"string\"\n }\n },\n \"request_uri\": \"string\",\n \"status\": \"string\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ac4a6a2a-5ebc-4f75-b09d-7a38e85c15e4", "name": "Internal server error - the request was well-formed but could not be completed", "originalRequest": { "url": { "path": [ "vani", "api", "v1", "editions", ":edition_id", "spaces", ":space_id", "requests", ":request_id", "reject" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "string", "key": "edition_id", "description": "(Required) The unique identifier of the edition" }, { "disabled": false, "type": "any", "value": "string", "key": "space_id", "description": "(Required) The unique identifier of the space" }, { "disabled": false, "type": "any", "value": "string", "key": "request_id", "description": "(Required) The unique identifier of the request" }, { "description": "Data-centre TLD for your edition. (This can only be one of com,in,eu,ca,com.au,sa,ae)", "type": "any", "value": "{{dc}}", "key": "dc" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: oauth2", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": {\n \"details\": {\n \"sdk_error_code\": \"string\",\n \"error_code\": \"string\",\n \"message\": \"string\"\n }\n },\n \"request_uri\": \"string\",\n \"status\": \"string\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "event": [] } ], "event": [], "variable": [ { "key": "baseUrl", "value": "https://api.app.vanihq.{{dc}}", "description": "API host. Change {{dc}} to your edition's data-centre TLD." }, { "key": "dc", "value": "com", "description": "Data-centre TLD for your edition. One of: com, in, eu, ca, com.au, sa, ae." } ], "info": { "_postman_id": "efa2c708-c3e4-4c67-9fbd-0dfad0090b05", "name": "Spaces", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "description": "Spaces (projects) within an edition, their members, join requests, and role lookups." } }