List the accounts (BYO + hosted) that the workspace can post to. Use this endpoint to discover the account_id you need when calling the Create Post endpoint.
Behavior
The API merges the workspace’s active BYO social accounts
with any active hosted accounts. Only active accounts are returned.
IDs are stable UUIDs scoped to the workspace. If a workspace has no active
accounts the endpoint returns an empty array.
Each account is normalized to expose the platform (tiktok, instagram, etc.)
and a simplified type of byo or hosted.
Response The ID of the workspace associated with the API key.
List of social accounts available for posting. UUID account ID returned by /accounts. Use this in the accounts array
when creating a post.
The platform name (e.g., instagram, tiktok).
Type of account: byo (connected by user) or hosted (managed virtual
account).
The display name of the account.
Current status of the account connection.
Workspace that owns the account.
curl --request GET \ --url https://www.genviral.io/api/partner/v1/accounts \ --header 'Authorization: Bearer <token>' { "ok" : true , "code" : 200 , "message" : "Workspace accounts retrieved" , "data" : { "workspace_id" : "4cb5d3fd-8c8f-4ed7-a17c-4ffb52c7e6ac" , "accounts" : [ { "id" : "6b0c8c9c-55ac-4fcb-85ec-70b5a8b0d089" , "platform" : "instagram" , "type" : "byo" , "username" : "brandhq" , "display_name" : "Brand HQ" , "status" : "active" , "workspace_id" : "4cb5d3fd-8c8f-4ed7-a17c-4ffb52c7e6ac" }, { "id" : "0f4f54d4-8cce-4fb7-8c7b-befbcb8af812" , "platform" : "tiktok" , "type" : "hosted" , "username" : "ugc_trends_42" , "display_name" : "Hosted Trends 42" , "status" : "active" , "workspace_id" : "4cb5d3fd-8c8f-4ed7-a17c-4ffb52c7e6ac" } ] } } Error Responses
401/403 — authentication failed or token lacks access to the workspace500 accounts_failed — Database query failed unexpectedly 