Установка логотипа организации

Устанавливает или заменяет логотип организации. Логотип передается файлом в формате multipart/form-data, загрузка по URL не поддерживается. Повторный запрос заново загружает изображение.

Требуется разрешение directory:write_organization — редактирование организации.

Отправить запрос может администратор организации.

Request

PUT

https://cloud-api.yandex.net/v1/directory/organizations/{org_id}/logo

Path parameters

Name

Description

org_id

Type: integer

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

Headers

Name

Description

Content-Type

Type: string

multipart/form-data с boundary, сформированным клиентом при отправке файла.

Pattern: (?i:multipart/form-data)(?:\s*;.*)?

Example: ``

Body

multipart/form-data
{
  "logo_file": "example"
}

Name

Description

logo_file

Type: string<binary>

Файл изображения для логотипа организации.

Example: example

Responses

204 No Content

Логотип установлен. Ответ без тела.

400 Bad Request

Invalid image or image URL

Body

application/json
{
  "error": "invalid_image",
  "description": "Invalid image or image URL",
  "message": "Invalid image or image URL",
  "details": {}
}

Name

Description

description

Type: string

Техническое описание ошибки.

Example: Invalid image or image URL

error

Type: string

Код ошибки

Example: invalid_image

message

Type: string

Сообщение об ошибке.

Example: Invalid image or image URL

details
Type: object

Дополнительные детали ошибки

Example
{}

401 Unauthorized

Пользователь не авторизован.

Body

application/json
{
  "error": "unauthorized",
  "description": "Unauthorized",
  "message": "Unauthorized",
  "details": {}
}

Name

Description

description

Type: string

Техническое описание ошибки.

Example: Unauthorized

error

Type: string

Код ошибки

Example: unauthorized

message

Type: string

Сообщение об ошибке.

Example: Unauthorized

details
Type: object

Дополнительные детали ошибки

Example
{}

403 Forbidden

Доступ к ресурсу запрещен. У пользователя или приложения недостаточно прав.

Body

application/json
{
  "error": "forbidden",
  "description": "Forbidden",
  "message": "Forbidden",
  "details": {}
}

Name

Description

description

Type: string

Техническое описание ошибки.

Example: Forbidden

error

Type: string

Код ошибки

Example: forbidden

message

Type: string

Сообщение об ошибке.

Example: Forbidden

details
Type: object

Дополнительные детали ошибки

Example
{}

404 Not Found

Запрашиваемый ресурс не найден.

Body

application/json
{
  "error": "not_found",
  "description": "Not found",
  "message": "Not found",
  "details": {}
}

Name

Description

description

Type: string

Техническое описание ошибки.

Example: Not found

error

Type: string

Код ошибки

Example: not_found

message

Type: string

Сообщение об ошибке.

Example: Not found

details
Type: object

Дополнительные детали ошибки

Example
{}

422 Unprocessable Entity

Invalid data

Body

application/json
{
  "error": "invalid_data",
  "description": "Invalid data",
  "message": "Invalid data",
  "details": {}
}

Name

Description

description

Type: string

Техническое описание ошибки.

Example: Invalid data

error

Type: string

Код ошибки

Example: invalid_data

message

Type: string

Сообщение об ошибке.

Example: Invalid data

details
Type: object

Дополнительные детали ошибки

Example
{}

503 Service Unavailable

Service unavailable

Body

application/json
{
  "error": "service_unavailable",
  "description": "Service unavailable",
  "message": "Service unavailable",
  "details": {}
}

Name

Description

description

Type: string

Техническое описание ошибки.

Example: Service unavailable

error

Type: string

Код ошибки

Example: service_unavailable

message

Type: string

Сообщение об ошибке.

Example: Service unavailable

details
Type: object

Дополнительные детали ошибки

Example
{}
Предыдущая
Изменение названия
Следующая
Удаление логотипа