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

# List CMS Connections

> List the project's Webflow and Framer connections, including whether each is usable for publishing. Use the returned id as connectionId when pushing drafts or publishing live. Connections are created in the dashboard.



## OpenAPI

````yaml /v2/openapi.json get /cms/connections
openapi: 3.0.0
info:
  title: Promptwatch API v2
  description: >-
    API v2 for customer integrations with Promptwatch monitoring platform. This
    version provides improved structure, additional endpoints, and enhanced
    functionality.
  version: 2.0.0
  contact:
    name: Promptwatch Support
    email: team@promptwatch.com
    url: https://promptwatch.com
  license:
    name: Commercial
    url: https://promptwatch.com/terms-and-conditions
servers:
  - url: https://server.promptwatch.com/api/v2
    description: Promptwatch API v2
security: []
tags:
  - name: Authentication
    description: API key validation and authentication
  - name: Content
    description: >-
      AI content generation and optimization. Create content asynchronously and
      poll for results.
  - name: Content Gap
    description: Content gap analysis and recommendations
  - name: Publishing
    description: >-
      Publish content to a connected CMS, or record a live URL, and track the
      published page
  - name: Models
    description: Available LLM models
  - name: Monitors
    description: Monitor management and CRUD operations
  - name: Page Tracker
    description: Track URLs and inspect citation stats, responses, and prompts
  - name: Prompts
    description: Prompt management and operations
  - name: Query Fanouts
    description: ChatGPT query fanout keywords
  - name: Responses
    description: LLM response data and analytics
  - name: Tags
    description: Tag management for prompts
  - name: Topics
    description: Topic management for prompts
  - name: Actions
    description: Action items (GEO suggestions and tasks)
  - name: Personas
    description: Persona configuration for monitors
  - name: Brands
    description: Brand management for competitive analysis
  - name: Visibility
    description: Brand visibility time series and competitor heatmaps
  - name: Citations
    description: Citation analytics from AI responses
  - name: Analytics
    description: Visitor analytics, AI crawler logs, sentiment, and brand visibility trends
  - name: Projects
    description: Project management (organization-level keys only)
  - name: Sitemap
    description: Sitemap crawl progress and discovered URLs
  - name: Site Health
    description: >-
      Crawled pages with SEO issues (titles, meta descriptions, H1, thin
      content)
  - name: Socials
    description: >-
      Social media citations (Reddit posts and YouTube videos) found in LLM
      responses
paths:
  /cms/connections:
    get:
      tags:
        - Publishing
      summary: List CMS Connections
      description: >-
        List the project's Webflow and Framer connections, including whether
        each is usable for publishing. Use the returned id as connectionId when
        pushing drafts or publishing live. Connections are created in the
        dashboard.
      operationId: listCmsConnections
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                example:
                  connections:
                    - id: 6ba7b822-9dad-11d1-80b4-00c04fd430c8
                      provider: WEBFLOW
                      isActive: true
                      needsReauth: false
                      siteName: Example Marketing Site
                      collectionName: Blog Posts
                      collectionSlug: blog
                      mappedFields:
                        - title
                        - content
                        - description
                      lastSyncedAt: '2026-03-28T14:30:00.000Z'
                      createdAt: '2026-03-15T10:00:00.000Z'
                  total: 1
                properties:
                  connections:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          format: uuid
                          description: >-
                            Connection identifier, used as connectionId when
                            publishing
                        provider:
                          type: string
                          enum:
                            - WEBFLOW
                            - FRAMER
                          description: CMS provider backing the connection
                        isActive:
                          type: boolean
                          description: Whether the connection may be used to publish
                        needsReauth:
                          type: boolean
                          description: >-
                            True when the provider rejected the stored
                            credentials
                        siteName:
                          type: string
                          nullable: true
                          description: Configured CMS site name
                        collectionName:
                          type: string
                          nullable: true
                          description: Configured CMS collection name
                        collectionSlug:
                          type: string
                          nullable: true
                          description: Configured CMS collection slug, used in derived URLs
                        mappedFields:
                          type: array
                          items:
                            type: string
                          description: >-
                            Document fields mapped to CMS fields. Title and
                            content must both be present to publish.
                        lastSyncedAt:
                          type: string
                          format: date-time
                          description: Last successful provider sync
                          nullable: true
                        createdAt:
                          type: string
                          format: date-time
                          description: Timestamp (ISO 8601)
                      required:
                        - id
                        - provider
                        - isActive
                        - needsReauth
                        - siteName
                        - collectionName
                        - collectionSlug
                        - mappedFields
                        - lastSyncedAt
                        - createdAt
                      additionalProperties: false
                    description: CMS connections configured for the project
                  total:
                    type: integer
                    description: Number of connections returned
                required:
                  - connections
                  - total
                additionalProperties: false
        '401':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                example:
                  error: Unauthorized
                  message: Missing or invalid X-API-Key header.
                properties:
                  error:
                    type: string
                    description: Error category (often aligned with HTTP semantics)
                  code:
                    type: string
                    description: Optional machine-readable code
                  message:
                    type: string
                    description: Human-readable explanation
                  details:
                    type: object
                    description: Optional structured detail (e.g. validation)
                    additionalProperties: true
                required:
                  - error
                  - message
                additionalProperties: false
        '500':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                example:
                  code: CMS_INTEGRATIONS_CONNECTION_NOT_FOUND
                  message: CMS connection not found
                properties:
                  code:
                    type: string
                    description: Error code indicating the type of error
                    enum:
                      - CONTENT_NOT_FOUND
                      - CONTENT_NOT_COMPLETED
                      - CONTENT_INVALID_PUBLICATION_URL
                      - CMS_INTEGRATIONS_CONNECTION_NOT_FOUND
                      - CMS_INTEGRATIONS_CONNECTION_CREDENTIALS_MISSING
                      - CMS_INTEGRATIONS_CONNECTION_DISABLED
                      - CMS_INTEGRATIONS_DOCUMENT_NOT_FOUND
                      - CMS_INTEGRATIONS_DOCUMENT_NO_CONTENT
                      - CMS_INTEGRATIONS_FIELD_MAPPING_STALE
                      - CMS_INTEGRATIONS_REQUIRED_MAPPING_MISSING
                      - CMS_INTEGRATIONS_STAGED_DRAFT_NOT_FOUND
                      - CMS_INTEGRATIONS_PUBLISH_FAILED
                      - API_KEY_READ_ONLY
                      - INTERNAL_ERROR
                    example: CMS_INTEGRATIONS_CONNECTION_NOT_FOUND
                  message:
                    type: string
                    description: Human-readable error message
                    example: CMS connection not found
                required:
                  - code
                  - message
                additionalProperties: false
      security:
        - ApiKeyAuth: []
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: >-
        API key for authentication. Get yours from the Promptwatch dashboard
        under Settings > API Keys.

````