tasks.task.access.get
Проверить права доступа v 3.0
Описание
Метод относится к REST 3.0. Особенности вызова и формат ответа новой версии API описаны в обзоре REST 3.0.
Метод tasks.task.access.get проверяет доступные действия пользователя над задачей.
Параметры
id
integer
обязательный
Идентификатор задачи.
Идентификатор задачи можно получить при создании новой задачи или старым методом получения списка задач
Примеры запроса
curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"id":8017}' \
https://**put_your_bitrix24_address**/rest/api/**put_your_user_id_here**/**put_your_webhook_here**/tasks.task.access.get
curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"id":8017,"auth":"**put_access_token_here**"}' \
https://**put_your_bitrix24_address**/rest/api/tasks.task.access.get
// This snippet is an ES module: top-level await requires type="module" or a bundler.
// $b24 is an already-initialized SDK instance (see the SDK "Get started" guide).
import { Text } from '@bitrix24/b24jssdk'
import type { B24Frame } from '@bitrix24/b24jssdk'
declare const $b24: B24Frame
// Shape of the payload returned in result (match the "response handling" section of the page)
type TaskAccessResult = {
read: boolean
watch: boolean
mute: boolean
createSubtask: boolean
createResult: boolean
edit: boolean
remove: boolean
complete: boolean
approve: boolean
disapprove: boolean
start: boolean
take: boolean
delegate: boolean
defer: boolean
renew: boolean
deadline: boolean
datePlan: boolean
changeDirector: boolean
changeResponsible: boolean
changeAccomplices: boolean
pause: boolean
timeTracking: boolean
mark: boolean
changeStatus: boolean
reminder: boolean
addAuditors: boolean
elapsedTime: boolean
favorite: boolean
checklistAdd: boolean
checklistEdit: boolean
checklistSave: boolean
checklistToggle: boolean
automate: boolean
resultEdit: boolean
completeResult: boolean
removeResult: boolean
resultRead: boolean
admin: boolean
copy: boolean
saveAsTemplate: boolean
attachFile: boolean
detachFile: boolean
detachParent: boolean
createGanttDependence: boolean
sort: boolean
}
try {
const response = await $b24.actions.v3.call.make<TaskAccessResult>({
method: 'tasks.task.access.get',
params: {
id: 8017,
},
requestId: Text.getUuidRfc4122()
})
// The payload is available only on a successful response
if (!response.isSuccess) {
console.error(response.getErrorMessages().join('; '))
} else {
const result = response.getData()!.result
console.info('Task access rights — edit:', result.edit, 'complete:', result.complete, 'remove:', result.remove)
}
} catch (error) {
// Thrown on transport or SDK failures (AjaxError, SdkError, etc.)
console.error(error)
}
<!-- Load the SDK (UMD build); it is exposed as the global B24Js -->
<script src="https://unpkg.com/@bitrix24/b24jssdk@1/dist/umd/index.min.js"></script>
<script>
async function getTaskAccess() {
try {
// Initialize the SDK inside a Bitrix24 frame
const $b24 = await B24Js.initializeB24Frame()
const response = await $b24.actions.v3.call.make({
method: 'tasks.task.access.get',
params: {
id: 8017,
},
requestId: B24Js.Text.getUuidRfc4122()
})
// The payload is available only on a successful response
if (!response.isSuccess) {
console.error(response.getErrorMessages().join('; '))
return
}
const result = response.getData().result
console.info('Task access rights — edit:', result.edit, 'complete:', result.complete, 'remove:', result.remove)
} catch (error) {
// Thrown on transport or SDK failures (AjaxError, SdkError, etc.)
console.error(error)
}
}
document.addEventListener('DOMContentLoaded', getTaskAccess)
</script>
from b24pysdk.errors import BitrixAPIError, BitrixSDKException
try:
bitrix_response = client.tasks.task.access.get(
bitrix_id=8017,
).response
result = bitrix_response.result
print(result)
except BitrixAPIError as error:
print(
"Ошибка Bitrix API",
f"error: {error.error}",
f"error_description: {error.error_description}",
sep="\n",
)
except BitrixSDKException as error:
print(f"Ошибка Bitrix SDK: {error.message}")
except Exception as error:
print(f"Непредвиденная ошибка: {error}")
try {
$response = $b24Service
->core
->call(
'tasks.task.access.get',
[
'id' => 8017,
]
);
$result = $response
->getResponseData()
->getResult();
echo 'Success: ' . print_r($result, true);
} catch (Throwable $e) {
error_log($e->getMessage());
echo 'Error: ' . $e->getMessage();
}
BX24.callMethod(
'tasks.task.access.get',
{
id: 8017,
},
function(result){
console.info(result.data());
console.log(result);
}
);
require_once('crest.php');
$result = CRest::call(
'tasks.task.access.get',
[
'id' => 8017,
]
);
echo '<PRE>';
print_r($result);
echo '</PRE>';
// client и ctx уже созданы — см. раздел «SDK для Go»
res, err := client.Core().Call(ctx, "tasks.task.access.get", b24.Params{
"id": 8017,
}, b24.WithIdempotent())
if err != nil {
return fmt.Errorf("tasks.task.access.get: %w", err)
}
var item struct {
Read bool `json:"read"`
Watch bool `json:"watch"`
Mute bool `json:"mute"`
CreateSubtask bool `json:"createSubtask"`
CreateResult bool `json:"createResult"`
Edit bool `json:"edit"`
}
if err := json.Unmarshal(res.Result, &item); err != nil {
return fmt.Errorf("разбор ответа: %w", err)
}
fmt.Println(item.Read, item.Watch)
Ответ
HTTP-статус: 200
{
"result": {
"read": true,
"watch": true,
"mute": true,
"createSubtask": true,
"createResult": true,
"edit": true,
"remove": true,
"complete": true,
"approve": false,
"disapprove": false,
"start": false,
"take": false,
"delegate": true,
"defer": false,
"renew": false,
"deadline": true,
"datePlan": true,
"changeDirector": false,
"changeResponsible": true,
"changeAccomplices": true,
"pause": false,
"timeTracking": false,
"mark": true,
"changeStatus": true,
"reminder": true,
"addAuditors": true,
"elapsedTime": true,
"favorite": true,
"checklistAdd": true,
"checklistEdit": true,
"checklistSave": true,
"checklistToggle": true,
"automate": true,
"resultEdit": false,
"completeResult": true,
"removeResult": false,
"resultRead": false,
"admin": true,
"copy": true,
"saveAsTemplate": true,
"attachFile": true,
"detachFile": true,
"detachParent": true,
"createGanttDependence": true,
"sort": false
},
"time": {
"start": 1764849882,
"finish": 1764849882.731575,
"duration": 0.7315750122070312,
"processing": 0,
"date_start": "2025-12-04T15:04:42+03:00",
"date_finish": "2025-12-04T15:04:42+03:00",
"operating_reset_at": 1764850482,
"operating": 0
}
}
Возвращаемые данные
result
object
Корневой элемент ответа. Содержит объект c описанием доступных действий для текущего пользователя
time
time
Информация о времени выполнения запроса
Обработка ошибок
HTTP-статус: 400
{
"error": {
"code": "BITRIX_REST_V3_EXCEPTION_VALIDATION_REQUESTVALIDATIONEXCEPTION",
"message": "Ошибка при валидации объекта запроса",
"validation": [
{
"message": "Обязательное поле `id` не указано",
"field": "id"
}
]
}
}
| Код | Описание | Значение |
|---|---|---|
Поле |
Описание ошибки | Как исправить |
id |
Обязательное поле id не указано |
Добавьте id в тело запроса |
id |
В поле id требуется тип данных int для такого запроса |
Убедитесь, что значение — число, а не строка |

