Zoho Projects API Documentation
Text copied
File not found

Team Folder

This module covers operations related to the team folder. Use this API to create, associate, disassociate, get, and delete the team folder.

Get Project Team Folder Settings

Retrieve the team folder settings of a project.

GET

/api/v3/portal/[PORTAL_ID]/projects/[PROJECT_ID]/documents/teamfolder/[TEAMFOLDER_ID]

OAuth Scope:

ZohoProjects.documents.READ, WorkDrive.workspace.ALL,Workdrive.team.ALL,WorkDrive.files.ALL

Path Parameters

Param Name
Data Type
Description

Request Example

Request Example
  • cURL
  • Deluge
  • Node.js
  • Ruby
  • PHP
  • Python
  • C
  • C#
  • C++
  • Clojure
  • Go
  • HTTP
  • Java
  • JS Fetch
  • Kotlin
  • Objective-C
  • OCaml
  • PowerShell
  • R
  • Swift

curl -X GET \
'https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/[TEAMFOLDER_ID]' \
-H 'Authorization: Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa'

url = "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/[TEAMFOLDER_ID]";
response = invokeUrl
[
    url: url
    type: GET
    connection: "projects"
];
info response;

const https = require('https');
const url = new URL('https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/[TEAMFOLDER_ID]');

const options = {
  hostname: url.hostname,
  path: url.pathname + url.search,
  method: 'GET',
  headers: {
    'Authorization': 'Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa'
  }
};

const req = https.request(options, (res) => {
  let data = '';
  res.on('data', (chunk) => { data += chunk; });
  res.on('end', () => { console.log(JSON.parse(data)); });
});

req.on('error', (err) => { console.error(err); });
req.end();

require 'net/http'
require 'uri'
require 'json'

url = URI("https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/[TEAMFOLDER_ID]")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa"

response = http.request(request)
puts response.read_body

<?php
$url = "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/[TEAMFOLDER_ID]";

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => $url,
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa"
  ],
]);

$response = curl_exec($curl);
curl_close($curl);

echo $response;

import requests

url = "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/[TEAMFOLDER_ID]"

headers = {
    "Authorization": "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa",
}

response = requests.get(url, headers=headers)

print(response.json())

#include <stdio.h>
#include <string.h>
#include <curl/curl.h>

int main(void) {
    CURL *curl = curl_easy_init();
    if (curl) {
        struct curl_slist *headers = NULL;
        headers = curl_slist_append(headers, "Authorization: Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa");

        curl_easy_setopt(curl, CURLOPT_URL, "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/[TEAMFOLDER_ID]");
        curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);
        curl_easy_setopt(curl, CURLOPT_CUSTOMREQUEST, "GET");

        CURLcode res = curl_easy_perform(curl);
        if (res != CURLE_OK)
            fprintf(stderr, "curl failed: %s\n", curl_easy_strerror(res));

        curl_slist_free_all(headers);
        curl_easy_cleanup(curl);
    }
    return 0;
}

using System.Net.Http;
using System.Text;
using System.Web;

var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa");

var request = new HttpRequestMessage(HttpMethod.Get, "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/[TEAMFOLDER_ID]");

var response = await client.SendAsync(request);
var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);

#include <iostream>
#include <string>
#include <curl/curl.h>

static size_t WriteCallback(void* contents, size_t size, size_t nmemb, std::string* output) {
    output->append((char*)contents, size * nmemb);
    return size * nmemb;
}

int main() {
    CURL* curl = curl_easy_init();
    if (curl) {
        std::string response;
        struct curl_slist* headers = NULL;
        headers = curl_slist_append(headers, "Authorization: Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa");

        curl_easy_setopt(curl, CURLOPT_URL, "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/[TEAMFOLDER_ID]");
        curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);
        curl_easy_setopt(curl, CURLOPT_CUSTOMREQUEST, "GET");
        curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, WriteCallback);
        curl_easy_setopt(curl, CURLOPT_WRITEDATA, &response);

        CURLcode res = curl_easy_perform(curl);
        if (res == CURLE_OK)
            std::cout << response << std::endl;
        else
            std::cerr << curl_easy_strerror(res) << std::endl;

        curl_slist_free_all(headers);
        curl_easy_cleanup(curl);
    }
    return 0;
}

(require '[clj-http.client :as client])

(def response
  (client/get "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/[TEAMFOLDER_ID]"
    {:headers {"Authorization" "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa"}
     :as :json}))

(println (:body response))

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    req, _ := http.NewRequest("GET", "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/[TEAMFOLDER_ID]", nil)
    req.Header.Add("Authorization", "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa")

    resp, _ := http.DefaultClient.Do(req)
    defer resp.Body.Close()
    body, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body))
}

GET https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/[TEAMFOLDER_ID] HTTP/1.1
Host: https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/[TEAMFOLDER_ID]
Authorization: Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa

HttpClientBuilder httpClientBuilder = HttpClientBuilder.create();

SSLContext sslContext = SSLContext.getDefault();
SSLConnectionSocketFactory sslConnectionSocketFactory = new SSLConnectionSocketFactory(sslContext, NoopHostnameVerifier.INSTANCE);
CloseableHttpClient httpclient = httpClientBuilder.setSSLSocketFactory(sslConnectionSocketFactory).build();

URIBuilder uriBuilder = new URIBuilder("https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/[TEAMFOLDER_ID]");
HttpUriRequest requestObj = new HttpGet(uriBuilder.build());
requestObj.addHeader("Authorization", "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa");

HttpResponse response = httpclient.execute(requestObj);

HttpEntity responseEntity = response.getEntity();
Object responseObject = EntityUtils.toString(responseEntity);
String responseString = responseObject.toString();

const url = 'https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/[TEAMFOLDER_ID]';

const options = {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa'
  }
};

fetch(url, options)
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error(error));

import java.net.HttpURLConnection
import java.net.URL
import okhttp3.HttpUrl.Companion.toHttpUrl

fun main() {
    val url = URL("https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/[TEAMFOLDER_ID]")
    val conn = url.openConnection() as HttpURLConnection
    conn.requestMethod = "GET"
    conn.setRequestProperty("Authorization", "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa")

    val response = conn.inputStream.bufferedReader().readText()
    println(response)
}

NSURL *url = [NSURL URLWithString:@"https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/[TEAMFOLDER_ID]"];
NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:url];
[request setHTTPMethod:@"GET"];
[request setValue:@"Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa" forHTTPHeaderField:@"Authorization"];

NSURLSession *session = [NSURLSession sharedSession];
NSURLSessionDataTask *task = [session dataTaskWithRequest:request
    completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) {
        NSString *result = [[NSString alloc] initWithData:data encoding:NSUTF8StringEncoding];
        NSLog(@"%@", result);
}];
[task resume];

open Lwt
open Cohttp_lwt_unix

let () =
  let uri = Uri.of_string "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/[TEAMFOLDER_ID]" in
  let headers = Cohttp.Header.init ()
    |> fun h -> Cohttp.Header.add h "Authorization" "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa"
  in
  Lwt_main.run (
    Client.get ~headers uri >>= fun (_, body) ->
    Cohttp_lwt.Body.to_string body >|= fun s ->
    print_endline s)

$headers = @{
    "Authorization" = "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa"
}

$response = Invoke-RestMethod -Uri "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/[TEAMFOLDER_ID]" -Method GET -Headers $headers

$response | ConvertTo-Json

library(httr)

url <- "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/[TEAMFOLDER_ID]"

response <- GET(
  url,
  add_headers(Authorization = "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa")
)

content(response, "text")

import Foundation

let url = URL(string: "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/[TEAMFOLDER_ID]")!
var request = URLRequest(url: url)
request.httpMethod = "GET"
request.setValue("Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa", forHTTPHeaderField: "Authorization")

let semaphore = DispatchSemaphore(value: 0)
let task = URLSession.shared.dataTask(with: request) { data, response, error in
    if let data = data, let result = String(data: data, encoding: .utf8) {
        print(result)
    }
    semaphore.signal()
}
task.resume()
semaphore.wait()

Sample Response

200{ "documents" : { "workdrive_folder_id" : "we9i8450c712dd9b643ca9fa3c3009a69f711", "user_permissions" : [ { "workdrive_role" : "editor", "profiles" : [ { "id" : "9000000005923", "name" : "Employee" } ] }, { "workdrive_role" : "organizer", "profiles" : [ { "id" : "9000000002910", "name" : "Manager" } ] }, { "workdrive_role" : "commenter", "profiles" : [ { "id" : "9000000002916", "name" : "Contractor" } ] } ], "name" : "Team Folder", "description" : "Description of the Team Folder", "team_id" : "we9i8141e70a02a78447faf5b0b0ad85d0aee", "folder_id" : "9000000005947" } }

Possible Errors

Create Project Team Folder

Create a team folder in a project.

POST

/api/v3/portal/[PORTAL_ID]/projects/[PROJECT_ID]/documents/teamfolder

OAuth Scope:

ZohoProjects.documents.CREATE, WorkDrive.workspace.ALL,Workdrive.team.ALL,WorkDrive.files.ALL

Path Parameters

Param Name
Data Type
Description

Body Parameters

Param Name
Data Type
Description

Request Example

Request Example
  • cURL
  • Deluge
  • Node.js
  • Ruby
  • PHP
  • Python
  • C
  • C#
  • C++
  • Clojure
  • Go
  • HTTP
  • Java
  • JS Fetch
  • JSON
  • Kotlin
  • Objective-C
  • OCaml
  • PowerShell
  • R
  • Swift

curl -X POST \
'https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder' \
-H 'Authorization: Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa' \
-H 'Content-Type: application/json' \
-d '{"name":"Team Folder","description":"Description of the Team Folder","user_permissions":[{"add":[{"workdrive_role":"admin","users":[{"zpuid":"4000000002055"}],"profiles":[{"id":"22595500000011234"}]}],"remove":[{"workdrive_role":"admin","users":[{"zpuid":"4000000002055"}],"profiles":[{"id":"22595500000011234"}]}],"workdrive_role":"admin","users":[{"zpuid":"4000000002055"}],"profiles":[{"id":"22595500000011234"}]}]}'

url = "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder";
params = Map();
params.put("name", "Team Folder");
params.put("description", "Description of the Team Folder");
params.put("user_permissions", [{"add":[{"workdrive_role":"admin","users":[{"zpuid":"4000000002055"}],"profiles":[{"id":"22595500000011234"}]}],"remove":[{"workdrive_role":"admin","users":[{"zpuid":"4000000002055"}],"profiles":[{"id":"22595500000011234"}]}],"workdrive_role":"admin","users":[{"zpuid":"4000000002055"}],"profiles":[{"id":"22595500000011234"}]}]);
response = invokeUrl
[
    url: url
    type: POST
    parameters: params.toString()
    connection: "projects"
];
info response;

const https = require('https');
const url = new URL('https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder');

const payload = JSON.stringify({"name":"Team Folder","description":"Description of the Team Folder","user_permissions":[{"add":[{"workdrive_role":"admin","users":[{"zpuid":"4000000002055"}],"profiles":[{"id":"22595500000011234"}]}],"remove":[{"workdrive_role":"admin","users":[{"zpuid":"4000000002055"}],"profiles":[{"id":"22595500000011234"}]}],"workdrive_role":"admin","users":[{"zpuid":"4000000002055"}],"profiles":[{"id":"22595500000011234"}]}]});

const options = {
  hostname: url.hostname,
  path: url.pathname + url.search,
  method: 'POST',
  headers: {
    'Authorization': 'Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa',
    'Content-Type': 'application/json',
    'Content-Length': Buffer.byteLength(payload)
  }
};

const req = https.request(options, (res) => {
  let data = '';
  res.on('data', (chunk) => { data += chunk; });
  res.on('end', () => { console.log(JSON.parse(data)); });
});

req.on('error', (err) => { console.error(err); });
req.write(payload);
req.end();

require 'net/http'
require 'uri'
require 'json'

url = URI("https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa"
request["Content-Type"] = "application/json"
request.body = '{"name":"Team Folder","description":"Description of the Team Folder","user_permissions":[{"add":[{"workdrive_role":"admin","users":[{"zpuid":"4000000002055"}],"profiles":[{"id":"22595500000011234"}]}],"remove":[{"workdrive_role":"admin","users":[{"zpuid":"4000000002055"}],"profiles":[{"id":"22595500000011234"}]}],"workdrive_role":"admin","users":[{"zpuid":"4000000002055"}],"profiles":[{"id":"22595500000011234"}]}]}'

response = http.request(request)
puts response.read_body

<?php
$url = "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder";

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => $url,
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => '{"name":"Team Folder","description":"Description of the Team Folder","user_permissions":[{"add":[{"workdrive_role":"admin","users":[{"zpuid":"4000000002055"}],"profiles":[{"id":"22595500000011234"}]}],"remove":[{"workdrive_role":"admin","users":[{"zpuid":"4000000002055"}],"profiles":[{"id":"22595500000011234"}]}],"workdrive_role":"admin","users":[{"zpuid":"4000000002055"}],"profiles":[{"id":"22595500000011234"}]}]}',
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
curl_close($curl);

echo $response;

import requests

url = "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder"

headers = {
    "Authorization": "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa",
    "Content-Type": "application/json",
}

payload = '{"name":"Team Folder","description":"Description of the Team Folder","user_permissions":[{"add":[{"workdrive_role":"admin","users":[{"zpuid":"4000000002055"}],"profiles":[{"id":"22595500000011234"}]}],"remove":[{"workdrive_role":"admin","users":[{"zpuid":"4000000002055"}],"profiles":[{"id":"22595500000011234"}]}],"workdrive_role":"admin","users":[{"zpuid":"4000000002055"}],"profiles":[{"id":"22595500000011234"}]}]}'

response = requests.post(url, headers=headers, data=payload)

print(response.json())

#include <stdio.h>
#include <string.h>
#include <curl/curl.h>

int main(void) {
    CURL *curl = curl_easy_init();
    if (curl) {
        struct curl_slist *headers = NULL;
        headers = curl_slist_append(headers, "Authorization: Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa");
        headers = curl_slist_append(headers, "Content-Type: application/json");

        curl_easy_setopt(curl, CURLOPT_URL, "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder");
        curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);
        curl_easy_setopt(curl, CURLOPT_CUSTOMREQUEST, "POST");
        curl_easy_setopt(curl, CURLOPT_POSTFIELDS, "{\"name\":\"Team Folder\",\"description\":\"Description of the Team Folder\",\"user_permissions\":[{\"add\":[{\"workdrive_role\":\"admin\",\"users\":[{\"zpuid\":\"4000000002055\"}],\"profiles\":[{\"id\":\"22595500000011234\"}]}],\"remove\":[{\"workdrive_role\":\"admin\",\"users\":[{\"zpuid\":\"4000000002055\"}],\"profiles\":[{\"id\":\"22595500000011234\"}]}],\"workdrive_role\":\"admin\",\"users\":[{\"zpuid\":\"4000000002055\"}],\"profiles\":[{\"id\":\"22595500000011234\"}]}]}");

        CURLcode res = curl_easy_perform(curl);
        if (res != CURLE_OK)
            fprintf(stderr, "curl failed: %s\n", curl_easy_strerror(res));

        curl_slist_free_all(headers);
        curl_easy_cleanup(curl);
    }
    return 0;
}

using System.Net.Http;
using System.Text;
using System.Web;

var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa");

var request = new HttpRequestMessage(HttpMethod.Post, "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder");
request.Content = new StringContent(
    @"{""name"":""Team Folder"",""description"":""Description of the Team Folder"",""user_permissions"":[{""add"":[{""workdrive_role"":""admin"",""users"":[{""zpuid"":""4000000002055""}],""profiles"":[{""id"":""22595500000011234""}]}],""remove"":[{""workdrive_role"":""admin"",""users"":[{""zpuid"":""4000000002055""}],""profiles"":[{""id"":""22595500000011234""}]}],""workdrive_role"":""admin"",""users"":[{""zpuid"":""4000000002055""}],""profiles"":[{""id"":""22595500000011234""}]}]}",
    Encoding.UTF8,
    "application/json"
);

var response = await client.SendAsync(request);
var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);

#include <iostream>
#include <string>
#include <curl/curl.h>

static size_t WriteCallback(void* contents, size_t size, size_t nmemb, std::string* output) {
    output->append((char*)contents, size * nmemb);
    return size * nmemb;
}

int main() {
    CURL* curl = curl_easy_init();
    if (curl) {
        std::string response;
        struct curl_slist* headers = NULL;
        headers = curl_slist_append(headers, "Authorization: Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa");
        headers = curl_slist_append(headers, "Content-Type: application/json");

        curl_easy_setopt(curl, CURLOPT_URL, "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder");
        curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);
        curl_easy_setopt(curl, CURLOPT_CUSTOMREQUEST, "POST");
        curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, WriteCallback);
        curl_easy_setopt(curl, CURLOPT_WRITEDATA, &response);
        curl_easy_setopt(curl, CURLOPT_POSTFIELDS, "{\"name\":\"Team Folder\",\"description\":\"Description of the Team Folder\",\"user_permissions\":[{\"add\":[{\"workdrive_role\":\"admin\",\"users\":[{\"zpuid\":\"4000000002055\"}],\"profiles\":[{\"id\":\"22595500000011234\"}]}],\"remove\":[{\"workdrive_role\":\"admin\",\"users\":[{\"zpuid\":\"4000000002055\"}],\"profiles\":[{\"id\":\"22595500000011234\"}]}],\"workdrive_role\":\"admin\",\"users\":[{\"zpuid\":\"4000000002055\"}],\"profiles\":[{\"id\":\"22595500000011234\"}]}]}");

        CURLcode res = curl_easy_perform(curl);
        if (res == CURLE_OK)
            std::cout << response << std::endl;
        else
            std::cerr << curl_easy_strerror(res) << std::endl;

        curl_slist_free_all(headers);
        curl_easy_cleanup(curl);
    }
    return 0;
}

(require '[clj-http.client :as client])

(def response
  (client/post "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder"
    {:headers {"Authorization" "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa"
                "Content-Type" "application/json"}
     :body "{\"name\":\"Team Folder\",\"description\":\"Description of the Team Folder\",\"user_permissions\":[{\"add\":[{\"workdrive_role\":\"admin\",\"users\":[{\"zpuid\":\"4000000002055\"}],\"profiles\":[{\"id\":\"22595500000011234\"}]}],\"remove\":[{\"workdrive_role\":\"admin\",\"users\":[{\"zpuid\":\"4000000002055\"}],\"profiles\":[{\"id\":\"22595500000011234\"}]}],\"workdrive_role\":\"admin\",\"users\":[{\"zpuid\":\"4000000002055\"}],\"profiles\":[{\"id\":\"22595500000011234\"}]}]}"
     :as :json}))

(println (:body response))

package main

import (
    "fmt"
    "io"
    "net/http"
    "strings"
)

func main() {
    payload := strings.NewReader("{\"name\":\"Team Folder\",\"description\":\"Description of the Team Folder\",\"user_permissions\":[{\"add\":[{\"workdrive_role\":\"admin\",\"users\":[{\"zpuid\":\"4000000002055\"}],\"profiles\":[{\"id\":\"22595500000011234\"}]}],\"remove\":[{\"workdrive_role\":\"admin\",\"users\":[{\"zpuid\":\"4000000002055\"}],\"profiles\":[{\"id\":\"22595500000011234\"}]}],\"workdrive_role\":\"admin\",\"users\":[{\"zpuid\":\"4000000002055\"}],\"profiles\":[{\"id\":\"22595500000011234\"}]}]}")
    req, _ := http.NewRequest("POST", "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder", payload)
    req.Header.Add("Authorization", "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa")
    req.Header.Add("Content-Type", "application/json")

    resp, _ := http.DefaultClient.Do(req)
    defer resp.Body.Close()
    body, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body))
}

POST https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder HTTP/1.1
Host: https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder
Authorization: Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa
Content-Type: application/json

{"name":"Team Folder","description":"Description of the Team Folder","user_permissions":[{"add":[{"workdrive_role":"admin","users":[{"zpuid":"4000000002055"}],"profiles":[{"id":"22595500000011234"}]}],"remove":[{"workdrive_role":"admin","users":[{"zpuid":"4000000002055"}],"profiles":[{"id":"22595500000011234"}]}],"workdrive_role":"admin","users":[{"zpuid":"4000000002055"}],"profiles":[{"id":"22595500000011234"}]}]}

HttpClientBuilder httpClientBuilder = HttpClientBuilder.create();

SSLContext sslContext = SSLContext.getDefault();
SSLConnectionSocketFactory sslConnectionSocketFactory = new SSLConnectionSocketFactory(sslContext, NoopHostnameVerifier.INSTANCE);
CloseableHttpClient httpclient = httpClientBuilder.setSSLSocketFactory(sslConnectionSocketFactory).build();

URIBuilder uriBuilder = new URIBuilder("https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder");
HttpUriRequest requestObj = new HttpPost(uriBuilder.build());
requestObj.addHeader("Authorization", "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa");

HttpEntityEnclosingRequestBase requestBase = (HttpEntityEnclosingRequestBase) requestObj;
String requestBody = "{\"name\":\"Team Folder\",\"description\":\"Description of the Team Folder\",\"user_permissions\":[{\"add\":[{\"workdrive_role\":\"admin\",\"users\":[{\"zpuid\":\"4000000002055\"}],\"profiles\":[{\"id\":\"22595500000011234\"}]}],\"remove\":[{\"workdrive_role\":\"admin\",\"users\":[{\"zpuid\":\"4000000002055\"}],\"profiles\":[{\"id\":\"22595500000011234\"}]}],\"workdrive_role\":\"admin\",\"users\":[{\"zpuid\":\"4000000002055\"}],\"profiles\":[{\"id\":\"22595500000011234\"}]}]}";
requestBase.setEntity(new StringEntity(requestBody, HTTP.UTF_8));

HttpResponse response = httpclient.execute(requestObj);

HttpEntity responseEntity = response.getEntity();
Object responseObject = EntityUtils.toString(responseEntity);
String responseString = responseObject.toString();

const url = 'https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder';

const options = {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({"name":"Team Folder","description":"Description of the Team Folder","user_permissions":[{"add":[{"workdrive_role":"admin","users":[{"zpuid":"4000000002055"}],"profiles":[{"id":"22595500000011234"}]}],"remove":[{"workdrive_role":"admin","users":[{"zpuid":"4000000002055"}],"profiles":[{"id":"22595500000011234"}]}],"workdrive_role":"admin","users":[{"zpuid":"4000000002055"}],"profiles":[{"id":"22595500000011234"}]}]})
};

fetch(url, options)
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error(error));

{"name":"Team Folder","description":"Description of the Team Folder","user_permissions":[{"add":[{"workdrive_role":"admin","users":[{"zpuid":"4000000002055"}],"profiles":[{"id":"22595500000011234"}]}],"remove":[{"workdrive_role":"admin","users":[{"zpuid":"4000000002055"}],"profiles":[{"id":"22595500000011234"}]}],"workdrive_role":"admin","users":[{"zpuid":"4000000002055"}],"profiles":[{"id":"22595500000011234"}]}]}
import java.net.HttpURLConnection
import java.net.URL
import okhttp3.HttpUrl.Companion.toHttpUrl

fun main() {
    val url = URL("https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder")
    val conn = url.openConnection() as HttpURLConnection
    conn.requestMethod = "POST"
    conn.setRequestProperty("Authorization", "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa")
    conn.setRequestProperty("Content-Type", "application/json")
    conn.doOutput = true
    conn.outputStream.bufferedWriter().use { it.write("""{"name":"Team Folder","description":"Description of the Team Folder","user_permissions":[{"add":[{"workdrive_role":"admin","users":[{"zpuid":"4000000002055"}],"profiles":[{"id":"22595500000011234"}]}],"remove":[{"workdrive_role":"admin","users":[{"zpuid":"4000000002055"}],"profiles":[{"id":"22595500000011234"}]}],"workdrive_role":"admin","users":[{"zpuid":"4000000002055"}],"profiles":[{"id":"22595500000011234"}]}]}""") }

    val response = conn.inputStream.bufferedReader().readText()
    println(response)
}

NSURL *url = [NSURL URLWithString:@"https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder"];
NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:url];
[request setHTTPMethod:@"POST"];
[request setValue:@"Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa" forHTTPHeaderField:@"Authorization"];
[request setValue:@"application/json" forHTTPHeaderField:@"Content-Type"];
NSData *body = [@"{\"name\":\"Team Folder\",\"description\":\"Description of the Team Folder\",\"user_permissions\":[{\"add\":[{\"workdrive_role\":\"admin\",\"users\":[{\"zpuid\":\"4000000002055\"}],\"profiles\":[{\"id\":\"22595500000011234\"}]}],\"remove\":[{\"workdrive_role\":\"admin\",\"users\":[{\"zpuid\":\"4000000002055\"}],\"profiles\":[{\"id\":\"22595500000011234\"}]}],\"workdrive_role\":\"admin\",\"users\":[{\"zpuid\":\"4000000002055\"}],\"profiles\":[{\"id\":\"22595500000011234\"}]}]}" dataUsingEncoding:NSUTF8StringEncoding];
[request setHTTPBody:body];

NSURLSession *session = [NSURLSession sharedSession];
NSURLSessionDataTask *task = [session dataTaskWithRequest:request
    completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) {
        NSString *result = [[NSString alloc] initWithData:data encoding:NSUTF8StringEncoding];
        NSLog(@"%@", result);
}];
[task resume];

open Lwt
open Cohttp_lwt_unix

let () =
  let uri = Uri.of_string "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder" in
  let headers = Cohttp.Header.init ()
    |> fun h -> Cohttp.Header.add h "Authorization" "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa"
    |> fun h -> Cohttp.Header.add h "Content-Type" "application/json"
  in
  let body = Cohttp_lwt.Body.of_string {json|{"name":"Team Folder","description":"Description of the Team Folder","user_permissions":[{"add":[{"workdrive_role":"admin","users":[{"zpuid":"4000000002055"}],"profiles":[{"id":"22595500000011234"}]}],"remove":[{"workdrive_role":"admin","users":[{"zpuid":"4000000002055"}],"profiles":[{"id":"22595500000011234"}]}],"workdrive_role":"admin","users":[{"zpuid":"4000000002055"}],"profiles":[{"id":"22595500000011234"}]}]}|json} in
  Lwt_main.run (
    Client.post ~headers ~body uri >>= fun (_, body) ->
    Cohttp_lwt.Body.to_string body >|= fun s ->
    print_endline s)

$headers = @{
    "Authorization" = "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa"
    "Content-Type" = "application/json"
}

$body = @'
{"name":"Team Folder","description":"Description of the Team Folder","user_permissions":[{"add":[{"workdrive_role":"admin","users":[{"zpuid":"4000000002055"}],"profiles":[{"id":"22595500000011234"}]}],"remove":[{"workdrive_role":"admin","users":[{"zpuid":"4000000002055"}],"profiles":[{"id":"22595500000011234"}]}],"workdrive_role":"admin","users":[{"zpuid":"4000000002055"}],"profiles":[{"id":"22595500000011234"}]}]}
'@

$response = Invoke-RestMethod -Uri "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder" -Method POST -Headers $headers -Body $body

$response | ConvertTo-Json

library(httr)

url <- "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder"

response <- POST(
  url,
  add_headers(Authorization = "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa"),
  content_type_json(),
  body = "{\"name\":\"Team Folder\",\"description\":\"Description of the Team Folder\",\"user_permissions\":[{\"add\":[{\"workdrive_role\":\"admin\",\"users\":[{\"zpuid\":\"4000000002055\"}],\"profiles\":[{\"id\":\"22595500000011234\"}]}],\"remove\":[{\"workdrive_role\":\"admin\",\"users\":[{\"zpuid\":\"4000000002055\"}],\"profiles\":[{\"id\":\"22595500000011234\"}]}],\"workdrive_role\":\"admin\",\"users\":[{\"zpuid\":\"4000000002055\"}],\"profiles\":[{\"id\":\"22595500000011234\"}]}]}"
)

content(response, "text")

import Foundation

let url = URL(string: "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder")!
var request = URLRequest(url: url)
request.httpMethod = "POST"
request.setValue("Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa", forHTTPHeaderField: "Authorization")
request.setValue("application/json", forHTTPHeaderField: "Content-Type")
request.httpBody = """
{"name":"Team Folder","description":"Description of the Team Folder","user_permissions":[{"add":[{"workdrive_role":"admin","users":[{"zpuid":"4000000002055"}],"profiles":[{"id":"22595500000011234"}]}],"remove":[{"workdrive_role":"admin","users":[{"zpuid":"4000000002055"}],"profiles":[{"id":"22595500000011234"}]}],"workdrive_role":"admin","users":[{"zpuid":"4000000002055"}],"profiles":[{"id":"22595500000011234"}]}]}
""".data(using: .utf8)

let semaphore = DispatchSemaphore(value: 0)
let task = URLSession.shared.dataTask(with: request) { data, response, error in
    if let data = data, let result = String(data: data, encoding: .utf8) {
        print(result)
    }
    semaphore.signal()
}
task.resume()
semaphore.wait()

Sample Input

Content-Type: application/json
{ "name" : "Team Folder", "description" : "Description of the Team Folder", "user_permissions" : [ { "add" : [ { "workdrive_role" : "admin", "users" : [ { "zpuid" : "4000000002055" } ], "profiles" : [ { "id" : "22595500000011234" } ] } ], "remove" : [ { "workdrive_role" : "admin", "users" : [ { "zpuid" : "4000000002055" } ], "profiles" : [ { "id" : "22595500000011234" } ] } ], "workdrive_role" : "admin", "users" : [ { "zpuid" : "4000000002055" } ], "profiles" : [ { "id" : "22595500000011234" } ] } ] }

Sample Response

200{ "team_folders" : [ { "workdrive_folder_id" : "we9i8450c712dd9b643ca9fa3c3009a69f711", "is_personal_space" : false, "name" : "Team Folder", "folder_id" : "9000000005947" } ] }

Possible Errors

Update Project Team Folder Details

Modify the settings of a team folder in a project.

PUT

/api/v3/portal/[PORTAL_ID]/projects/[PROJECT_ID]/documents/teamfolder/[TEAMFOLDER_ID]

OAuth Scope:

ZohoProjects.documents.UPDATE, WorkDrive.workspace.ALL,Workdrive.team.ALL,WorkDrive.files.ALL

Path Parameters

Param Name
Data Type
Description

Body Parameters

Param Name
Data Type
Description

Request Example

Request Example
  • cURL
  • Deluge
  • Node.js
  • Ruby
  • PHP
  • Python
  • C
  • C#
  • C++
  • Clojure
  • Go
  • HTTP
  • Java
  • JS Fetch
  • JSON
  • Kotlin
  • Objective-C
  • OCaml
  • PowerShell
  • R
  • Swift

curl -X PUT \
'https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/[TEAMFOLDER_ID]' \
-H 'Authorization: Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa' \
-H 'Content-Type: application/json' \
-d '{"user_permissions":[{"add":[{"workdrive_role":"admin","users":[{"zpuid":"4000000002055"}],"profiles":[{"id":"22595500000011234"}]}],"remove":[{"workdrive_role":"admin","users":[{"zpuid":"4000000002055"}],"profiles":[{"id":"22595500000011234"}]}],"workdrive_role":"admin","users":[{"zpuid":"4000000002055"}],"profiles":[{"id":"22595500000011234"}]}]}'

url = "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/[TEAMFOLDER_ID]";
params = Map();
params.put("user_permissions", [{"add":[{"workdrive_role":"admin","users":[{"zpuid":"4000000002055"}],"profiles":[{"id":"22595500000011234"}]}],"remove":[{"workdrive_role":"admin","users":[{"zpuid":"4000000002055"}],"profiles":[{"id":"22595500000011234"}]}],"workdrive_role":"admin","users":[{"zpuid":"4000000002055"}],"profiles":[{"id":"22595500000011234"}]}]);
response = invokeUrl
[
    url: url
    type: PUT
    parameters: params.toString()
    connection: "projects"
];
info response;

const https = require('https');
const url = new URL('https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/[TEAMFOLDER_ID]');

const payload = JSON.stringify({"user_permissions":[{"add":[{"workdrive_role":"admin","users":[{"zpuid":"4000000002055"}],"profiles":[{"id":"22595500000011234"}]}],"remove":[{"workdrive_role":"admin","users":[{"zpuid":"4000000002055"}],"profiles":[{"id":"22595500000011234"}]}],"workdrive_role":"admin","users":[{"zpuid":"4000000002055"}],"profiles":[{"id":"22595500000011234"}]}]});

const options = {
  hostname: url.hostname,
  path: url.pathname + url.search,
  method: 'PUT',
  headers: {
    'Authorization': 'Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa',
    'Content-Type': 'application/json',
    'Content-Length': Buffer.byteLength(payload)
  }
};

const req = https.request(options, (res) => {
  let data = '';
  res.on('data', (chunk) => { data += chunk; });
  res.on('end', () => { console.log(JSON.parse(data)); });
});

req.on('error', (err) => { console.error(err); });
req.write(payload);
req.end();

require 'net/http'
require 'uri'
require 'json'

url = URI("https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/[TEAMFOLDER_ID]")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["Authorization"] = "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa"
request["Content-Type"] = "application/json"
request.body = '{"user_permissions":[{"add":[{"workdrive_role":"admin","users":[{"zpuid":"4000000002055"}],"profiles":[{"id":"22595500000011234"}]}],"remove":[{"workdrive_role":"admin","users":[{"zpuid":"4000000002055"}],"profiles":[{"id":"22595500000011234"}]}],"workdrive_role":"admin","users":[{"zpuid":"4000000002055"}],"profiles":[{"id":"22595500000011234"}]}]}'

response = http.request(request)
puts response.read_body

<?php
$url = "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/[TEAMFOLDER_ID]";

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => $url,
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => '{"user_permissions":[{"add":[{"workdrive_role":"admin","users":[{"zpuid":"4000000002055"}],"profiles":[{"id":"22595500000011234"}]}],"remove":[{"workdrive_role":"admin","users":[{"zpuid":"4000000002055"}],"profiles":[{"id":"22595500000011234"}]}],"workdrive_role":"admin","users":[{"zpuid":"4000000002055"}],"profiles":[{"id":"22595500000011234"}]}]}',
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
curl_close($curl);

echo $response;

import requests

url = "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/[TEAMFOLDER_ID]"

headers = {
    "Authorization": "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa",
    "Content-Type": "application/json",
}

payload = '{"user_permissions":[{"add":[{"workdrive_role":"admin","users":[{"zpuid":"4000000002055"}],"profiles":[{"id":"22595500000011234"}]}],"remove":[{"workdrive_role":"admin","users":[{"zpuid":"4000000002055"}],"profiles":[{"id":"22595500000011234"}]}],"workdrive_role":"admin","users":[{"zpuid":"4000000002055"}],"profiles":[{"id":"22595500000011234"}]}]}'

response = requests.put(url, headers=headers, data=payload)

print(response.json())

#include <stdio.h>
#include <string.h>
#include <curl/curl.h>

int main(void) {
    CURL *curl = curl_easy_init();
    if (curl) {
        struct curl_slist *headers = NULL;
        headers = curl_slist_append(headers, "Authorization: Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa");
        headers = curl_slist_append(headers, "Content-Type: application/json");

        curl_easy_setopt(curl, CURLOPT_URL, "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/[TEAMFOLDER_ID]");
        curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);
        curl_easy_setopt(curl, CURLOPT_CUSTOMREQUEST, "PUT");
        curl_easy_setopt(curl, CURLOPT_POSTFIELDS, "{\"user_permissions\":[{\"add\":[{\"workdrive_role\":\"admin\",\"users\":[{\"zpuid\":\"4000000002055\"}],\"profiles\":[{\"id\":\"22595500000011234\"}]}],\"remove\":[{\"workdrive_role\":\"admin\",\"users\":[{\"zpuid\":\"4000000002055\"}],\"profiles\":[{\"id\":\"22595500000011234\"}]}],\"workdrive_role\":\"admin\",\"users\":[{\"zpuid\":\"4000000002055\"}],\"profiles\":[{\"id\":\"22595500000011234\"}]}]}");

        CURLcode res = curl_easy_perform(curl);
        if (res != CURLE_OK)
            fprintf(stderr, "curl failed: %s\n", curl_easy_strerror(res));

        curl_slist_free_all(headers);
        curl_easy_cleanup(curl);
    }
    return 0;
}

using System.Net.Http;
using System.Text;
using System.Web;

var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa");

var request = new HttpRequestMessage(HttpMethod.Put, "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/[TEAMFOLDER_ID]");
request.Content = new StringContent(
    @"{""user_permissions"":[{""add"":[{""workdrive_role"":""admin"",""users"":[{""zpuid"":""4000000002055""}],""profiles"":[{""id"":""22595500000011234""}]}],""remove"":[{""workdrive_role"":""admin"",""users"":[{""zpuid"":""4000000002055""}],""profiles"":[{""id"":""22595500000011234""}]}],""workdrive_role"":""admin"",""users"":[{""zpuid"":""4000000002055""}],""profiles"":[{""id"":""22595500000011234""}]}]}",
    Encoding.UTF8,
    "application/json"
);

var response = await client.SendAsync(request);
var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);

#include <iostream>
#include <string>
#include <curl/curl.h>

static size_t WriteCallback(void* contents, size_t size, size_t nmemb, std::string* output) {
    output->append((char*)contents, size * nmemb);
    return size * nmemb;
}

int main() {
    CURL* curl = curl_easy_init();
    if (curl) {
        std::string response;
        struct curl_slist* headers = NULL;
        headers = curl_slist_append(headers, "Authorization: Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa");
        headers = curl_slist_append(headers, "Content-Type: application/json");

        curl_easy_setopt(curl, CURLOPT_URL, "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/[TEAMFOLDER_ID]");
        curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);
        curl_easy_setopt(curl, CURLOPT_CUSTOMREQUEST, "PUT");
        curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, WriteCallback);
        curl_easy_setopt(curl, CURLOPT_WRITEDATA, &response);
        curl_easy_setopt(curl, CURLOPT_POSTFIELDS, "{\"user_permissions\":[{\"add\":[{\"workdrive_role\":\"admin\",\"users\":[{\"zpuid\":\"4000000002055\"}],\"profiles\":[{\"id\":\"22595500000011234\"}]}],\"remove\":[{\"workdrive_role\":\"admin\",\"users\":[{\"zpuid\":\"4000000002055\"}],\"profiles\":[{\"id\":\"22595500000011234\"}]}],\"workdrive_role\":\"admin\",\"users\":[{\"zpuid\":\"4000000002055\"}],\"profiles\":[{\"id\":\"22595500000011234\"}]}]}");

        CURLcode res = curl_easy_perform(curl);
        if (res == CURLE_OK)
            std::cout << response << std::endl;
        else
            std::cerr << curl_easy_strerror(res) << std::endl;

        curl_slist_free_all(headers);
        curl_easy_cleanup(curl);
    }
    return 0;
}

(require '[clj-http.client :as client])

(def response
  (client/put "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/[TEAMFOLDER_ID]"
    {:headers {"Authorization" "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa"
                "Content-Type" "application/json"}
     :body "{\"user_permissions\":[{\"add\":[{\"workdrive_role\":\"admin\",\"users\":[{\"zpuid\":\"4000000002055\"}],\"profiles\":[{\"id\":\"22595500000011234\"}]}],\"remove\":[{\"workdrive_role\":\"admin\",\"users\":[{\"zpuid\":\"4000000002055\"}],\"profiles\":[{\"id\":\"22595500000011234\"}]}],\"workdrive_role\":\"admin\",\"users\":[{\"zpuid\":\"4000000002055\"}],\"profiles\":[{\"id\":\"22595500000011234\"}]}]}"
     :as :json}))

(println (:body response))

package main

import (
    "fmt"
    "io"
    "net/http"
    "strings"
)

func main() {
    payload := strings.NewReader("{\"user_permissions\":[{\"add\":[{\"workdrive_role\":\"admin\",\"users\":[{\"zpuid\":\"4000000002055\"}],\"profiles\":[{\"id\":\"22595500000011234\"}]}],\"remove\":[{\"workdrive_role\":\"admin\",\"users\":[{\"zpuid\":\"4000000002055\"}],\"profiles\":[{\"id\":\"22595500000011234\"}]}],\"workdrive_role\":\"admin\",\"users\":[{\"zpuid\":\"4000000002055\"}],\"profiles\":[{\"id\":\"22595500000011234\"}]}]}")
    req, _ := http.NewRequest("PUT", "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/[TEAMFOLDER_ID]", payload)
    req.Header.Add("Authorization", "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa")
    req.Header.Add("Content-Type", "application/json")

    resp, _ := http.DefaultClient.Do(req)
    defer resp.Body.Close()
    body, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body))
}

PUT https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/[TEAMFOLDER_ID] HTTP/1.1
Host: https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/[TEAMFOLDER_ID]
Authorization: Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa
Content-Type: application/json

{"user_permissions":[{"add":[{"workdrive_role":"admin","users":[{"zpuid":"4000000002055"}],"profiles":[{"id":"22595500000011234"}]}],"remove":[{"workdrive_role":"admin","users":[{"zpuid":"4000000002055"}],"profiles":[{"id":"22595500000011234"}]}],"workdrive_role":"admin","users":[{"zpuid":"4000000002055"}],"profiles":[{"id":"22595500000011234"}]}]}

HttpClientBuilder httpClientBuilder = HttpClientBuilder.create();

SSLContext sslContext = SSLContext.getDefault();
SSLConnectionSocketFactory sslConnectionSocketFactory = new SSLConnectionSocketFactory(sslContext, NoopHostnameVerifier.INSTANCE);
CloseableHttpClient httpclient = httpClientBuilder.setSSLSocketFactory(sslConnectionSocketFactory).build();

URIBuilder uriBuilder = new URIBuilder("https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/[TEAMFOLDER_ID]");
HttpUriRequest requestObj = new HttpPut(uriBuilder.build());
requestObj.addHeader("Authorization", "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa");

HttpEntityEnclosingRequestBase requestBase = (HttpEntityEnclosingRequestBase) requestObj;
String requestBody = "{\"user_permissions\":[{\"add\":[{\"workdrive_role\":\"admin\",\"users\":[{\"zpuid\":\"4000000002055\"}],\"profiles\":[{\"id\":\"22595500000011234\"}]}],\"remove\":[{\"workdrive_role\":\"admin\",\"users\":[{\"zpuid\":\"4000000002055\"}],\"profiles\":[{\"id\":\"22595500000011234\"}]}],\"workdrive_role\":\"admin\",\"users\":[{\"zpuid\":\"4000000002055\"}],\"profiles\":[{\"id\":\"22595500000011234\"}]}]}";
requestBase.setEntity(new StringEntity(requestBody, HTTP.UTF_8));

HttpResponse response = httpclient.execute(requestObj);

HttpEntity responseEntity = response.getEntity();
Object responseObject = EntityUtils.toString(responseEntity);
String responseString = responseObject.toString();

const url = 'https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/[TEAMFOLDER_ID]';

const options = {
  method: 'PUT',
  headers: {
    'Authorization': 'Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({"user_permissions":[{"add":[{"workdrive_role":"admin","users":[{"zpuid":"4000000002055"}],"profiles":[{"id":"22595500000011234"}]}],"remove":[{"workdrive_role":"admin","users":[{"zpuid":"4000000002055"}],"profiles":[{"id":"22595500000011234"}]}],"workdrive_role":"admin","users":[{"zpuid":"4000000002055"}],"profiles":[{"id":"22595500000011234"}]}]})
};

fetch(url, options)
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error(error));

{"user_permissions":[{"add":[{"workdrive_role":"admin","users":[{"zpuid":"4000000002055"}],"profiles":[{"id":"22595500000011234"}]}],"remove":[{"workdrive_role":"admin","users":[{"zpuid":"4000000002055"}],"profiles":[{"id":"22595500000011234"}]}],"workdrive_role":"admin","users":[{"zpuid":"4000000002055"}],"profiles":[{"id":"22595500000011234"}]}]}
import java.net.HttpURLConnection
import java.net.URL
import okhttp3.HttpUrl.Companion.toHttpUrl

fun main() {
    val url = URL("https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/[TEAMFOLDER_ID]")
    val conn = url.openConnection() as HttpURLConnection
    conn.requestMethod = "PUT"
    conn.setRequestProperty("Authorization", "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa")
    conn.setRequestProperty("Content-Type", "application/json")
    conn.doOutput = true
    conn.outputStream.bufferedWriter().use { it.write("""{"user_permissions":[{"add":[{"workdrive_role":"admin","users":[{"zpuid":"4000000002055"}],"profiles":[{"id":"22595500000011234"}]}],"remove":[{"workdrive_role":"admin","users":[{"zpuid":"4000000002055"}],"profiles":[{"id":"22595500000011234"}]}],"workdrive_role":"admin","users":[{"zpuid":"4000000002055"}],"profiles":[{"id":"22595500000011234"}]}]}""") }

    val response = conn.inputStream.bufferedReader().readText()
    println(response)
}

NSURL *url = [NSURL URLWithString:@"https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/[TEAMFOLDER_ID]"];
NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:url];
[request setHTTPMethod:@"PUT"];
[request setValue:@"Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa" forHTTPHeaderField:@"Authorization"];
[request setValue:@"application/json" forHTTPHeaderField:@"Content-Type"];
NSData *body = [@"{\"user_permissions\":[{\"add\":[{\"workdrive_role\":\"admin\",\"users\":[{\"zpuid\":\"4000000002055\"}],\"profiles\":[{\"id\":\"22595500000011234\"}]}],\"remove\":[{\"workdrive_role\":\"admin\",\"users\":[{\"zpuid\":\"4000000002055\"}],\"profiles\":[{\"id\":\"22595500000011234\"}]}],\"workdrive_role\":\"admin\",\"users\":[{\"zpuid\":\"4000000002055\"}],\"profiles\":[{\"id\":\"22595500000011234\"}]}]}" dataUsingEncoding:NSUTF8StringEncoding];
[request setHTTPBody:body];

NSURLSession *session = [NSURLSession sharedSession];
NSURLSessionDataTask *task = [session dataTaskWithRequest:request
    completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) {
        NSString *result = [[NSString alloc] initWithData:data encoding:NSUTF8StringEncoding];
        NSLog(@"%@", result);
}];
[task resume];

open Lwt
open Cohttp_lwt_unix

let () =
  let uri = Uri.of_string "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/[TEAMFOLDER_ID]" in
  let headers = Cohttp.Header.init ()
    |> fun h -> Cohttp.Header.add h "Authorization" "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa"
    |> fun h -> Cohttp.Header.add h "Content-Type" "application/json"
  in
  let body = Cohttp_lwt.Body.of_string {json|{"user_permissions":[{"add":[{"workdrive_role":"admin","users":[{"zpuid":"4000000002055"}],"profiles":[{"id":"22595500000011234"}]}],"remove":[{"workdrive_role":"admin","users":[{"zpuid":"4000000002055"}],"profiles":[{"id":"22595500000011234"}]}],"workdrive_role":"admin","users":[{"zpuid":"4000000002055"}],"profiles":[{"id":"22595500000011234"}]}]}|json} in
  Lwt_main.run (
    Client.put ~headers ~body uri >>= fun (_, body) ->
    Cohttp_lwt.Body.to_string body >|= fun s ->
    print_endline s)

$headers = @{
    "Authorization" = "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa"
    "Content-Type" = "application/json"
}

$body = @'
{"user_permissions":[{"add":[{"workdrive_role":"admin","users":[{"zpuid":"4000000002055"}],"profiles":[{"id":"22595500000011234"}]}],"remove":[{"workdrive_role":"admin","users":[{"zpuid":"4000000002055"}],"profiles":[{"id":"22595500000011234"}]}],"workdrive_role":"admin","users":[{"zpuid":"4000000002055"}],"profiles":[{"id":"22595500000011234"}]}]}
'@

$response = Invoke-RestMethod -Uri "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/[TEAMFOLDER_ID]" -Method PUT -Headers $headers -Body $body

$response | ConvertTo-Json

library(httr)

url <- "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/[TEAMFOLDER_ID]"

response <- PUT(
  url,
  add_headers(Authorization = "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa"),
  content_type_json(),
  body = "{\"user_permissions\":[{\"add\":[{\"workdrive_role\":\"admin\",\"users\":[{\"zpuid\":\"4000000002055\"}],\"profiles\":[{\"id\":\"22595500000011234\"}]}],\"remove\":[{\"workdrive_role\":\"admin\",\"users\":[{\"zpuid\":\"4000000002055\"}],\"profiles\":[{\"id\":\"22595500000011234\"}]}],\"workdrive_role\":\"admin\",\"users\":[{\"zpuid\":\"4000000002055\"}],\"profiles\":[{\"id\":\"22595500000011234\"}]}]}"
)

content(response, "text")

import Foundation

let url = URL(string: "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/[TEAMFOLDER_ID]")!
var request = URLRequest(url: url)
request.httpMethod = "PUT"
request.setValue("Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa", forHTTPHeaderField: "Authorization")
request.setValue("application/json", forHTTPHeaderField: "Content-Type")
request.httpBody = """
{"user_permissions":[{"add":[{"workdrive_role":"admin","users":[{"zpuid":"4000000002055"}],"profiles":[{"id":"22595500000011234"}]}],"remove":[{"workdrive_role":"admin","users":[{"zpuid":"4000000002055"}],"profiles":[{"id":"22595500000011234"}]}],"workdrive_role":"admin","users":[{"zpuid":"4000000002055"}],"profiles":[{"id":"22595500000011234"}]}]}
""".data(using: .utf8)

let semaphore = DispatchSemaphore(value: 0)
let task = URLSession.shared.dataTask(with: request) { data, response, error in
    if let data = data, let result = String(data: data, encoding: .utf8) {
        print(result)
    }
    semaphore.signal()
}
task.resume()
semaphore.wait()

Sample Input

Content-Type: application/json
{ "user_permissions" : [ { "add" : [ { "workdrive_role" : "admin", "users" : [ { "zpuid" : "4000000002055" } ], "profiles" : [ { "id" : "22595500000011234" } ] } ], "remove" : [ { "workdrive_role" : "admin", "users" : [ { "zpuid" : "4000000002055" } ], "profiles" : [ { "id" : "22595500000011234" } ] } ], "workdrive_role" : "admin", "users" : [ { "zpuid" : "4000000002055" } ], "profiles" : [ { "id" : "22595500000011234" } ] } ] }

Sample Response

204 No Content

Possible Errors

Delete a Team Folder

Remove a team folder from a project.

DELETE

/api/v3/portal/[PORTAL_ID]/projects/[PROJECT_ID]/documents/teamfolder/[TEAMFOLDER_ID]

OAuth Scope:

ZohoProjects.documents.DELETE, WorkDrive.workspace.ALL,Workdrive.team.ALL,WorkDrive.files.ALL

Path Parameters

Param Name
Data Type
Description

Request Example

Request Example
  • cURL
  • Deluge
  • Node.js
  • Ruby
  • PHP
  • Python
  • C
  • C#
  • C++
  • Clojure
  • Go
  • HTTP
  • Java
  • JS Fetch
  • Kotlin
  • Objective-C
  • OCaml
  • PowerShell
  • R
  • Swift

curl -X DELETE \
'https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/[TEAMFOLDER_ID]' \
-H 'Authorization: Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa'

url = "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/[TEAMFOLDER_ID]";
response = invokeUrl
[
    url: url
    type: DELETE
    connection: "projects"
];
info response;

const https = require('https');
const url = new URL('https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/[TEAMFOLDER_ID]');

const options = {
  hostname: url.hostname,
  path: url.pathname + url.search,
  method: 'DELETE',
  headers: {
    'Authorization': 'Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa'
  }
};

const req = https.request(options, (res) => {
  let data = '';
  res.on('data', (chunk) => { data += chunk; });
  res.on('end', () => { console.log(JSON.parse(data)); });
});

req.on('error', (err) => { console.error(err); });
req.end();

require 'net/http'
require 'uri'
require 'json'

url = URI("https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/[TEAMFOLDER_ID]")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Delete.new(url)
request["Authorization"] = "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa"

response = http.request(request)
puts response.read_body

<?php
$url = "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/[TEAMFOLDER_ID]";

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => $url,
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "DELETE",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa"
  ],
]);

$response = curl_exec($curl);
curl_close($curl);

echo $response;

import requests

url = "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/[TEAMFOLDER_ID]"

headers = {
    "Authorization": "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa",
}

response = requests.delete(url, headers=headers)

print(response.json())

#include <stdio.h>
#include <string.h>
#include <curl/curl.h>

int main(void) {
    CURL *curl = curl_easy_init();
    if (curl) {
        struct curl_slist *headers = NULL;
        headers = curl_slist_append(headers, "Authorization: Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa");

        curl_easy_setopt(curl, CURLOPT_URL, "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/[TEAMFOLDER_ID]");
        curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);
        curl_easy_setopt(curl, CURLOPT_CUSTOMREQUEST, "DELETE");

        CURLcode res = curl_easy_perform(curl);
        if (res != CURLE_OK)
            fprintf(stderr, "curl failed: %s\n", curl_easy_strerror(res));

        curl_slist_free_all(headers);
        curl_easy_cleanup(curl);
    }
    return 0;
}

using System.Net.Http;
using System.Text;
using System.Web;

var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa");

var request = new HttpRequestMessage(HttpMethod.Delete, "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/[TEAMFOLDER_ID]");

var response = await client.SendAsync(request);
var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);

#include <iostream>
#include <string>
#include <curl/curl.h>

static size_t WriteCallback(void* contents, size_t size, size_t nmemb, std::string* output) {
    output->append((char*)contents, size * nmemb);
    return size * nmemb;
}

int main() {
    CURL* curl = curl_easy_init();
    if (curl) {
        std::string response;
        struct curl_slist* headers = NULL;
        headers = curl_slist_append(headers, "Authorization: Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa");

        curl_easy_setopt(curl, CURLOPT_URL, "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/[TEAMFOLDER_ID]");
        curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);
        curl_easy_setopt(curl, CURLOPT_CUSTOMREQUEST, "DELETE");
        curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, WriteCallback);
        curl_easy_setopt(curl, CURLOPT_WRITEDATA, &response);

        CURLcode res = curl_easy_perform(curl);
        if (res == CURLE_OK)
            std::cout << response << std::endl;
        else
            std::cerr << curl_easy_strerror(res) << std::endl;

        curl_slist_free_all(headers);
        curl_easy_cleanup(curl);
    }
    return 0;
}

(require '[clj-http.client :as client])

(def response
  (client/delete "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/[TEAMFOLDER_ID]"
    {:headers {"Authorization" "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa"}
     :as :json}))

(println (:body response))

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    req, _ := http.NewRequest("DELETE", "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/[TEAMFOLDER_ID]", nil)
    req.Header.Add("Authorization", "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa")

    resp, _ := http.DefaultClient.Do(req)
    defer resp.Body.Close()
    body, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body))
}

DELETE https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/[TEAMFOLDER_ID] HTTP/1.1
Host: https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/[TEAMFOLDER_ID]
Authorization: Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa

HttpClientBuilder httpClientBuilder = HttpClientBuilder.create();

SSLContext sslContext = SSLContext.getDefault();
SSLConnectionSocketFactory sslConnectionSocketFactory = new SSLConnectionSocketFactory(sslContext, NoopHostnameVerifier.INSTANCE);
CloseableHttpClient httpclient = httpClientBuilder.setSSLSocketFactory(sslConnectionSocketFactory).build();

URIBuilder uriBuilder = new URIBuilder("https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/[TEAMFOLDER_ID]");
HttpUriRequest requestObj = new HttpDelete(uriBuilder.build());
requestObj.addHeader("Authorization", "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa");

HttpResponse response = httpclient.execute(requestObj);

HttpEntity responseEntity = response.getEntity();
Object responseObject = EntityUtils.toString(responseEntity);
String responseString = responseObject.toString();

const url = 'https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/[TEAMFOLDER_ID]';

const options = {
  method: 'DELETE',
  headers: {
    'Authorization': 'Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa'
  }
};

fetch(url, options)
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error(error));

import java.net.HttpURLConnection
import java.net.URL
import okhttp3.HttpUrl.Companion.toHttpUrl

fun main() {
    val url = URL("https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/[TEAMFOLDER_ID]")
    val conn = url.openConnection() as HttpURLConnection
    conn.requestMethod = "DELETE"
    conn.setRequestProperty("Authorization", "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa")

    val response = conn.inputStream.bufferedReader().readText()
    println(response)
}

NSURL *url = [NSURL URLWithString:@"https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/[TEAMFOLDER_ID]"];
NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:url];
[request setHTTPMethod:@"DELETE"];
[request setValue:@"Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa" forHTTPHeaderField:@"Authorization"];

NSURLSession *session = [NSURLSession sharedSession];
NSURLSessionDataTask *task = [session dataTaskWithRequest:request
    completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) {
        NSString *result = [[NSString alloc] initWithData:data encoding:NSUTF8StringEncoding];
        NSLog(@"%@", result);
}];
[task resume];

open Lwt
open Cohttp_lwt_unix

let () =
  let uri = Uri.of_string "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/[TEAMFOLDER_ID]" in
  let headers = Cohttp.Header.init ()
    |> fun h -> Cohttp.Header.add h "Authorization" "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa"
  in
  Lwt_main.run (
    Client.delete ~headers uri >>= fun (_, body) ->
    Cohttp_lwt.Body.to_string body >|= fun s ->
    print_endline s)

$headers = @{
    "Authorization" = "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa"
}

$response = Invoke-RestMethod -Uri "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/[TEAMFOLDER_ID]" -Method DELETE -Headers $headers

$response | ConvertTo-Json

library(httr)

url <- "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/[TEAMFOLDER_ID]"

response <- DELETE(
  url,
  add_headers(Authorization = "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa")
)

content(response, "text")

import Foundation

let url = URL(string: "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/[TEAMFOLDER_ID]")!
var request = URLRequest(url: url)
request.httpMethod = "DELETE"
request.setValue("Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa", forHTTPHeaderField: "Authorization")

let semaphore = DispatchSemaphore(value: 0)
let task = URLSession.shared.dataTask(with: request) { data, response, error in
    if let data = data, let result = String(data: data, encoding: .utf8) {
        print(result)
    }
    semaphore.signal()
}
task.resume()
semaphore.wait()

Sample Response

204 No Content{ "status" : "success" }

Possible Errors

Associate Team Folder(s) to the Project

Associate an existing team folder to a project.

PUT

/api/v3/portal/[PORTAL_ID]/projects/[PROJECT_ID]/documents/teamfolder/associate

OAuth Scope:

ZohoProjects.documents.UPDATE, WorkDrive.workspace.ALL,Workdrive.team.ALL,WorkDrive.files.ALL

Path Parameters

Param Name
Data Type
Description

Body Parameters

Param Name
Data Type
Description

Request Example

Request Example
  • cURL
  • Deluge
  • Node.js
  • Ruby
  • PHP
  • Python
  • C
  • C#
  • C++
  • Clojure
  • Go
  • HTTP
  • Java
  • JS Fetch
  • JSON
  • Kotlin
  • Objective-C
  • OCaml
  • PowerShell
  • R
  • Swift

curl -X PUT \
'https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/associate' \
-H 'Authorization: Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa' \
-H 'Content-Type: application/json' \
-d '{"workdrive_team_folder_ids":["we9i836cbd87259dd451cb7c382802145f029"],"user_permissions":[{"workdrive_role":"admin","users":[{"zpuid":"225955000000159234"}],"profiles":[{"id":"22595500000011234"}]}]}'

url = "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/associate";
params = Map();
params.put("workdrive_team_folder_ids", ["we9i836cbd87259dd451cb7c382802145f029"]);
params.put("user_permissions", [{"workdrive_role":"admin","users":[{"zpuid":"225955000000159234"}],"profiles":[{"id":"22595500000011234"}]}]);
response = invokeUrl
[
    url: url
    type: PUT
    parameters: params.toString()
    connection: "projects"
];
info response;

const https = require('https');
const url = new URL('https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/associate');

const payload = JSON.stringify({"workdrive_team_folder_ids":["we9i836cbd87259dd451cb7c382802145f029"],"user_permissions":[{"workdrive_role":"admin","users":[{"zpuid":"225955000000159234"}],"profiles":[{"id":"22595500000011234"}]}]});

const options = {
  hostname: url.hostname,
  path: url.pathname + url.search,
  method: 'PUT',
  headers: {
    'Authorization': 'Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa',
    'Content-Type': 'application/json',
    'Content-Length': Buffer.byteLength(payload)
  }
};

const req = https.request(options, (res) => {
  let data = '';
  res.on('data', (chunk) => { data += chunk; });
  res.on('end', () => { console.log(JSON.parse(data)); });
});

req.on('error', (err) => { console.error(err); });
req.write(payload);
req.end();

require 'net/http'
require 'uri'
require 'json'

url = URI("https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/associate")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["Authorization"] = "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa"
request["Content-Type"] = "application/json"
request.body = '{"workdrive_team_folder_ids":["we9i836cbd87259dd451cb7c382802145f029"],"user_permissions":[{"workdrive_role":"admin","users":[{"zpuid":"225955000000159234"}],"profiles":[{"id":"22595500000011234"}]}]}'

response = http.request(request)
puts response.read_body

<?php
$url = "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/associate";

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => $url,
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => '{"workdrive_team_folder_ids":["we9i836cbd87259dd451cb7c382802145f029"],"user_permissions":[{"workdrive_role":"admin","users":[{"zpuid":"225955000000159234"}],"profiles":[{"id":"22595500000011234"}]}]}',
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
curl_close($curl);

echo $response;

import requests

url = "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/associate"

headers = {
    "Authorization": "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa",
    "Content-Type": "application/json",
}

payload = '{"workdrive_team_folder_ids":["we9i836cbd87259dd451cb7c382802145f029"],"user_permissions":[{"workdrive_role":"admin","users":[{"zpuid":"225955000000159234"}],"profiles":[{"id":"22595500000011234"}]}]}'

response = requests.put(url, headers=headers, data=payload)

print(response.json())

#include <stdio.h>
#include <string.h>
#include <curl/curl.h>

int main(void) {
    CURL *curl = curl_easy_init();
    if (curl) {
        struct curl_slist *headers = NULL;
        headers = curl_slist_append(headers, "Authorization: Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa");
        headers = curl_slist_append(headers, "Content-Type: application/json");

        curl_easy_setopt(curl, CURLOPT_URL, "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/associate");
        curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);
        curl_easy_setopt(curl, CURLOPT_CUSTOMREQUEST, "PUT");
        curl_easy_setopt(curl, CURLOPT_POSTFIELDS, "{\"workdrive_team_folder_ids\":[\"we9i836cbd87259dd451cb7c382802145f029\"],\"user_permissions\":[{\"workdrive_role\":\"admin\",\"users\":[{\"zpuid\":\"225955000000159234\"}],\"profiles\":[{\"id\":\"22595500000011234\"}]}]}");

        CURLcode res = curl_easy_perform(curl);
        if (res != CURLE_OK)
            fprintf(stderr, "curl failed: %s\n", curl_easy_strerror(res));

        curl_slist_free_all(headers);
        curl_easy_cleanup(curl);
    }
    return 0;
}

using System.Net.Http;
using System.Text;
using System.Web;

var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa");

var request = new HttpRequestMessage(HttpMethod.Put, "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/associate");
request.Content = new StringContent(
    @"{""workdrive_team_folder_ids"":[""we9i836cbd87259dd451cb7c382802145f029""],""user_permissions"":[{""workdrive_role"":""admin"",""users"":[{""zpuid"":""225955000000159234""}],""profiles"":[{""id"":""22595500000011234""}]}]}",
    Encoding.UTF8,
    "application/json"
);

var response = await client.SendAsync(request);
var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);

#include <iostream>
#include <string>
#include <curl/curl.h>

static size_t WriteCallback(void* contents, size_t size, size_t nmemb, std::string* output) {
    output->append((char*)contents, size * nmemb);
    return size * nmemb;
}

int main() {
    CURL* curl = curl_easy_init();
    if (curl) {
        std::string response;
        struct curl_slist* headers = NULL;
        headers = curl_slist_append(headers, "Authorization: Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa");
        headers = curl_slist_append(headers, "Content-Type: application/json");

        curl_easy_setopt(curl, CURLOPT_URL, "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/associate");
        curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);
        curl_easy_setopt(curl, CURLOPT_CUSTOMREQUEST, "PUT");
        curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, WriteCallback);
        curl_easy_setopt(curl, CURLOPT_WRITEDATA, &response);
        curl_easy_setopt(curl, CURLOPT_POSTFIELDS, "{\"workdrive_team_folder_ids\":[\"we9i836cbd87259dd451cb7c382802145f029\"],\"user_permissions\":[{\"workdrive_role\":\"admin\",\"users\":[{\"zpuid\":\"225955000000159234\"}],\"profiles\":[{\"id\":\"22595500000011234\"}]}]}");

        CURLcode res = curl_easy_perform(curl);
        if (res == CURLE_OK)
            std::cout << response << std::endl;
        else
            std::cerr << curl_easy_strerror(res) << std::endl;

        curl_slist_free_all(headers);
        curl_easy_cleanup(curl);
    }
    return 0;
}

(require '[clj-http.client :as client])

(def response
  (client/put "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/associate"
    {:headers {"Authorization" "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa"
                "Content-Type" "application/json"}
     :body "{\"workdrive_team_folder_ids\":[\"we9i836cbd87259dd451cb7c382802145f029\"],\"user_permissions\":[{\"workdrive_role\":\"admin\",\"users\":[{\"zpuid\":\"225955000000159234\"}],\"profiles\":[{\"id\":\"22595500000011234\"}]}]}"
     :as :json}))

(println (:body response))

package main

import (
    "fmt"
    "io"
    "net/http"
    "strings"
)

func main() {
    payload := strings.NewReader("{\"workdrive_team_folder_ids\":[\"we9i836cbd87259dd451cb7c382802145f029\"],\"user_permissions\":[{\"workdrive_role\":\"admin\",\"users\":[{\"zpuid\":\"225955000000159234\"}],\"profiles\":[{\"id\":\"22595500000011234\"}]}]}")
    req, _ := http.NewRequest("PUT", "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/associate", payload)
    req.Header.Add("Authorization", "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa")
    req.Header.Add("Content-Type", "application/json")

    resp, _ := http.DefaultClient.Do(req)
    defer resp.Body.Close()
    body, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body))
}

PUT https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/associate HTTP/1.1
Host: https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/associate
Authorization: Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa
Content-Type: application/json

{"workdrive_team_folder_ids":["we9i836cbd87259dd451cb7c382802145f029"],"user_permissions":[{"workdrive_role":"admin","users":[{"zpuid":"225955000000159234"}],"profiles":[{"id":"22595500000011234"}]}]}

HttpClientBuilder httpClientBuilder = HttpClientBuilder.create();

SSLContext sslContext = SSLContext.getDefault();
SSLConnectionSocketFactory sslConnectionSocketFactory = new SSLConnectionSocketFactory(sslContext, NoopHostnameVerifier.INSTANCE);
CloseableHttpClient httpclient = httpClientBuilder.setSSLSocketFactory(sslConnectionSocketFactory).build();

URIBuilder uriBuilder = new URIBuilder("https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/associate");
HttpUriRequest requestObj = new HttpPut(uriBuilder.build());
requestObj.addHeader("Authorization", "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa");

HttpEntityEnclosingRequestBase requestBase = (HttpEntityEnclosingRequestBase) requestObj;
String requestBody = "{\"workdrive_team_folder_ids\":[\"we9i836cbd87259dd451cb7c382802145f029\"],\"user_permissions\":[{\"workdrive_role\":\"admin\",\"users\":[{\"zpuid\":\"225955000000159234\"}],\"profiles\":[{\"id\":\"22595500000011234\"}]}]}";
requestBase.setEntity(new StringEntity(requestBody, HTTP.UTF_8));

HttpResponse response = httpclient.execute(requestObj);

HttpEntity responseEntity = response.getEntity();
Object responseObject = EntityUtils.toString(responseEntity);
String responseString = responseObject.toString();

const url = 'https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/associate';

const options = {
  method: 'PUT',
  headers: {
    'Authorization': 'Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({"workdrive_team_folder_ids":["we9i836cbd87259dd451cb7c382802145f029"],"user_permissions":[{"workdrive_role":"admin","users":[{"zpuid":"225955000000159234"}],"profiles":[{"id":"22595500000011234"}]}]})
};

fetch(url, options)
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error(error));

{"workdrive_team_folder_ids":["we9i836cbd87259dd451cb7c382802145f029"],"user_permissions":[{"workdrive_role":"admin","users":[{"zpuid":"225955000000159234"}],"profiles":[{"id":"22595500000011234"}]}]}
import java.net.HttpURLConnection
import java.net.URL
import okhttp3.HttpUrl.Companion.toHttpUrl

fun main() {
    val url = URL("https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/associate")
    val conn = url.openConnection() as HttpURLConnection
    conn.requestMethod = "PUT"
    conn.setRequestProperty("Authorization", "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa")
    conn.setRequestProperty("Content-Type", "application/json")
    conn.doOutput = true
    conn.outputStream.bufferedWriter().use { it.write("""{"workdrive_team_folder_ids":["we9i836cbd87259dd451cb7c382802145f029"],"user_permissions":[{"workdrive_role":"admin","users":[{"zpuid":"225955000000159234"}],"profiles":[{"id":"22595500000011234"}]}]}""") }

    val response = conn.inputStream.bufferedReader().readText()
    println(response)
}

NSURL *url = [NSURL URLWithString:@"https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/associate"];
NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:url];
[request setHTTPMethod:@"PUT"];
[request setValue:@"Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa" forHTTPHeaderField:@"Authorization"];
[request setValue:@"application/json" forHTTPHeaderField:@"Content-Type"];
NSData *body = [@"{\"workdrive_team_folder_ids\":[\"we9i836cbd87259dd451cb7c382802145f029\"],\"user_permissions\":[{\"workdrive_role\":\"admin\",\"users\":[{\"zpuid\":\"225955000000159234\"}],\"profiles\":[{\"id\":\"22595500000011234\"}]}]}" dataUsingEncoding:NSUTF8StringEncoding];
[request setHTTPBody:body];

NSURLSession *session = [NSURLSession sharedSession];
NSURLSessionDataTask *task = [session dataTaskWithRequest:request
    completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) {
        NSString *result = [[NSString alloc] initWithData:data encoding:NSUTF8StringEncoding];
        NSLog(@"%@", result);
}];
[task resume];

open Lwt
open Cohttp_lwt_unix

let () =
  let uri = Uri.of_string "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/associate" in
  let headers = Cohttp.Header.init ()
    |> fun h -> Cohttp.Header.add h "Authorization" "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa"
    |> fun h -> Cohttp.Header.add h "Content-Type" "application/json"
  in
  let body = Cohttp_lwt.Body.of_string {json|{"workdrive_team_folder_ids":["we9i836cbd87259dd451cb7c382802145f029"],"user_permissions":[{"workdrive_role":"admin","users":[{"zpuid":"225955000000159234"}],"profiles":[{"id":"22595500000011234"}]}]}|json} in
  Lwt_main.run (
    Client.put ~headers ~body uri >>= fun (_, body) ->
    Cohttp_lwt.Body.to_string body >|= fun s ->
    print_endline s)

$headers = @{
    "Authorization" = "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa"
    "Content-Type" = "application/json"
}

$body = @'
{"workdrive_team_folder_ids":["we9i836cbd87259dd451cb7c382802145f029"],"user_permissions":[{"workdrive_role":"admin","users":[{"zpuid":"225955000000159234"}],"profiles":[{"id":"22595500000011234"}]}]}
'@

$response = Invoke-RestMethod -Uri "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/associate" -Method PUT -Headers $headers -Body $body

$response | ConvertTo-Json

library(httr)

url <- "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/associate"

response <- PUT(
  url,
  add_headers(Authorization = "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa"),
  content_type_json(),
  body = "{\"workdrive_team_folder_ids\":[\"we9i836cbd87259dd451cb7c382802145f029\"],\"user_permissions\":[{\"workdrive_role\":\"admin\",\"users\":[{\"zpuid\":\"225955000000159234\"}],\"profiles\":[{\"id\":\"22595500000011234\"}]}]}"
)

content(response, "text")

import Foundation

let url = URL(string: "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/associate")!
var request = URLRequest(url: url)
request.httpMethod = "PUT"
request.setValue("Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa", forHTTPHeaderField: "Authorization")
request.setValue("application/json", forHTTPHeaderField: "Content-Type")
request.httpBody = """
{"workdrive_team_folder_ids":["we9i836cbd87259dd451cb7c382802145f029"],"user_permissions":[{"workdrive_role":"admin","users":[{"zpuid":"225955000000159234"}],"profiles":[{"id":"22595500000011234"}]}]}
""".data(using: .utf8)

let semaphore = DispatchSemaphore(value: 0)
let task = URLSession.shared.dataTask(with: request) { data, response, error in
    if let data = data, let result = String(data: data, encoding: .utf8) {
        print(result)
    }
    semaphore.signal()
}
task.resume()
semaphore.wait()

Sample Input

Content-Type: application/json
{ "workdrive_team_folder_ids" : [ "we9i836cbd87259dd451cb7c382802145f029" ], "user_permissions" : [ { "workdrive_role" : "admin", "users" : [ { "zpuid" : "225955000000159234" } ], "profiles" : [ { "id" : "22595500000011234" } ] } ] }

Sample Response

200{ "team_folders" : [ { "workdrive_folder_id" : "we9i836cbd87259dd451cb7c382802145f029", "is_personal_space" : false, "name" : "Team Folder 3", "folder_id" : "9000000005939" } ] }

Possible Errors

Disassociate Team Folder

Disassociate team folder(s) from a project.

DELETE

/api/v3/portal/[PORTAL_ID]/projects/[PROJECT_ID]/documents/teamfolder/[TEAMFOLDER_ID]/disassociate

OAuth Scope:

ZohoProjects.documents.DELETE, WorkDrive.workspace.ALL,Workdrive.team.ALL,WorkDrive.files.ALL

Path Parameters

Param Name
Data Type
Description

Request Example

Request Example
  • cURL
  • Deluge
  • Node.js
  • Ruby
  • PHP
  • Python
  • C
  • C#
  • C++
  • Clojure
  • Go
  • HTTP
  • Java
  • JS Fetch
  • Kotlin
  • Objective-C
  • OCaml
  • PowerShell
  • R
  • Swift

curl -X DELETE \
'https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/[TEAMFOLDER_ID]/disassociate' \
-H 'Authorization: Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa'

url = "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/[TEAMFOLDER_ID]/disassociate";
response = invokeUrl
[
    url: url
    type: DELETE
    connection: "projects"
];
info response;

const https = require('https');
const url = new URL('https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/[TEAMFOLDER_ID]/disassociate');

const options = {
  hostname: url.hostname,
  path: url.pathname + url.search,
  method: 'DELETE',
  headers: {
    'Authorization': 'Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa'
  }
};

const req = https.request(options, (res) => {
  let data = '';
  res.on('data', (chunk) => { data += chunk; });
  res.on('end', () => { console.log(JSON.parse(data)); });
});

req.on('error', (err) => { console.error(err); });
req.end();

require 'net/http'
require 'uri'
require 'json'

url = URI("https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/[TEAMFOLDER_ID]/disassociate")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Delete.new(url)
request["Authorization"] = "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa"

response = http.request(request)
puts response.read_body

<?php
$url = "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/[TEAMFOLDER_ID]/disassociate";

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => $url,
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "DELETE",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa"
  ],
]);

$response = curl_exec($curl);
curl_close($curl);

echo $response;

import requests

url = "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/[TEAMFOLDER_ID]/disassociate"

headers = {
    "Authorization": "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa",
}

response = requests.delete(url, headers=headers)

print(response.json())

#include <stdio.h>
#include <string.h>
#include <curl/curl.h>

int main(void) {
    CURL *curl = curl_easy_init();
    if (curl) {
        struct curl_slist *headers = NULL;
        headers = curl_slist_append(headers, "Authorization: Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa");

        curl_easy_setopt(curl, CURLOPT_URL, "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/[TEAMFOLDER_ID]/disassociate");
        curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);
        curl_easy_setopt(curl, CURLOPT_CUSTOMREQUEST, "DELETE");

        CURLcode res = curl_easy_perform(curl);
        if (res != CURLE_OK)
            fprintf(stderr, "curl failed: %s\n", curl_easy_strerror(res));

        curl_slist_free_all(headers);
        curl_easy_cleanup(curl);
    }
    return 0;
}

using System.Net.Http;
using System.Text;
using System.Web;

var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa");

var request = new HttpRequestMessage(HttpMethod.Delete, "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/[TEAMFOLDER_ID]/disassociate");

var response = await client.SendAsync(request);
var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);

#include <iostream>
#include <string>
#include <curl/curl.h>

static size_t WriteCallback(void* contents, size_t size, size_t nmemb, std::string* output) {
    output->append((char*)contents, size * nmemb);
    return size * nmemb;
}

int main() {
    CURL* curl = curl_easy_init();
    if (curl) {
        std::string response;
        struct curl_slist* headers = NULL;
        headers = curl_slist_append(headers, "Authorization: Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa");

        curl_easy_setopt(curl, CURLOPT_URL, "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/[TEAMFOLDER_ID]/disassociate");
        curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);
        curl_easy_setopt(curl, CURLOPT_CUSTOMREQUEST, "DELETE");
        curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, WriteCallback);
        curl_easy_setopt(curl, CURLOPT_WRITEDATA, &response);

        CURLcode res = curl_easy_perform(curl);
        if (res == CURLE_OK)
            std::cout << response << std::endl;
        else
            std::cerr << curl_easy_strerror(res) << std::endl;

        curl_slist_free_all(headers);
        curl_easy_cleanup(curl);
    }
    return 0;
}

(require '[clj-http.client :as client])

(def response
  (client/delete "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/[TEAMFOLDER_ID]/disassociate"
    {:headers {"Authorization" "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa"}
     :as :json}))

(println (:body response))

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    req, _ := http.NewRequest("DELETE", "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/[TEAMFOLDER_ID]/disassociate", nil)
    req.Header.Add("Authorization", "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa")

    resp, _ := http.DefaultClient.Do(req)
    defer resp.Body.Close()
    body, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body))
}

DELETE https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/[TEAMFOLDER_ID]/disassociate HTTP/1.1
Host: https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/[TEAMFOLDER_ID]/disassociate
Authorization: Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa

HttpClientBuilder httpClientBuilder = HttpClientBuilder.create();

SSLContext sslContext = SSLContext.getDefault();
SSLConnectionSocketFactory sslConnectionSocketFactory = new SSLConnectionSocketFactory(sslContext, NoopHostnameVerifier.INSTANCE);
CloseableHttpClient httpclient = httpClientBuilder.setSSLSocketFactory(sslConnectionSocketFactory).build();

URIBuilder uriBuilder = new URIBuilder("https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/[TEAMFOLDER_ID]/disassociate");
HttpUriRequest requestObj = new HttpDelete(uriBuilder.build());
requestObj.addHeader("Authorization", "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa");

HttpResponse response = httpclient.execute(requestObj);

HttpEntity responseEntity = response.getEntity();
Object responseObject = EntityUtils.toString(responseEntity);
String responseString = responseObject.toString();

const url = 'https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/[TEAMFOLDER_ID]/disassociate';

const options = {
  method: 'DELETE',
  headers: {
    'Authorization': 'Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa'
  }
};

fetch(url, options)
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error(error));

import java.net.HttpURLConnection
import java.net.URL
import okhttp3.HttpUrl.Companion.toHttpUrl

fun main() {
    val url = URL("https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/[TEAMFOLDER_ID]/disassociate")
    val conn = url.openConnection() as HttpURLConnection
    conn.requestMethod = "DELETE"
    conn.setRequestProperty("Authorization", "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa")

    val response = conn.inputStream.bufferedReader().readText()
    println(response)
}

NSURL *url = [NSURL URLWithString:@"https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/[TEAMFOLDER_ID]/disassociate"];
NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:url];
[request setHTTPMethod:@"DELETE"];
[request setValue:@"Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa" forHTTPHeaderField:@"Authorization"];

NSURLSession *session = [NSURLSession sharedSession];
NSURLSessionDataTask *task = [session dataTaskWithRequest:request
    completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) {
        NSString *result = [[NSString alloc] initWithData:data encoding:NSUTF8StringEncoding];
        NSLog(@"%@", result);
}];
[task resume];

open Lwt
open Cohttp_lwt_unix

let () =
  let uri = Uri.of_string "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/[TEAMFOLDER_ID]/disassociate" in
  let headers = Cohttp.Header.init ()
    |> fun h -> Cohttp.Header.add h "Authorization" "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa"
  in
  Lwt_main.run (
    Client.delete ~headers uri >>= fun (_, body) ->
    Cohttp_lwt.Body.to_string body >|= fun s ->
    print_endline s)

$headers = @{
    "Authorization" = "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa"
}

$response = Invoke-RestMethod -Uri "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/[TEAMFOLDER_ID]/disassociate" -Method DELETE -Headers $headers

$response | ConvertTo-Json

library(httr)

url <- "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/[TEAMFOLDER_ID]/disassociate"

response <- DELETE(
  url,
  add_headers(Authorization = "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa")
)

content(response, "text")

import Foundation

let url = URL(string: "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/projects/23806000097545166/documents/teamfolder/[TEAMFOLDER_ID]/disassociate")!
var request = URLRequest(url: url)
request.httpMethod = "DELETE"
request.setValue("Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa", forHTTPHeaderField: "Authorization")

let semaphore = DispatchSemaphore(value: 0)
let task = URLSession.shared.dataTask(with: request) { data, response, error in
    if let data = data, let result = String(data: data, encoding: .utf8) {
        print(result)
    }
    semaphore.signal()
}
task.resume()
semaphore.wait()

Sample Response

204 No Content{ "status" : "success" }

Possible Errors

AI Tools
ChatGPT Open in ChatGPT ↗ Open in ChatGPT to ask questions about this page
Claude Open in Claude ↗ Open in Claude to ask questions about this page
Copy as Markdown Copy this page as markdown to use with AI assistants
View as Markdown ↗ Open this page as markdown in a new tab
Copy OpenAPI Spec Copy the OpenAPI YAML to the clipboard
View as YAML ↗ Open the OpenAPI spec in a new tab
Download YAML Save the OpenAPI spec as a .yaml file