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

# Get a Flow (live Meta re-sync)



## OpenAPI

````yaml /openapi.json get /api/v1/flows/{flow_id}/
openapi: 3.0.3
info:
  title: ChatBridge Public API
  version: 1.0.0
  description: >-
    Customer-facing REST API for ChatBridge — contacts, conversations, messages,
    templates, team, catalogue, tickets, and WhatsApp Flows. Authenticate with a
    workspace API key: `Authorization: Bearer cb_...`. See
    https://github.com/algosmiths/whatschat/blob/main/public_api.md for the full
    scope/versioning reference.
servers:
  - url: https://api.algosmiths.com
    description: Production
security: []
paths:
  /api/v1/flows/{flow_id}/:
    get:
      tags:
        - Flows
      summary: Get a Flow (live Meta re-sync)
      operationId: getFlow
      parameters:
        - in: path
          name: flow_id
          schema:
            type: string
          required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WhatsAppFlow'
          description: ''
      security:
        - ApiKeyAuth: []
        - tokenAuth: []
        - CookieAuth: []
components:
  schemas:
    WhatsAppFlow:
      type: object
      properties:
        id:
          type: integer
          readOnly: true
        flow_id:
          type: string
          readOnly: true
        name:
          type: string
          maxLength: 255
        status:
          allOf:
            - $ref: '#/components/schemas/WhatsAppFlowStatusEnum'
          readOnly: true
        categories: {}
        validation_errors:
          readOnly: true
        json_version:
          type: string
          readOnly: true
        data_api_version:
          type: string
          readOnly: true
        data_channel_uri:
          type: string
          maxLength: 512
        customer_endpoint_uri:
          oneOf:
            - type: string
              format: uri
              maxLength: 2048
            - type: string
              maxLength: 0
        is_data_exchange:
          type: string
          readOnly: true
        flow_json:
          nullable: true
        preview_url:
          type: string
          format: uri
          readOnly: true
        preview_expires_at:
          type: string
          format: date-time
          readOnly: true
          nullable: true
        created_at:
          type: string
          format: date-time
          readOnly: true
        updated_at:
          type: string
          format: date-time
          readOnly: true
      required:
        - created_at
        - data_api_version
        - flow_id
        - id
        - is_data_exchange
        - json_version
        - name
        - preview_expires_at
        - preview_url
        - status
        - updated_at
        - validation_errors
    WhatsAppFlowStatusEnum:
      enum:
        - DRAFT
        - PUBLISHED
        - DEPRECATED
        - BLOCKED
        - THROTTLED
      type: string
      description: |-
        * `DRAFT` - Draft
        * `PUBLISHED` - Published
        * `DEPRECATED` - Deprecated
        * `BLOCKED` - Blocked
        * `THROTTLED` - Throttled
  securitySchemes:
    ApiKeyAuth:
      type: http
      scheme: bearer
      bearerFormat: cb_...
      description: >-
        Workspace API key, e.g. `Authorization: Bearer cb_live_...`. Create one
        in Settings → API Keys. See public_api.md § 3 for scopes.
    tokenAuth:
      type: apiKey
      in: header
      name: Authorization
      description: Token-based authentication with required prefix "Token"
    CookieAuth:
      type: apiKey
      in: cookie
      name: token
      description: Dashboard session cookie — internal use only, not the public contract.

````