> ## Documentation Index
> Fetch the complete documentation index at: https://www.posted.cc/llms.txt
> Use this file to discover all available pages before exploring further.

# List connections

> List this team's connected social accounts. Credentials are never returned.

Read access: a read-enabled personal or team REST API key, or a signed-in user. OAuth clients use the corresponding MCP tool through /mcp.

List this team's connected social accounts. Credentials are never returned.

Credentials are never returned. Each account includes connection attribution, last confirmed publication and its pending-delivery count.

MCP clients can use [`list_connections`](/mcp-reference/list_connections) for this operation.

[Request conventions](/api-reference/overview) · [API keys](/api-keys) · [MCP connections](/mcp-connections)


## OpenAPI

````yaml api-reference/openapi.json GET /api/connections
openapi: 3.1.0
info:
  title: Posted HTTP API
  version: 0.2.0
  description: >-
    All registered application, account, OAuth, MCP transport and health
    endpoints. Publishing and draft request schemas come from the shared runtime
    validators. Replace the example server with your installation. Documentation
    uses simple request examples and does not execute live publishing requests.
servers:
  - url: https://posted-api.example.com
security: []
paths:
  /api/connections:
    get:
      tags:
        - Social connections
      summary: List connections
      description: >-
        List this team's connected social accounts. Credentials are never
        returned.


        Credentials are never returned. Each account includes connection
        attribution, last confirmed publication and its pending-delivery count.


        Read access: a read-enabled personal or team REST API key, or a
        signed-in user. OAuth clients use the corresponding MCP tool through
        /mcp.
      operationId: get_api_connections
      responses:
        '200':
          description: >-
            Successful response. Examples are illustrative; field values vary by
            record.
          content:
            application/json:
              schema:
                type: object
                properties:
                  items:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        provider:
                          type: string
                        accountId:
                          type: string
                        name:
                          type: string
                        handle:
                          type: string
                        avatarUrl:
                          type:
                            - string
                            - 'null'
                        state:
                          type: string
                        createdAt:
                          type: string
                        connectedBy:
                          type: object
                          properties:
                            id:
                              type: string
                            name:
                              type: string
                            avatarUrl:
                              type:
                                - string
                                - 'null'
                          additionalProperties: true
                        lastPublished:
                          type:
                            - string
                            - 'null'
                        scheduledCount:
                          type: integer
                      additionalProperties: true
                additionalProperties: true
              example:
                items:
                  - id: 11111111-1111-4111-8111-111111111111
                    provider: bluesky
                    accountId: did:plc:example
                    name: Alex Morgan
                    handle: alex.example.test
                    avatarUrl: null
                    state: connected
                    createdAt: '2027-01-18T09:30:00.000Z'
                    connectedBy:
                      id: 66666666-6666-4666-8666-666666666666
                      name: Alex Morgan
                      avatarUrl: null
                    lastPublished: null
                    scheduledCount: 1
        default:
          description: >-
            Request failure. Inspect code, message and requestId; respect
            Retry-After on HTTP 429.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
        - bearerAuth: []
        - sessionCookie: []
components:
  schemas:
    Error:
      type: object
      required:
        - error
      properties:
        error:
          type: object
          required:
            - code
            - message
            - requestId
          properties:
            code:
              type: string
            message:
              type: string
            requestId:
              type: string
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Personal or team Posted REST API key
    sessionCookie:
      type: apiKey
      in: cookie
      name: posted_session
      description: >-
        Signed-in human browser session; mutation requests also need the exact
        UI Origin

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.