Create a skill
Creates a skill.
Request
POST https://toloka.yandex.com/api/v1/skills
Authorization: OAuth <OAuth token>
Content-Type: application/JSON
POST https://sandbox.toloka.yandex.com/api/v1/skills
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
{ "name": "Determining the color of an elephant", "private_comment": "Skill for my pool", "hidden": true, "skill_ttl_hours": 240 }
Copied to clipboard
Parameter | Overview |
---|---|
name | string | mandatory Skill name. |
private_comment | string Comments on the skill (only visible to the requester). |
skill_ttl_hours | integer The skill's "time to live" after the last update (in hours). The skill is removed from the Toloker's profile if the skill level hasn't been updated for the specified length of time. |
Parameter | Overview |
---|---|
name | string | mandatory Skill name. |
private_comment | string Comments on the skill (only visible to the requester). |
skill_ttl_hours | integer The skill's "time to live" after the last update (in hours). The skill is removed from the Toloker's profile if the skill level hasn't been updated for the specified length of time. |
Response
Skill properties and ID.
{
"id": "9238",
"name": "Determining the color of an elephant",
"private_comment": "Skill for my pool",
"hidden": true,
"skill_ttl_hours": 240,
"deprecated": false,
"owner": {
"id": "c3a50f44cd3e1b8202465569ced289eb",
"myself": true
},
"created": "2021-12-01T08:37:03.387",
"global": false
}
Parameter | Overview |
---|---|
id | string Skill ID. |
name | string Skill name. |
private_comment | string Comments on the skill (only visible to the requester). |
hidden | boolean Access to information about the skill (the name and value) for Tolokers:
The default value is |
skill_ttl_hours | integer The skill's "time to live" after the last update (in hours). The skill is removed from the Toloker's profile if the skill level hasn't been updated for the specified length of time. |
deprecated | boolean Terminating skill support by its creator:
|
owner | object Parameters of the requester that created the project |
owner.id | string Requester ID. |
owner.myself | boolean Checks who the object belongs to:
|
training | boolean Whether the skill is related to a training pool:
|
created | string The UTC date and time when the skill was created, in ISO 8601 format: YYYY-MM-DDThh:mm:ss[.sss]. |
global | boolean An indicator of a global skill:
|
Parameter | Overview |
---|---|
id | string Skill ID. |
name | string Skill name. |
private_comment | string Comments on the skill (only visible to the requester). |
hidden | boolean Access to information about the skill (the name and value) for Tolokers:
The default value is |
skill_ttl_hours | integer The skill's "time to live" after the last update (in hours). The skill is removed from the Toloker's profile if the skill level hasn't been updated for the specified length of time. |
deprecated | boolean Terminating skill support by its creator:
|
owner | object Parameters of the requester that created the project |
owner.id | string Requester ID. |
owner.myself | boolean Checks who the object belongs to:
|
training | boolean Whether the skill is related to a training pool:
|
created | string The UTC date and time when the skill was created, in ISO 8601 format: YYYY-MM-DDThh:mm:ss[.sss]. |
global | boolean An indicator of a global skill:
|