Изменить описание контакта

Изменяет описание внешнего контакта: фамилию, имя, отчество, должность, подразделение, компанию, почтовый адрес. Для изменения электронных адресов и телефонов используйте отдельные методы.

Изменяются значения только тех параметров, которые были переданы в запросе.

Request

PATCH

https://api360.yandex.net/directory/v1/org/{orgId}/external_contacts/{contactId}

Path parameters

Name

Description

contactId*

Type: string

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

orgId*

Type: integer<int64>

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

Body

application/json
{
    "firstName": "string",
    "lastName": "string",
    "middleName": "string",
    "title": "string",
    "company": "string",
    "department": "string",
    "address": "string"
}

Name

Description

address

Type: string

Почтовый адрес.

company

Type: string

Компания.

department

Type: string

Подразделение.

firstName

Type: string

Имя.

lastName

Type: string

Фамилия.

middleName

Type: string

Отчество.

title

Type: string

Должность.

Responses

200 OK

Запрос успешно выполнен.

Body

application/json
{
    "id": "string"
}

Name

Description

id*

Type: string

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

401 Unauthorized

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

Body

application/json
{
    "code": 0,
    "message": "string",
    "details": [
        null
    ]
}

Name

Description

code

Type: integer<int32>

Код ошибки.

details

Type: any[]

Дополнительные сведения об ошибке.

message

Type: string

Описание ошибки.

403 Forbidden

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

Body

application/json
{
    "code": 0,
    "message": "string",
    "details": [
        null
    ]
}

Name

Description

code

Type: integer<int32>

Код ошибки.

details

Type: any[]

Дополнительные сведения об ошибке.

message

Type: string

Описание ошибки.

404 Not Found

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

Body

application/json
{
    "code": 0,
    "message": "string",
    "details": [
        null
    ]
}

Name

Description

code

Type: integer<int32>

Код ошибки.

details

Type: any[]

Дополнительные сведения об ошибке.

message

Type: string

Описание ошибки.

500 Internal Server Error

Внутренняя ошибка сервиса. Попробуйте повторно отправить запрос через некоторое время.

Body

application/json
{
    "code": 0,
    "message": "string",
    "details": [
        null
    ]
}

Name

Description

code

Type: integer<int32>

Код ошибки.

details

Type: any[]

Дополнительные сведения об ошибке.

message

Type: string

Описание ошибки.