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

# listUserMeetings

> with optional filtering by meeting state (scheduled, active, concluded, cancelled).
Results are sorted by creation time (newest first) and limited to prevent excessive data transfer.
Includes the user's role and presence status for each meeting.



## OpenAPI

````yaml api-reference/convex-openapi.yaml post /api/run/meetings/queries/listUserMeetings
openapi: 3.0.3
info:
  title: Connvo Convex API
  version: 1.0.0
  description: >-
    HTTP interface for Connvo's Convex backend, exposing vetted query, mutation,
    and action endpoints.
servers:
  - url: https://Connvo-dev.convex.cloud
    description: Dev Convex deployment
  - url: https://Connvo-staging.convex.cloud
    description: Staging Convex deployment
  - url: https://Connvo-prod.convex.cloud
    description: Prod Convex deployment
security:
  - bearerAuth: []
tags:
  - name: Users
    description: Identity, profile, and authentication operations for Connvo users.
  - name: Meetings
    description: Scheduling, managing, and retrieving meeting data.
  - name: Transcripts
    description: Endpoints for accessing call transcripts and transcription controls.
  - name: Insights
    description: AI-generated insights, summaries, and analytics derived from meetings.
  - name: Prompts
    description: Prompt management and AI conversation guidance.
  - name: Notes
    description: Collaborative meeting notes and follow-up documentation.
  - name: WebRTC
    description: Real-time communication, session signalling, and media utilities.
  - name: System
    description: General system endpoints such as health checks and diagnostics.
paths:
  /api/run/meetings/queries/listUserMeetings:
    post:
      tags:
        - Users
      summary: listUserMeetings
      description: >-
        with optional filtering by meeting state (scheduled, active, concluded,
        cancelled).

        Results are sorted by creation time (newest first) and limited to
        prevent excessive data transfer.

        Includes the user's role and presence status for each meeting.
      operationId: postApiRunMeetingsQueriesListUserMeetings
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Request_meetings.queries.listUserMeetings'
            example:
              args:
                state: active
                limit: 20
        required: true
      responses:
        '200':
          description: Convex executed your request and returned a result
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Response_meetings.queries.listUserMeetings
              example:
                status: success
                errorMessage: ''
                errorData: {}
                value:
                  - _id: meeting_123example
                    organizerId: user_123example
                    title: Quarterly Planning Meeting
                    description: Planning the roadmap for next quarter objectives.
                    scheduledAt: 1704067200000
                    duration: 3600
                    state: active
                    participantCount: 3
                    createdAt: 1704063600000
                    updatedAt: 1704063600000
                    userRole: host
                    userPresence: joined
                  - _id: meeting_456example
                    organizerId: user_789example
                    title: Product Demo
                    scheduledAt: 1704070800000
                    duration: 1800
                    state: active
                    participantCount: 2
                    createdAt: 1704060000000
                    updatedAt: 1704060000000
                    userRole: participant
                    userPresence: joined
        '400':
          description: Failed operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FailedResponse'
        '500':
          description: Convex Internal Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FailedResponse'
      security:
        - bearerAuth: []
components:
  schemas:
    Request_meetings.queries.listUserMeetings:
      type: object
      required:
        - args
      properties:
        args:
          type: object
          properties:
            limit:
              type: number
            state:
              oneOf:
                - type: string
                  enum:
                    - scheduled
                - type: string
                  enum:
                    - active
                - type: string
                  enum:
                    - concluded
                - type: string
                  enum:
                    - cancelled
    Response_meetings.queries.listUserMeetings:
      type: object
      required:
        - status
      properties:
        status:
          type: string
          enum:
            - success
            - error
        errorMessage:
          type: string
        errorData:
          type: object
        value:
          type: array
          items:
            type: object
            required:
              - _id
              - createdAt
              - organizerId
              - state
              - title
              - updatedAt
              - userPresence
              - userRole
            properties:
              _id:
                type: string
                description: ID from table "meetings"
              createdAt:
                type: number
              description:
                type: string
              duration:
                type: number
              organizerId:
                type: string
                description: ID from table "users"
              participantCount:
                type: number
              scheduledAt:
                type: number
              state:
                oneOf:
                  - type: string
                    enum:
                      - scheduled
                  - type: string
                    enum:
                      - active
                  - type: string
                    enum:
                      - concluded
                  - type: string
                    enum:
                      - cancelled
              title:
                type: string
              updatedAt:
                type: number
              userPresence:
                oneOf:
                  - type: string
                    enum:
                      - invited
                  - type: string
                    enum:
                      - joined
                  - type: string
                    enum:
                      - left
              userRole:
                oneOf:
                  - type: string
                    enum:
                      - host
                  - type: string
                    enum:
                      - participant
                  - type: string
                    enum:
                      - observer
    FailedResponse:
      type: object
      properties: {}
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        Standard user authentication token issued via WorkOS. Provide as
        `Authorization: Bearer <user-token>`.

````