Accounts

Disconnect an account

Deletes the stored tokens.

DELETE/v1/accounts/{id}

TL;DR

Question	Answer
What does it do?	Disconnect an account.
What does it need?	An API key, an OAuth access token, or a connect token (this is one of the calls a connect token may make).
What does it take?	`id` in the path.
What does it return?	Status 200 with a body of type `Account`.
In the SDK?	`flung.accounts.disconnect()`
As an MCP tool?	`disconnect_account`
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.

What it does

Deletes the stored tokens. The account stays listed as disconnected so past posts keep their results.

Example

1curl -X DELETE 'https://api.flung.dev/v1/accounts/acct_aaaaaaaaaaaaaaaaaaaaaaaa' \2  --header "Authorization: Bearer $FLUNG_API_KEY"

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

1const response = await fetch('https://api.flung.dev/v1/accounts/acct_aaaaaaaaaaaaaaaaaaaaaaaa', {2  method: 'DELETE',3  headers: {4    'Authorization': `Bearer ${process.env.FLUNG_API_KEY}`,5  },6})7if (!response.ok) throw new Error((await response.json()).error.message)8const 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

Responses

Status	Meaning	Body
200	The disconnected 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
`disconnect_account`	The same operation as an MCP tool