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

# List WordPress sites

> List WordPress site connections for the current dashboard account. Each site has its own token and storage access mode so agencies can disable storage or isolate client assets per site.



## OpenAPI

````yaml /openapi.json get /api/wordpress-instances
openapi: 3.1.0
info:
  title: Convertly API
  version: 1.0.0
  description: >-
    Convertly provides production API endpoints for media conversion,
    compression, Image CDN delivery, Forma AI, HLS/DASH video streaming, media
    tools, async jobs, workflows, webhooks, and Convertly Storage.
  license:
    name: Proprietary
    url: https://convertly.sh/terms
servers:
  - url: https://convertly.sh
security:
  - bearerAuth: []
  - apiKeyAuth: []
paths:
  /api/wordpress-instances:
    get:
      tags:
        - WordPress
      summary: List WordPress sites
      description: >-
        List WordPress site connections for the current dashboard account. Each
        site has its own token and storage access mode so agencies can disable
        storage or isolate client assets per site.
      operationId: listWordPressInstances
      responses:
        '200':
          description: WordPress site connections
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WordPressInstanceListResponse'
        '401':
          $ref: '#/components/responses/Error'
        '500':
          $ref: '#/components/responses/Error'
components:
  schemas:
    WordPressInstanceListResponse:
      type: object
      properties:
        instances:
          type: array
          items:
            $ref: '#/components/schemas/WordPressInstance'
      required:
        - instances
    WordPressInstance:
      type: object
      properties:
        id:
          type: string
          format: uuid
        name:
          type: string
        site_url:
          type:
            - string
            - 'null'
          format: uri
        storage_access:
          $ref: '#/components/schemas/WordPressStorageAccess'
        api_key_id:
          type:
            - string
            - 'null'
          format: uuid
        created_at:
          type: string
          format: date-time
        api_keys:
          type:
            - object
            - 'null'
          properties:
            key_prefix:
              type: string
            last_used_at:
              type:
                - string
                - 'null'
              format: date-time
      required:
        - id
        - name
        - storage_access
        - created_at
    Error:
      type: object
      properties:
        error:
          type: string
        upgradeUrl:
          type: string
      required:
        - error
    WordPressStorageAccess:
      type: string
      enum:
        - none
        - isolated
      description: >-
        `none` disables Convertly Storage for the site token. `isolated` gives
        the site its own storage scope.
  responses:
    Error:
      description: Error response
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Dashboard-generated Convertly API key. Keys currently begin with
        `cvly_`.
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: Alternative API key header for server-side clients.

````