Folder MetaData [UPDATE] Method (PATCH)

Folder Media [UPDATE] method is used to add/edit folder metadata.

Additional Request Parameters.

  • folder_id: unique identifier of the target folder (in the request headline);
  • Mandatory metadata entries and values in "entry":"value" format (in the request body).

Request Examples.

Example of running the Folder MetaData [UPDATE] method in Postman:

Examples of PATCH request syntax using Folder MetaData [UPDATE] method with following parameters:

  • Folder ID “4dfa27bb-1b89-46ab-b488-faf87046471b”;
  • Adding metadata:
    • Entry "test1", value "appended_value_5";
    • Entry "test2", value "modified_value_2";
    • Entry "test3", value "01238823";
    • Entry "test4", value "123124241";

HTTP

Bash

Python

php

Java


PATCH /api/folders/4dfa27bb-1b89-46ab-b488-faf87046471b/meta_data/ HTTP/1.1
Host: youradress.ru
X-Forensic-Access-Token: 0ccbdb4627c9d07c6c5b8f6e6cca44b5f8cb0c54ad7659098fa336240d494b0f9035e14bc42fc461224a9719f105e41026fed0f6f14188d9107b8c3d697a0cb1
Content-Type: application/json
User-Agent: PostmanRuntime/7.15.2
Accept: */*
Cache-Control: no-cache
Postman-Token: 3822d50c-d853-429d-b520-420457a0da20,960e1cf6-5545-4080-afc2-377accccc32c
Host: youradress.ru
Accept-Encoding: gzip, deflate
Content-Length: 111
Connection: keep-alive
cache-control: no-cache

{
  "test1": "appended_value_5",
  "test2": "modified_value_2",
  "test3": "01238823",
  "test4": "123124241"
}


curl -X PATCH \
  https://youradress.ru/api/folders/4dfa27bb-1b89-46ab-b488-faf87046471b/meta_data/ \
  -H 'Accept: */*' \
  -H 'Accept-Encoding: gzip, deflate' \
  -H 'Cache-Control: no-cache' \
  -H 'Connection: keep-alive' \
  -H 'Content-Length: 111' \
  -H 'Content-Type: application/json' \
  -H 'Host: youradress.ru' \
  -H 'Postman-Token: 3822d50c-d853-429d-b520-420457a0da20,6e035a57-5cd6-4065-a686-fba5e4a9f8ae' \
  -H 'User-Agent: PostmanRuntime/7.15.2' \
  -H 'X-Forensic-Access-Token: 0ccbdb4627c9d07c6c5b8f6e6cca44b5f8cb0c54ad7659098fa336240d494b0f9035e14bc42fc461224a9719f105e41026fed0f6f14188d9107b8c3d697a0cb1' \
  -H 'cache-control: no-cache' \
  -d '{
  "test1": "appended_value_5",
  "test2": "modified_value_2",
  "test3": "01238823",
  "test4": "123124241"
}'


import requests

url = "https://youradress.ru/api/folders/4dfa27bb-1b89-46ab-b488-faf87046471b/meta_data/"

payload = "{\n  \"test1\": \"appended_value_5\",\n  \"test2\": \"modified_value_2\",\n  \"test3\": \"01238823\",\n  \"test4\": \"123124241\"\n}"
headers = {
    'X-Forensic-Access-Token': "0ccbdb4627c9d07c6c5b8f6e6cca44b5f8cb0c54ad7659098fa336240d494b0f9035e14bc42fc461224a9719f105e41026fed0f6f14188d9107b8c3d697a0cb1",
    'Content-Type': "application/json",
    'User-Agent': "PostmanRuntime/7.15.2",
    'Accept': "*/*",
    'Cache-Control': "no-cache",
    'Postman-Token': "3822d50c-d853-429d-b520-420457a0da20,4450f17a-6981-415a-b73c-3cc5c6558a1a",
    'Host': "youradress.ru",
    'Accept-Encoding': "gzip, deflate",
    'Content-Length': "111",
    'Connection': "keep-alive",
    'cache-control': "no-cache"
    }

response = requests.request("PATCH", url, data=payload, headers=headers)

print(response.text)


setUrl('https://youradress.ru/api/folders/4dfa27bb-1b89-46ab-b488-faf87046471b/meta_data/');
$request->setMethod(HttpRequest::HTTP_METH_PATCH);

$request->setHeaders(array(
  'cache-control' => 'no-cache',
  'Connection' => 'keep-alive',
  'Content-Length' => '111',
  'Accept-Encoding' => 'gzip, deflate',
  'Host' => 'youradress.ru',
  'Postman-Token' => '3822d50c-d853-429d-b520-420457a0da20,165bd42c-6a40-4b9a-aeb2-8c7163cad2ff',
  'Cache-Control' => 'no-cache',
  'Accept' => '*/*',
  'User-Agent' => 'PostmanRuntime/7.15.2',
  'Content-Type' => 'application/json',
  'X-Forensic-Access-Token' => '0ccbdb4627c9d07c6c5b8f6e6cca44b5f8cb0c54ad7659098fa336240d494b0f9035e14bc42fc461224a9719f105e41026fed0f6f14188d9107b8c3d697a0cb1'
));

$request->setBody('{
  "test1": "appended_value_5",
  "test2": "modified_value_2",
  "test3": "01238823",
  "test4": "123124241"
}');

try {
  $response = $request->send();

  echo $response->getBody();
} catch (HttpException $ex) {
  echo $ex;
}


OkHttpClient client = new OkHttpClient();

MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\n  \"test1\": \"appended_value_5\",\n  \"test2\": \"modified_value_2\",\n  \"test3\": \"01238823\",\n  \"test4\": \"123124241\"\n}");
Request request = new Request.Builder()
  .url("https://youradress.ru/api/folders/4dfa27bb-1b89-46ab-b488-faf87046471b/meta_data/")
  .patch(body)
  .addHeader("X-Forensic-Access-Token", "0ccbdb4627c9d07c6c5b8f6e6cca44b5f8cb0c54ad7659098fa336240d494b0f9035e14bc42fc461224a9719f105e41026fed0f6f14188d9107b8c3d697a0cb1")
  .addHeader("Content-Type", "application/json")
  .addHeader("User-Agent", "PostmanRuntime/7.15.2")
  .addHeader("Accept", "*/*")
  .addHeader("Cache-Control", "no-cache")
  .addHeader("Postman-Token", "3822d50c-d853-429d-b520-420457a0da20,a8e83d1e-2aa5-4599-8d58-e88457efb10a")
  .addHeader("Host", "youradress.ru")
  .addHeader("Accept-Encoding", "gzip, deflate")
  .addHeader("Content-Length", "111")
  .addHeader("Connection", "keep-alive")
  .addHeader("cache-control", "no-cache")
  .build();

Response response = client.newCall(request).execute();

Example of JSON Response.

Example of the system's JSON response to calling Folder MetaData [UPDATE] method with similar settings:

JSON


{
    "iin": "test11234567",
    "test1": "appended_value_5",
    "test2": "modified_value_2",
    "test3": "01238823",
    "test4": "123124241"
}

Details of JSON Response.

Response after a successful accomplishment of the method contains all current metadata entries for the folder in "entry":"value” format.