Accounts

Read what a post may choose

TikTok only: the creator's name, the audiences they may post to, which interactions they turned off and the longest video allowed, read from TikTok now.

GET/v1/accounts/{id}/posting-options

TL;DR

Question	Answer
What does it do?	Read what a post may choose.
What does it need?	An API key or an OAuth access token.
What does it take?	`id` in the path.
What does it return?	Status 200 with a body of type `PostingOptions`.
In the SDK?	`flung.accounts.postingOptions()`
As an MCP tool?	`get_posting_options`
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

TikTok only: the creator's name, the audiences they may post to, which interactions they turned off and the longest video allowed, read from TikTok now. TikTok asks apps to show these and let the person choose before each post.

Example

1curl -X GET 'https://api.flung.dev/v1/accounts/acct_aaaaaaaaaaaaaaaaaaaaaaaa/posting-options' \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.postingOptions({5  id: 'acct_aaaaaaaaaaaaaaaaaaaaaaaa',6})

1const response = await fetch('https://api.flung.dev/v1/accounts/acct_aaaaaaaaaaaaaaaaaaaaaaaa/posting-options', {2  method: 'GET',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  "creatorName": "string",3  "privacyLevels": [4    "PUBLIC_TO_EVERYONE",5    "SELF_ONLY"6  ],7  "commentsDisabled": true,8  "duetDisabled": true,9  "stitchDisabled": true,10  "maxVideoSeconds": 111}

Path parameters

Field	Type	Required	Description
`id`	`string`	yes

Responses

Status	Meaning	Body
200	The options.	`PostingOptions`
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 PostingOptions.

Field	Type	Required	Description
`creatorName`	`string \| null`	yes
`privacyLevels`	`string[]`	yes	The audiences this account may post to now; pass one as platformOverrides.tiktok.privacyLevel.
`commentsDisabled`	`boolean`	yes	The creator turned comments off; posts cannot allow them.
`duetDisabled`	`boolean`	yes
`stitchDisabled`	`boolean`	yes
`maxVideoSeconds`	`integer \| null`	yes

Doc	Why
API reference	Every endpoint
Schemas	Every request and response type
Errors	Every error code and what to do about it
`get_posting_options`	The same operation as an MCP tool