Update account

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.

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.

Parameters

• accountId (path, string) required

Request body

Content-Type: application/json

• 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 independent...

Example:

{
  "displayName": "Acme Corporation Official",
  "xCapabilities": {
    "analytics": true,
    "inbox": false
  }
}

Responses

200 — Updated

• message (string)
• username (string)
• displayName (string)
• xCapabilities (object) — Echo of the resulting xCapabilities state, returned only when the request body included an xCapabilities object.

400 — Invalid request (e.g. xCapabilities on a non-X account)

401

404