Создание комментария по кандидату

Создать комментарий по кандидату в системе можно с помощью следующего запроса

graphql

mutation CreatePersonComment {
  createPersonComment(
    commentCreate: {commentVisibility: {visibleForAll: true}, personId: 2938600, text: "Комментарий по кандидату"}
  ) {
    __typename
    ... on Comment {
      id
    }
    ... on PersonCommentCreateError {
      errorType
      errors {
        field
        violatedConstraints
      }
    }
  }
}

cURL

curl https://api.talantix.ru/graphql \
 -X POST \
-H "Content-Type: application/json" \
-H "User-Agent: api-doc-agent" \
-H "Authorization: Bearer <your access token>" \
-d "{\"query\":\"mutation CreatePersonComment {\\n  createPersonComment(\\n    commentCreate: {commentVisibility: {visibleForAll: true}, personId: 2938600, text: \\\"Комментарий по кандидату\\\"}\\n  ) {\\n    __typename\\n    ... on Comment {\\n      id\\n    }\\n    ... on PersonCommentCreateError {\\n      errorType\\n      errors {\\n        field\\n        violatedConstraints\\n      }\\n    }\\n  }\\n}\"}"

Посмотреть в playground

примечание

Поле commentVisibility.visibleForAll определяет видимость комментария для пользователей системы: для true комментарий будет доступен всем пользователям, имеющим доступ к кандидату, при false только пользователям, указанным в поле commentVisibility.visibleForManagerIds, и создателю комментария

подсказка

Для создания комментария в рамках вакансии необходимо передать аргумент vacancyId

подсказка

Текст комментария поддерживает как простой текстовый формат, так и HTML

При успешном выполнении запрос вернет запрашиваемые в мутации поля созданного комментария

{
  "data": {
    "createPersonComment": {
      "__typename": "Comment",
      "id": 12345
    }
  }
}

В случае возникновения ошибки вернется json с ее описанием

{
  "data": {
    "createPersonComment": {
      "__typename": "PersonCommentCreateError",
      "errorType": "INVALID_COMMENT",
      "errors": [
        {
          "field": "text",
          "violatedConstraints": ["Size"]
        }
      ]
    }
  }
}