---
title: "Update account"
method: PUT
path: "/v1/accounts/{accountId}"
tags: ["Accounts"]
---

# Update account

`PUT /v1/accounts/{accountId}`

Updates a connected social account's display name or username override.

For X/Twitter accounts on usage-based billing, also accepts an `xCapabilities`
object to toggle background API operations that incur X API pass-through costs.
Both fields are opt-in (default `false`) — when off, no analytics syncs or DM
polling are performed for that account, and no API call is metered for those
operations. Publishing and deleting posts are always available regardless of
these toggles. Setting `xCapabilities` on a non-X account returns 400.

## Path parameters

- `accountId` string, required

## Request body

- object
  - `username` string
  - `displayName` string
  - `xCapabilities` object — X/Twitter only. Per-account opt-in toggles for background API operations that incur X API pass-through costs. Each call is billed via Metronome at the X tier rate. Either field can be sent independently; omitted fields are unchanged.
    - `analytics` boolean — Enable periodic analytics reads (impressions, likes, etc.) for this X account. Each X API call is metered as `posts_read` and billed pass-through (~$0.005/call at the time of writing — actual rate depends on X's pricing tier).
    - `inbox` boolean — Enable DM polling and inbox sync for this X account. DM reads are metered as `dm_event_read` (~$0.010/call) and DM sends as `dm_interaction_create` (~$0.015/call), both billed pass-through. DM sends fire only on user-initiated actions; reads/polling fire only when this flag is true.

## Response `200`

Updated

- object
  - `message` string
  - `username` string
  - `displayName` string
  - `xCapabilities` object — Echo of the resulting `xCapabilities` state, returned only when the request body included an `xCapabilities` object.
    - `analytics` boolean
    - `inbox` boolean

## Other responses

- `400` — Invalid request (e.g. xCapabilities on a non-X account)
- `401` — Unauthorized
- `404` — Resource not found

---

[API](https://skmtc.net/zernio/apis/zernio-api.md) · [All operations](https://skmtc.net/zernio/apis/zernio-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/zernio/zernio-api/revisions/15e893e69e8c/schema)