---
title: "Update Account"
method: PATCH
path: "/api/v1/accounts/{account_id}"
tags: ["accounts"]
---

# Update Account

`PATCH /api/v1/accounts/{account_id}`

## Request

- Base URL: `https://api.nudgelink.co` (the document declares no server; this is the origin it was published from)
- URL: `https://api.nudgelink.co/api/v1/accounts/{account_id}`
- Auth: HTTP bearer

Edit account settings (timezone, invite pace, sending window). Scoped
to the caller's own accounts.

The timezone and window decide WHEN automatic actions go out; the
daily-cap day boundary stays UTC (locked decision #7).

## Path parameters

- `account_id` string, uuid, required

## Request body

- UpdateAccountRequest: Editable per-account settings: the IANA timezone (Task 4, Alembic 037), the invite pace (2026-09-28, Alembic 058) and the sending window (2026-10-06, Alembic 065). Send any subset; the window's three fields are validated together against the stored values.
  - `timezone` string, nullable
  - `invite_pace` 'safe' | 'faster', nullable
  - `send_hour_start` integer, nullable
  - `send_hour_end` integer, nullable
  - `send_days` integer[], nullable

## Response `200`

Successful Response

- LinkedInAccountOut
  - `id` string, uuid, required
  - `label` string, required
  - `external_account_id` string, nullable, required
  - `profile_url` string, nullable, required
  - `status` 'active' | 'warming' | 'paused_by_client' | 'paused_by_system' | 'requires_action' | 'banned', required
  - `warmup_week` integer, required
  - `daily_limits` object, nullable, required
  - `daily_invite_cap` integer, required
  - `timezone` string
  - `invite_pace` string
  - `send_hour_start` integer
  - `send_hour_end` integer
  - `send_days` integer[]
  - `last_action_at` string, date-time, nullable, required
  - `ban_count` integer, required
  - `created_at` string, date-time, required
  - `is_premium` boolean, nullable
  - `premium_kind` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/nudgelink/apis/nudgelink-api.md) · [All operations](https://skmtc.dev/nudgelink/apis/nudgelink-api/llms.txt) · [OpenAPI document](https://skmtc.dev/nudgelink/apis/nudgelink-api/revisions/baa46e6db986?raw)