Cut.ProDocs
Connections

List connections

Returns the active social connections in this workspace — the IDs you pass as connection_id when creating a post. Each entry includes the platform, public profile info (username, avatar, bio) and the latest captured audience metrics (followers, posts, likes). Revoked or disconnected accounts are excluded.

Authorization

apiKey
X-Api-Key<token>

In: header

Query Parameters

page?number

Page number (default: 1)

Range1 <= value
limit?number

Items per page (default: 50, max: 100)

Range1 <= value <= 100
platform?string

Value in

  • "youtube"
  • "tiktok"
  • "instagram"
  • "bluesky"
  • "threads"
  • "linkedin"
  • "pinterest"
  • "facebook"
  • "twitch"
  • "kick"
  • "discord"

Response Body

application/json

GET
/connections
curl -X GET "https://example.com/connections"
{  "connections": [    {      "id": "string",      "platform": "string",      "username": "string",      "avatar_url": "string",      "biography": "string",      "followers_count": 0,      "posts_count": 0,      "likes_count": 0,      "is_verified": true,      "created_at": "string"    }  ],  "pagination": {    "current_page": 0,    "total_pages": 0,    "total_count": 0,    "has_next_page": true,    "has_previous_page": true,    "limit": 0  }}

Get render download URL GET

Returns a time-limited signed URL to download the completed rendered video as an MP4. The URL expires after **1 hour** — fetch it fresh each time rather than caching it. Returns `410` if the file has been purged from storage (renders expire according to your plan's retention period).

Get a connection GET

Returns a single connection by ID, with the latest captured audience metrics.