Accounts and capabilities
Choose a workspace, find account IDs, and check supported operations.
Choose the workspace
A REST key is bound to one workspace. GET /api/v1/workspaces returns only that workspace, and every account or media ID you use must belong to it. Account linking happens in Posteady's Accounts page; these public endpoints list existing connections.
MCP uses OAuth and can access eligible workspaces approved for the user. Read tools can discover across workspaces; write tools derive the workspace from their target accounts. An explicit MCP workspaceId must match the target. See MCP tools.
Find an account
curl --request GET "https://www.posteady.com/api/v1/accounts" \
--header "Authorization: Bearer $POSTEADY_API_KEY"The response has an accounts array. Use accountId in publishing requests, not the provider's native user ID. provider, username, and displayName help select the right connection. X also includes isPremium; LinkedIn and Instagram include accountType.
Check capabilities
| Field | Operation |
|---|---|
readPosts | Read synchronized posts and metrics |
publishPosts | Publish an allowed format |
schedulePosts | Schedule an allowed format |
repostPosts | Repost a native platform post |
Threads, X, and LinkedIn expose all four capabilities. TikTok, Instagram, YouTube, and Facebook do not support reposting through this API. See the platform overview for formats and connection requirements.
Capabilities describe the connection's supported operations. They do not replace authorization: each request still checks your plan and operation permissions. A supported operation can also fail if the platform connection expires.
Instagram, YouTube, and Facebook write capabilities depend on the current connection and granted permissions. Facebook also depends on public-write availability. Check the returned value before offering a write action; a false value can indicate missing permissions, reconnection, or temporary availability restrictions.
Select multiple accounts
Text requests accept 1–5 Threads, X, or LinkedIn accounts in the same workspace. Each platform's content limits still apply. TikTok, Instagram, YouTube, and Facebook requests each target exactly one account and use their own publishing format.