Справочник API
Статусы
Редактирование статуса

Базовый URL

PUT
https://v1.empr.cloud/api/v1/folders/{folderId}/statuses/{statusId}

Запрос

Заголовки запроса

Заголовки
Название
Тип / Значение
Описание
X-Token
String
Токен авторизации
Content-Type
application/json

Параметры URL

Параметры URL
Название
Тип / Значение
Описание
folderId
UUID
ID папки
statusId
UUID
ID редактируемого статуса

Тело запроса

Тело запроса
Название
Тип / Значение
Описание
name
String
Имя статуса
color
String
HEX-код цвета статуса

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

1const url =
2  "https://v1.empr.cloud/api/v1/folders/{folderId}/statuses/{statusId}"; 
3
4const body = {
5  "name": "New Status",
6  "color": "#000000"
7}
8
9const options = {
10  method: "PUT",
11  headers: {
12    "X-Token": "Your Token", 
13    "Content-Type": "application/json"
14  }, 
15  body: JSON.stringify(body)
16};
17
18fetch(url, options)
19  .then((response) => {
20    response.json().then((data) => {
21      console.log(data);
22    });
23  })
24  .catch((error) => {
25    console.error(error);
26  });

Ответ

Данные ответа

Ответ
Название
Тип / Значение
Описание
data
Status
Обновлённый статус

Пример ответа

1{
2    "data": {
3        "user_id": "***privacy***",
4        "id": "***privacy***",
5        "folder_id": "***privacy***",
6        "status": "New Status",
7        "status_color": "#000000",
8        "created_at": "2023-06-22T17:36:12.605923Z",
9        "updated_at": "2023-06-22T17:36:12.605923Z"
10    }
11}

Типы данных

Status
Название
Тип / Значение
Описание
id
String
ID
user_id
String
ID владельца
status
String
Статус
status_color
String
Шестнадцатеричная строка, представляющая цвет статуса
created_at
String
Дата создания
updated_at
String
Дата последнего обновления