Block access to tasks

  1. Request
  2. Headers
  3. Request body
  4. Response

Blocks a user from accessing tasks.

Request

PUT https://toloka.yandex.com/api/v1/user-restrictions
Authorization: OAuth <OAuth token>
Content-Type: application/JSON

Headers

Title Overview
authorization A token for account authorization. Add OAuth as a prefix.
content-type Specifies the data format in the request body.
Title Overview
authorization A token for account authorization. Add OAuth as a prefix.
content-type Specifies the data format in the request body.

Request body

{
  "scope": "PROJECT",
  "user_id": "f25a5f41-94e8-49bf-977f-3611087a16b3",
  "project_id": "10",
  "private_comment": "Many mistakes",
  "will_expire": "2016-04-10T18:08:07"
}
Copied to clipboard

Parameter

Overview

scope

string | required

The scope of the ban:

  • ALL_PROJECTS — All the requester's projects.

  • PROJECT — A single project (specify the project_id).

  • POOL — A pool (specify the pool_id).

user_id

string | required

User ID.

project_id

string | required if

Required if scope=PROJECT.

The ID of the project that is blocked.

pool_id

string | required if

Required if scope=POOL.

The ID of the pool that is blocked.

private_comment

string

Comments with the reason for blocking access.

Maximum length: 499 characters.

will_expire

string

The UTC date and time when access will be restored. It uses ISO 8601 format: YYYY-MM-DDThh:mm:ss[.sss].

Parameter

Overview

scope

string | required

The scope of the ban:

  • ALL_PROJECTS — All the requester's projects.

  • PROJECT — A single project (specify the project_id).

  • POOL — A pool (specify the pool_id).

user_id

string | required

User ID.

project_id

string | required if

Required if scope=PROJECT.

The ID of the project that is blocked.

pool_id

string | required if

Required if scope=POOL.

The ID of the pool that is blocked.

private_comment

string

Comments with the reason for blocking access.

Maximum length: 499 characters.

will_expire

string

The UTC date and time when access will be restored. It uses ISO 8601 format: YYYY-MM-DDThh:mm:ss[.sss].

Response

Contains the ban ID and parameters, and the date when access was blocked.

{
  "scope": "PROJECT",
  "user_id": "f25a5f41-94e8-49bf-977f-3611087a16b3",
  "project_id": "10",
  "private_comment": "Many mistakes",
  "will_expire": "2016-04-10T18:08:07",
  "id": "54",
  "created": "2016-03-28T18:08:07"
}

Parameter

Overview

scope

string

The scope of the ban:

  • ALL_PROJECTS — All the requester's projects.

  • PROJECT — A single project (specify the project_id).

  • POOL — A pool (specify the pool_id).

user_id

string

User ID.

project_id

string

Specified if scope=PROJECT.

The ID of the project that is blocked.

pool_id

string

Specified if scope=POOL.

The ID of the pool that is blocked.

private_comment

string

Comments with the reason for blocking access.

Maximum length: 499 characters.

will_expire

string

The UTC date and time when access will be restored. It uses ISO 8601 format: YYYY-MM-DDThh:mm:ss[.sss].

created

string

The UTC date and time of the ban, in ISO 8601 format: YYYY-MM-DDThh:mm:ss[.sss].

id

string

ID of the ban.

Parameter

Overview

scope

string

The scope of the ban:

  • ALL_PROJECTS — All the requester's projects.

  • PROJECT — A single project (specify the project_id).

  • POOL — A pool (specify the pool_id).

user_id

string

User ID.

project_id

string

Specified if scope=PROJECT.

The ID of the project that is blocked.

pool_id

string

Specified if scope=POOL.

The ID of the pool that is blocked.

private_comment

string

Comments with the reason for blocking access.

Maximum length: 499 characters.

will_expire

string

The UTC date and time when access will be restored. It uses ISO 8601 format: YYYY-MM-DDThh:mm:ss[.sss].

created

string

The UTC date and time of the ban, in ISO 8601 format: YYYY-MM-DDThh:mm:ss[.sss].

id

string

ID of the ban.