Accounts

Change an account's settings

Sets the default Pinterest board, or whether comments and mentions are read into the inbox.

PATCH/v1/accounts/{id}

TL;DR

Question	Answer
What does it do?	Change an account's settings.
What does it need?	An API key or an OAuth access token.
What does it take?	A JSON body with the fields below, and `id` in the path.
What does it return?	Status 200 with a body of type `Account`.
In the SDK?	`flung.accounts.update()`
What can go wrong?	`401` Missing, unknown, revoked or expired API key; `404` No such account in this workspace; `422` The request failed validation; `429` Too many requests for this credential; wait for `retry-after` seconds. Every failure has the same error shape.

Example

1curl -X PATCH 'https://api.flung.dev/v1/accounts/acct_aaaaaaaaaaaaaaaaaaaaaaaa' \2  --header "Authorization: Bearer $FLUNG_API_KEY" \3  --header 'Content-Type: application/json' \4  --data '{}'

1import { Flung } from '@flung.dev/sdk'2
3const flung = new Flung({ apiKey: process.env.FLUNG_API_KEY! })4const result = await flung.accounts.update({5  id: 'acct_aaaaaaaaaaaaaaaaaaaaaaaa',6})

1const response = await fetch('https://api.flung.dev/v1/accounts/acct_aaaaaaaaaaaaaaaaaaaaaaaa', {2  method: 'PATCH',3  headers: {4    'Authorization': `Bearer ${process.env.FLUNG_API_KEY}`,5    'Content-Type': 'application/json',6  },7  body: JSON.stringify({}),8})9if (!response.ok) throw new Error((await response.json()).error.message)10const result = await response.json()

A successful answer looks like this:

1{2  "id": "acct_aaaaaaaaaaaaaaaaaaaaaaaa",3  "platform": "x",4  "platformUserId": "string",5  "username": "string",6  "profileId": "string",7  "status": "active",8  "renewal": "automatic",9  "tokenExpiresAt": "2026-11-01T09:00:00.000Z",10  "reconnectBy": "2026-11-01T09:00:00.000Z",11  "defaultBoard": {12    "id": "string",13    "name": "string"14  },15  "inbox": {16    "enabled": true,17    "readAt": "2026-11-01T09:00:00.000Z",18    "error": "string"19  },20  "createdAt": "2026-11-01T09:00:00.000Z",21  "updatedAt": "2026-11-01T09:00:00.000Z"22}

Path parameters

Field	Type	Required	Description
`id`	`string`	yes

Request body

The body has the type an object, with the fields below.

Field	Type	Required	Description
`defaultBoardId`	`string`	no	Pinterest only: the board pins go to by default; one of GET /v1/accounts/{id}/boards. at least 1 character; at most 64 characters.
`inboxEnabled`	`boolean \| null`	no	Read comments and mentions (true), stop (false), or go back to the platform's default (null).

Responses

Status	Meaning	Body
200	The account.	`Account`
401	Missing, unknown, revoked or expired API key.	`Error`
404	No such account in this workspace.	`Error`
422	The request failed validation.	`Error`
429	Too many requests for this credential; wait for `retry-after` seconds.	`Error`

Response body

A 200 answer has the type Account.

Field	Type	Required	Description
`id`	`string`	yes
`platform`	`Platform`	yes
`platformUserId`	`string`	yes
`username`	`string \| null`	yes
`profileId`	`string \| null`	yes
`status`	`"active" \| "needs_reconnect" \| "disconnected"`	yes	`needs_reconnect`: the platform refused the token; start a reconnect.
`renewal`	`"automatic" \| "manual" \| "not_needed"`	yes	`automatic`: Flung refreshes the token before it expires, until `reconnectBy` if set. `manual`: only a reconnect renews it, by `reconnectBy`. `not_needed`: the token does not expire.
`tokenExpiresAt`	`string \| null`	yes	When the current access token expires. Flung renews `automatic` ones about a day before.
`reconnectBy`	`string \| null`	yes	The last moment the account works without a reconnect; null when it renews indefinitely. Flung sends `account.reconnect_required_soon` a week before.
`defaultBoard`	`object \| null`	yes	Pinterest only: where pins go unless a post picks another board.
`defaultBoard.id`	`string`	yes
`defaultBoard.name`	`string \| null`	yes
`inbox`	`object`	yes	Reading comments and mentions into GET /v1/inbox.
`inbox.enabled`	`boolean \| null`	yes	Whether comments and mentions are read. null is the platform's default: on, except X, where reading costs money.
`inbox.readAt`	`string \| null`	yes
`inbox.error`	`string \| null`	yes	Why the last read failed, such as a missing permission.
`createdAt`	`string`	yes
`updatedAt`	`string`	yes

Doc	Why
API reference	Every endpoint
Schemas	Every request and response type
Errors	Every error code and what to do about it