Uploads a file to a custom field for a specified computer resource

This API allows clients to upload a file into a designated custom field within a computer resource

Endpoints

put /dcapi/customFields/values/file

Copy full URL

Request URL

https://{serverurl}/dcapi/customFields/values/file

Scope

DesktopCentralCloud.CustomField.CREATECopied!

Header

Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52

Request Parameters

- Request Headers

AcceptstringMandatory

application/uploadCustomFieldFile.v1+jsonCopied!

- Query Parameters

selectedResourcesstringOptional

The resource can be one of the following, depending on the view in which the custom field is created:
RESOURCE_ID — if the custom field is created in the Computer view
SOFTWARE_ID — if the custom field is created in the Software view

columnNamestringOptional

Column name where the uploaded file will be mapped.

tableNamestringOptional

The table name can be any of the names provided in the list below
1.ManagedComputerCustomFields-if customfield created in computer view
2.InvSWCustomFields-if customfield created in software view.

- Request Body

multipart/form-data

JSON Object

Hide Sub-Attributes

uploadedFilestringOptional

The file to be uploaded to the custom field. Supported formats: archives, data files, images, presentation files, scripts, spreadsheets, and documents

selectedResourcesstringOptional

Identifier of the resource to which the file will be attached

columnNamestringOptional

The custom field column where the file should be uploaded

tableNamestringOptional

Target table in which the custom field data will be stored

Sample Request

Curl

Java

Python

Deluge

PowerShell

Copied!

curl --request PUT \
  --url https://appdomains/dcapi/customFields/values/file \
  --header 'Accept: application/uploadCustomFieldFile.v1+json' \
  --header 'Authorization: Zoho-oauthtoken  d92d4xxxxxxxxxxxxx15f52' \
  --header 'content-type: multipart/form-data'

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.io.IOException;
import java.net.http.HttpTimeoutException;

public class Main {
  public static void main(String[] args) {

    HttpRequest request = HttpRequest.newBuilder()
        .uri(URI.create("https://appdomains/dcapi/customFields/values/file"))
        .header("content-type", "multipart/form-data")
        .header("Accept", "application/uploadCustomFieldFile.v1+json")
        .header("Authorization", "Zoho-oauthtoken  d92d4xxxxxxxxxxxxx15f52")
        .method("PUT", HttpRequest.BodyPublishers.noBody())
        .build();
    HttpResponse response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
    System.out.println(response.body());
  
  }
}

import http.client

conn = http.client.HTTPSConnection("appdomains")

headers = {
    'content-type': "multipart/form-data",
    'Accept': "application/uploadCustomFieldFile.v1+json",
    'Authorization': "Zoho-oauthtoken  d92d4xxxxxxxxxxxxx15f52"
    }

conn.request("PUT", "/dcapi/customFields/values/file", headers=headers)

res = conn.getresponse()
data = res.read()

print(data.decode("utf-8"))


    headersMap = Map();
    headersMap.put("Accept", "application/uploadCustomFieldFile.v1+json");

    list_of_text=List();

    response = invokeUrl
    [
        url: "https://appDomains/dcapi/customFields/values/file"
        type: PUT
        headers: headersMap
        files: list_of_text
        connection: connection_name
    ]

    info response;

$headers=@{}
$headers.Add("content-type", "multipart/form-data")
$headers.Add("Accept", "application/uploadCustomFieldFile.v1+json")
$headers.Add("Authorization", "Zoho-oauthtoken  d92d4xxxxxxxxxxxxx15f52")
$response = Invoke-WebRequest -Uri 'https://appdomains/dcapi/customFields/values/file' -Method PUT -Headers $headers

Sample Request Body

Copied!

// Note: payload contains multiple type attributes

// type: string
uploadedFile = File to be uploaded

// type: string
selectedResources = 301

// type: string
columnName = COL301

// type: string
tableName = ManagedComputerCustomFields

▼ Show full

Possible Response Codes

204HTTP code

Sample Response: HTTP 204

Copied!

204 No Content

▼ Show full

Duration: 1 minute | Threshold: 30 | Lock period: 5 minutes

Duration - Time window for the threshold.
Threshold - Number of API calls allowed within the specified duration.
Lock Period - Wait time before consecutive API requests.