Accounts

Complete OAuth account selection and save the selected account

post/accounts/selections/{connection_id}/complete

Request

  • Base URL: https://app.openpo.st/api/v1
  • URL: https://app.openpo.st/api/v1/accounts/selections/{connection_id}/complete
  • Auth: one of:
    • HTTP bearer
    • API key in cookie openpost_session

Path parameters

connection_idstring required

Pending OAuth account-selection ID

Request body

$schemastring uri

A URL to the JSON Schema for this object.

selection_idstring

Selected account, page, or channel ID. Retained for single-selection clients.

selection_idsstring[] nullable

Selected account, Page, or organization IDs. LinkedIn supports connecting several identities from one grant.

Example request

{
  "$schema": "https://example.com/api/v1/schemas/CompleteAccountSelectionInputBody.json"
}

Response

OK

$schemastring uri

A URL to the JSON Schema for this object.

account_avatar_urlstring required

Account avatar URL

account_idstring required

Platform-specific account ID

account_idsstring[] nullable required

OpenPost destination account IDs created by this selection

account_kindstring

Normalized identity kind, such as person, organization, creator, or business

account_usernamestring required

Account username

aliasstring

Internal account label. Does not change the provider identity.

capability_checked_atstring date-time

When account-specific publishing limits were last verified

fediverse_softwarestring

Detected Fediverse server software (mastodon, pixelfed, peertube, lemmy, piefed, or a compatible implementation)

grant_destination_countinteger required

Number of active destinations using this provider authorization

idstring required

Account ID

instance_urlstring required

Instance URL (Mastodon/Bluesky)

is_activeboolean required

Whether the account is active

limit_profile'standard' | 'x-premium'

Account-specific publishing limit profile

messages_enabledboolean required

Deprecated compatibility shim. Use GET /account-features for messaging enabled state.

messaging_supportedboolean required

Deprecated compatibility shim. Use GET /account-features for messaging availability and enabled state.

open_fresh_composerboolean required

Whether these are the Workspace's first connected destinations

platformstring required

Platform name

provider_installation_idstring

Operator connector installation used by this account

shared_grantboolean required

Whether revoking this authorization disconnects other destinations

slugstring required

User-editable account slug for CLI selectors

thread_replies_supportedboolean required

Whether this account supports thread replies in current server config

workspace_idstring required

Workspace receiving the connected destinations

Example response

{
  "$schema": "https://example.com/api/v1/schemas/AccountSelectionCompletionResponse.json"
}

Changes

No recorded changes to this operation across all 1 revision of this API.