Create a skill

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

Creates a skill.

Restriction. You can send a maximum of 10 requests of this kind per minute and a maximum of 100 requests per day.

Request

POST https://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 | required

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 users:

  • true — Hidden (access closed).

  • false — Not hidden (access open).

The default value is true.

skill_ttl_hours

integer

The skill's "time to live" after the last update (in hours). The skill is removed from the user's profile if the skill level hasn't been updated for the specified length of time.

Parameter Overview
name

string | required

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 users:

  • true — Hidden (access closed).

  • false — Not hidden (access open).

The default value is true.

skill_ttl_hours

integer

The skill's "time to live" after the last update (in hours). The skill is removed from the user's profile if the skill level hasn't been updated for the specified length of time.

Response

Skill properties and ID.

{
  "id": 1,
  "name": "Determining the color of an elephant",
  "private_comment": "Skill for my pool",
  "hidden": false,
  "skill_ttl_hours": 240,
  "owner": {
    "id": "abcd123456789ef8a4fe10a8980cff",
    "myself": true
  },
  "created": "2021-06-17T09:01:52.541",
}
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 users:

  • true — Hidden (access closed).

  • false — Not hidden (access open).

The default value is true.

skill_ttl_hours

integer

The skill's "time to live" after the last update (in hours). The skill is removed from the user's profile if the skill level hasn't been updated for the specified length of time.

owner

object

Parameters of the requester that created the project

owner.id

string

Requester ID.

owner.myself

boolean

Checks who the object belongs to:

  • true — The user whose OAuth token is specified in the request.
  • false — Another account (employee or owner).
training

boolean

Whether the skill is related to a training pool:

  • true — The skill level is calculated from training pool tasks.

  • false — The skill isn't 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].

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 users:

  • true — Hidden (access closed).

  • false — Not hidden (access open).

The default value is true.

skill_ttl_hours

integer

The skill's "time to live" after the last update (in hours). The skill is removed from the user's profile if the skill level hasn't been updated for the specified length of time.

owner

object

Parameters of the requester that created the project

owner.id

string

Requester ID.

owner.myself

boolean

Checks who the object belongs to:

  • true — The user whose OAuth token is specified in the request.
  • false — Another account (employee or owner).
training

boolean

Whether the skill is related to a training pool:

  • true — The skill level is calculated from training pool tasks.

  • false — The skill isn't 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].