Grant or update a user's custom section

POST/api/crm/v2/team.update_permission_section_customv2

operationId: team.updatePermissionSectionCustom

Authorization

api-token + language + role

Request body `application/json`

object

user_idintegerrequired

User ID

Example: 1

permission_section_idintegerrequired

Example: 112

readonly_enabledboolean

Updated only if the field is included in the request; therefore, setting the expiration date does not change the access mode. For new grants, defaults to false (full access), but the value becomes true if the section is read-only for the editor.

Example: false

date_expirationoneOfcan be null

Access expiration date for the section in the user's timezone; empty value means no limit. Updated only if the field is included in the request, so changing the mode does not reset it. Expired permissions are deleted automatically.

One of the options

string (DataTimeFormat)

Example: 17:45 06/05/2024

Responses

object

statusstringrequired

Values:successerror

Example: success

dataobject

curl -X POST 'https://foodsoul.ru/api/crm/v2/team.update_permission_section_custom' \
  -H 'Authorization: Bearer fs_api_YOUR_TOKEN' \
  -H 'language: en' \
  -H 'role: partner' \
  -H 'Content-Type: application/json' \
  -d '{"user_id":1,"permission_section_id":112,"readonly_enabled":false,"date_expiration":"17:45 06/05/2024"}'

<?php

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://foodsoul.ru/api/crm/v2/team.update_permission_section_custom', [
    'headers' => [
        'Authorization' => 'Bearer fs_api_YOUR_TOKEN',
        'language' => 'en',
        'role' => 'partner',
    ],
    'json' => [
        'user_id' => 1,
        'permission_section_id' => 112,
        'readonly_enabled' => false,
        'date_expiration' => '17:45 06/05/2024',
    ],
]);

$data = json_decode((string) $response->getBody(), true);

const response = await fetch("https://foodsoul.ru/api/crm/v2/team.update_permission_section_custom", {
    method: "POST",
    headers: {
        "Authorization": "Bearer fs_api_YOUR_TOKEN",
        "language": "en",
        "role": "partner",
        "Content-Type": "application/json"
    },
    body: JSON.stringify({
        "user_id": 1,
        "permission_section_id": 112,
        "readonly_enabled": false,
        "date_expiration": "17:45 06/05/2024"
    }),
})
const data = await response.json()

import requests

response = requests.request(
    "POST",
    "https://foodsoul.ru/api/crm/v2/team.update_permission_section_custom",
    headers={
        "Authorization": "Bearer fs_api_YOUR_TOKEN",
        "language": "en",
        "role": "partner",
    },
    json={
        "user_id": 1,
        "permission_section_id": 112,
        "readonly_enabled": False,
        "date_expiration": "17:45 06/05/2024",
    },
)
data = response.json()

Response 200

{
  "status": "success",
  "data": {}
}

Requests are sent to foodsoul.ru — the host of this portal; you cannot choose another one.

Grant or update a user's custom section

Authorization

Request body application/json

Responses

Request body `application/json`