Массовое обновление настроек email-аккаунта

PATCH /accounts

Аутентификация

Передавайте API-ключ организации как Bearer-токен.

Authorization: Bearer YOUR_API_KEY

Тело запроса

application/json

account_ids integer[] обязательное

Длина массива: 1 – 100 элементов

Пример: [101, 102]

settings object обязательное

Показать вложенные поля Скрыть вложенные поля

settings.first_name string

Длина строки: максимум 255

settings.last_name string

Длина строки: максимум 255

settings.signature string

Длина строки: максимум 8192

Пример: Regards, Sales Team

settings.daily_limit number

Диапазон: x ≥ 0, x ≤ 10000

Пример: 75

settings.cooldown_start number

Диапазон: x ≥ 0

Пример: 180

settings.cooldown_end number

Диапазон: x ≥ 0

Пример: 360

settings.tags string[]

Длина массива: 0 – 64 элементов

settings.warmup object

Показать вложенные поля Скрыть вложенные поля

settings.warmup.enabled boolean

settings.warmup.daily_limit number

Диапазон: x ≥ 1, x ≤ 1000

settings.warmup.starting_email_number number

Диапазон: x ≥ 0, x ≤ 1000

settings.imap_host string

Длина строки: максимум 255

settings.imap_port number

Диапазон: x ≥ 1, x ≤ 65535

settings.smtp_host string

Длина строки: максимум 255

settings.smtp_port number

Диапазон: x ≥ 1, x ≤ 65535

settings.app_password string

Длина строки: максимум 512

settings.imap_password string

Длина строки: максимум 512

settings.smtp_password string

Длина строки: максимум 512

Ответ

application/json

Аккаунты успешно обновлены

updated number обязательное

Пример: 2

items object[] обязательное

Показать вложенные поля Скрыть вложенные поля

items.id number обязательное

Пример: 101

items.email string обязательное

Пример: sender@example.com

items.provider string обязательное

Пример: custom

items.first_name string обязательное

Пример: Sales

items.last_name string обязательное

Пример: Team

items.signature string обязательное

Пример: Regards, Sales Team

items.daily_limit number обязательное

Пример: 75

items.cooldown_start number обязательное

Пример: 180

items.cooldown_end number обязательное

Пример: 360

items.imap_host string обязательное

Пример: imap.example.com

items.imap_port number обязательное

Пример: 993

items.smtp_host string обязательное

Пример: smtp.example.com

items.smtp_port number обязательное

Пример: 465

items.tags string[] обязательное

Пример: ["outbound"]

items.status string обязательное

Пример: Connected

items.error_text string обязательное

Пример: null

items.sent_today number обязательное

Пример: 12

items.total_sent number обязательное

Пример: 420

items.warmup object обязательное

Показать вложенные поля Скрыть вложенные поля

items.warmup.enabled boolean обязательное

Пример: true

items.warmup.daily_limit number обязательное

Пример: 20

items.warmup.starting_email_number number обязательное

Пример: 1

items.warmup.expected_to_send number обязательное

Пример: 8

items.warmup.sent_today number обязательное

Пример: 7

items.warmup.started_at string обязательное

Пример: 2026-08-01T08:00:00.000Z

items.warmup.last_scheduled_at string обязательное

Пример: 2026-08-06T10:15:00.000Z

Запрос

curl --request PATCH \
  --url https://developer.coldy.ai/api/v1/accounts \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "account_ids": [
    101,
    102
  ],
  "settings": {
    "signature": "Regards, Sales Team",
    "daily_limit": 75,
    "cooldown_start": 180,
    "cooldown_end": 360
  }
}'

{
  "updated": 2,
  "items": [
    {
      "id": 101,
      "email": "sender@example.com",
      "provider": "custom",
      "first_name": "Sales",
      "last_name": "Team",
      "signature": "Regards, Sales Team",
      "daily_limit": 75,
      "cooldown_start": 180,
      "cooldown_end": 360,
      "imap_host": "imap.example.com",
      "imap_port": 993,
      "smtp_host": "smtp.example.com"
    }
  ]
}

{
  "message": [
    "You put invalid API key. Verify your key with the key from your account in Coldy. Check documenation for info"
  ],
  "statusCode": 400,
  "error": "Invalid API key"
}