Users

Новый статус сотрудника

Ставит статус другому сотруднику — например, «в отпуске» на время отсутствия. Доступно владельцу пространства и администратору, боту метод недоступен даже с выданным скоупом.

Этим же методом сотруднику включают режим «Нет на месте» флагом is_away и задают текст away_message, который увидят при попытке к нему обратиться.

Статус видят все, кто видит сотрудника в пространстве. Перезаписываются только переданные поля, поэтому продлить чужой статус можно одним expires_at.

Срок, названный словами, — это expires_at, а не часть подписи, и считается он в часовом поясе того сотрудника, которому ставят статус. Эмодзи обязателен и ровно один, подпись обязательна и не длиннее 50 символов.

Свой статус ставят методом [Новый свой статус](PUT /profile/status) — он доступен всем ролям и ботам.

put/users/{user_id}/status

Request

  • Base URL: https://api.pachca.com/api/shared/v1
  • URL: https://api.pachca.com/api/shared/v1/users/{user_id}/status
  • Auth: HTTP bearer

Path parameters

user_idinteger required
Example:12

Идентификатор пользователя

Request body

Example request

{
  "status": {
    "emoji": "🎮",
    "title": "Очень занят",
    "expires_at": "2024-04-08T10:00:00.000Z",
    "is_away": true,
    "away_message": "Вернусь после 15:00"
  }
}

Response

The request has succeeded.

Example response

{
  "data": {
    "emoji": "🎮",
    "title": "Очень занят",
    "expires_at": "2024-04-08T10:00:00.000Z",
    "away_message": {
      "text": "Я в отпуске до 15 апреля. По срочным вопросам обращайтесь к @ivanov."
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.