> ## Documentation Index > Fetch the complete documentation index at: https://docs.creatorline.io/llms.txt > Use this file to discover all available pages before exploring further. # List connections > The social accounts the workspace's brands post through, oldest first. `?brand_id=` narrows the list to one brand. A post that names a platform in `channels` goes out through the brand's **first** connected account on it. When a brand has several accounts on one platform, pass the ones you mean as `connection_ids` on `POST /v1/clips` instead. `avatar_id` is the avatar pinned to the account: it posts, and replies, as that avatar. `can_publish` is false for an account that has to be reconnected in the studio first. ## OpenAPI ````yaml /openapi.json get /v1/connections openapi: 3.1.0 info: title: Creatorline API version: 1.0.0 description: >- Generate AI influencer photos and videos, and publish them to your brands' social accounts — from your own backend, your scripts, or a coding agent. Every request authenticates with an organization-scoped API key and is charged against that organization's credits, at the same prices the studio shows. servers: - url: https://api.creatorline.io description: Production - url: http://localhost:3000/api description: Local development (the same routes, under the app's own /api prefix) security: - bearerAuth: [] - apiKeyHeader: [] tags: - name: Account description: Who the key belongs to, and what it can spend. - name: Catalog description: The live tool and model catalog. Read it, do not hardcode it. - name: Brands description: >- What a generation or a post belongs to: niche, language, content, a default avatar, and the connections it posts through. - name: Avatars description: The reusable identities (face, voice, persona) a run renders with. - name: Connections description: The social accounts a brand posts through, and the avatar pinned to each. - name: Generations description: Start, price and poll image and video runs. - name: Assets description: The media library, and uploading your own files. - name: Posts description: Turn media into a post and publish it to social platforms. - name: Credits description: Balance and the consumption ledger. paths: /v1/connections: get: tags: - Connections summary: List connections description: >- The social accounts the workspace's brands post through, oldest first. `?brand_id=` narrows the list to one brand. A post that names a platform in `channels` goes out through the brand's **first** connected account on it. When a brand has several accounts on one platform, pass the ones you mean as `connection_ids` on `POST /v1/clips` instead. `avatar_id` is the avatar pinned to the account: it posts, and replies, as that avatar. `can_publish` is false for an account that has to be reconnected in the studio first. operationId: listConnections parameters: - name: brand_id in: query description: >- Only rows belonging to this brand (a brand id, from `GET /v1/brands`). schema: type: string - name: limit in: query description: How many rows to return (1-100). schema: type: integer default: 20 minimum: 1 maximum: 100 responses: '200': description: Connections, oldest first. headers: x-request-id: description: >- Correlation id for this request. Quote it in any support question. schema: type: string x-ratelimit-limit: description: Requests allowed per minute. schema: type: integer x-ratelimit-remaining: description: Requests left in the current window. schema: type: integer x-ratelimit-reset: description: Unix seconds when the window resets. schema: type: integer content: application/json: schema: type: object properties: object: type: string enum: - list data: type: array items: $ref: '#/components/schemas/Connection' has_more: type: boolean required: - object - data - has_more '401': description: Missing, malformed, revoked or expired key. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: type: authentication_error code: invalid_api_key message: Missing or invalid API key. request_id: req_8fQ2mRxK1pLd '404': description: No such resource — including one that belongs to another workspace. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: type: not_found_error code: resource_missing message: No such generation. request_id: req_8fQ2mRxK1pLd components: schemas: Connection: type: object description: One of a brand's social accounts. properties: object: type: string enum: - connection id: type: string brand_id: type: string description: The brand the account belongs to. platform: type: string description: >- The platform, spelled the way a post's `channels` spells it (`IG`, `TikTok`, `YouTube`, `Telegram`). Any other value is an account the API cannot post to. handle: type: string display_name: type: string status: type: string enum: - connected - expired - none can_publish: type: boolean description: >- Whether a post can go out through this account right now. Only such accounts are accepted in `connection_ids`. avatar_id: type: string description: >- The avatar pinned to this account (see the avatar's `pinned_connection_ids`). Absent when none is pinned. follower_count: type: integer required: - object - id - platform - status - can_publish Error: type: object description: >- Every failure has this shape. `param` names the offending field when there is one. properties: error: type: object properties: type: type: string enum: - invalid_request_error - authentication_error - permission_error - not_found_error - rate_limit_error - insufficient_credits_error - api_error code: type: string message: type: string param: type: string required: - type - code - message request_id: type: string required_credits: type: number description: 402 only. credit_balance: type: number description: 402 only. required: - error - request_id securitySchemes: bearerAuth: type: http scheme: bearer description: >- Your organization's API key, from Settings → MCP. `Authorization: Bearer crl_sk_live_…` apiKeyHeader: type: apiKey in: header name: X-API-Key description: Alternative to the Authorization header, for tooling that prefers it. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.