Set the skill value

Attention

The toloka.yandex.com domain will be disabled starting April 1, 2023. Please use the toloka.dev domain for API requests.

Sets the skill value.

Restriction

You can send a maximum of 100,000 requests of this kind per day. Refer to the Rate limiting section for the complete list of the request limitations in Toloka API.

Request

Production version
Sandbox
PUT https://toloka.dev/api/v1/user-skills
Authorization: OAuth <OAuth token>
Content-Type: application/JSON

Headers

TitleOverview
AuthorizationA token for account authorization. Add OAuth as a prefix.
Content-TypeSpecifies the data format in the request body.

Request body

{
"skill_id": 32,
"user_id": "566ec2b0ff0deeaae5f9d500",
"value": 59.7,
"reason": "High-quality performance of tasks"
}
ParameterOverview
skill_idstring | required

Skill ID.
user_idstring | required

Toloker ID.
valuefloat | required

Fractional value of the skill. Minimum — 0, maximum — 100.
Reasonstring

The reason for changing or assigning a skill.

Response

Updated skill value.

{
"id": "43",
"skill_id": "32",
"user_id": "566ec2b0ff0deeaae5f9d500",
"value": 60,
"exact_value": 59.7,
"created": "2021-06-17T09:30:11.681",
"modified": "2021-05-19T10:52:22.130"
}
ParameterOverview
idstring

ID of the Toloker's skill, assigned to the "skill-user" pair.
skill_idstring

Skill ID.
user_idstring

Toloker ID.
valueinteger

The integer value of that skill (exact_value, rounded to the nearest integer). Minimum — 0, maximum — 100.
exact_valuefloat

Fractional value of the skill. Minimum — 0, maximum — 100.
createdstring

The date and time in UTC when the Toloker was first assigned the skill with the specified value. It uses ISO 8601 format: YYYY-MM-DDThh:mm:ss[.sss].
modifiedstring

The date and time in UTC when the Toloker's skill level changed. It uses ISO 8601 format: YYYY-MM-DDThh:mm:ss[.sss].

See also

Contact support
Toloka API
OverviewAccessing the APIRate limiting
Quick start
Reference
Project
Pools
Training
Subscriptions to events
Toloker selection
Ways to upload tasks
Tasks
Task suites
Tracking operations
Getting responses
Checking completed tasks
Rewards
Messages for Tolokers
Various parameters
Libraries