Редактировать навык

PUT /skills/{id}

Изменяет название, комментарий и уровень доступа к навыку.

В теле запроса укажите все параметры навыка, включая те, которые нужно изменить. Идентификатор навыка можно узнать из списка навыков.

Примеры запросов

curl -X PUT 'https://tasks.yandex.ru/api/v1/skills/11294' \
     -H 'Authorization: OAuth PlaceYourRealOAuthToken_Here' \
     -H 'Content-Type: application/json' \
     -d '{"name":"Programmer","public_name":{"EN":"Programmer"},"public_requester_description":{"EN":"You are an expert in programming languages"},"private_comment":"Got at least 5 right responses on control tasks with C++ or Python","hidden":true,"deprecated":false}'
import requests

url = "https://tasks.yandex.ru/api/v1/skills/11294"
headers = {
  'Authorization': 'OAuth PlaceYourRealOAuthToken_Here',
  'Content-Type': 'application/json'
}
payload = {
  "name": "Programmer",
  "public_name": {
    "EN": "Programmer"
  },
  "public_requester_description": {
    "EN": "You are an expert in programming languages"
  },
  "private_comment": "Got at least 5 right responses on control tasks with C++ or Python",
  "hidden": True,
  "deprecated": False
}
response = requests.put(url, headers=headers, json=payload)

print(response.text)
var request = require('request');
var options = {
  'method': 'PUT',
  'url': 'https://tasks.yandex.ru/api/v1/skills/11294',
  'qs': {},
  'headers': {
    'Authorization': 'OAuth PlaceYourRealOAuthToken_Here',
    'Content-Type': 'application/json'
  },
  'body': JSON.stringify({
    "name": "Programmer",
    "public_name": {
      "EN": "Programmer"
    },
    "public_requester_description": {
      "EN": "You are an expert in programming languages"
    },
    "private_comment": "Got at least 5 right responses on control tasks with C++ or Python",
    "hidden": true,
    "deprecated": false
  })
};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});

Path-параметры

Параметр

Описание

id*

string

Идентификатор навыка.

Заголовки

Заголовок

Описание

Authorization

API-токен для авторизации аккаунта. В качестве префикса добавьте OAuth.

Content-Type

Указывает формат данных (application/json) в передаваемом теле запроса.

Тело и параметры запроса

В теле запроса укажите все параметры навыка, включая обновляемые.

Ответ

Содержит обновленную информацию о навыке.

Пример ответа
{
  "id": "37825",
  "name": "product search relevance",
  "public_name": {
    "EN": "product search relevance"
  },
  "private_comment": "",
  "hidden": true,
  "deprecated": false,
  "owner": {
    "id": "6c6e20dc86cca2ae787afcb2629de162",
    "myself": true
  },
  "created": "2022-01-25T09:19:16.455",
  "global": false
}

Параметр

Описание

id

string

Идентификатор навыка.

name

string

Название навыка.

public_name

object

Имя навыка, которые видят исполнители.

public_requester_description

object

Описание навыка, которые видят исполнители.

private_comment

string

Комментарий к навыку (доступен только заказчику).

hidden

boolean

Доступ к сведениям о навыке (название и значение) для исполнителей:

  • true — закрыт;
  • false — открыт. По умолчанию значение true.

skill_ttl_hours

integer

Время жизни навыка после последнего обновления (в часах). Навык будет удален у исполнителя, если его значение не обновлялось в течение указанного срока.

deprecated

boolean

Прекращение поддержки навыка его создателем:

  • true — поддержка прекращена, навык требует замены;
  • false — поддержка ведется, навык актуальный.

owner

object

Параметры заказчика, который создал навык.

owner.id

string

Идентификатор заказчика.

owner.myself

boolean

Проверяет, кому принадлежит объект:

  • true — заказчику, чей OAuth-токен указан в запросе;
  • false — другому аккаунту (сотруднику или владельцу).

training

boolean

Связь навыка с обучающим пулом:

  • true — навык подсчитывается по заданиям обучающего пула;
  • false — навык не связан с обучающим пулом.

created

string

Дата и время создания навыка по UTC в формате ISO 8601: YYYY-MM-DDThh:mm:ss[.sss].

global

boolean

Признак глобального навыка:

  • true — навык глобальный, показывает общие компетенции исполнителей, доступен всем исполнителям;
  • false — навык создан заказчиком, может быть назначен исполнителям как вручную, так и автоматически: с помощью правил контроля качества или после прохождения обучения.

Обязательный параметр