> Markdown versions of all pages of this connector library are available by appending `.md` to the page URL. For the full index of connectors, see [llms.txt](https://connectors.appmixer.com/llms.txt).

# Find Meetings

- Component: `appmixer.tldv.core.FindMeetings`
- Kind: Action
- Version: 1.0.0
- Visibility: Public
- Connector: [appmixer.tldv 1.0.2](https://connectors.appmixer.com/connector/appmixer.tldv/1.0.2.md)
- Component page: <https://connectors.appmixer.com/connector/appmixer.tldv/1.0.2/component/appmixer.tldv.core.FindMeetings>

Search tl;dv meetings by free-text query, date range, meeting type and participation. Pages through all matches (up to the tl;dv 10,000 result ceiling).

## Input ports

### Port `in`

| Field | Type | Description |
| --- | --- | --- |
| Search Query (`query`) | text | Free-text search across meeting names. |
| From (`from`) | date-time | Only return meetings that happened on or after this date/time. |
| To (`to`) | date-time | Only return meetings that happened on or before this date/time. |
| Meeting Type (`meetingType`) | select | Filter by whether the meeting is internal (only your organization) or external (with outside participants). |
| Only Meetings I Participated In (`onlyParticipated`) | toggle | When enabled, only return meetings the API-key owner participated in. |
| Output Type (`outputType`) | select | Choose whether you want to receive the result set as one complete list, or first item only or one item at a time or stream the items to a file. |

## Output ports

### Port `out`

Variables are loaded dynamically from `/component/appmixer/tldv/core/FindMeetings?outPort=out&ignoreAuth=true`.

### Port `notFound`

_No fields defined for this port._

## Full metadata (component.json)

```json
{
  "name": "appmixer.tldv.core.FindMeetings",
  "label": "Find Meetings",
  "description": "Search tl;dv meetings by free-text query, date range, meeting type and participation. Pages through all matches (up to the tl;dv 10,000 result ceiling).",
  "author": "Appmixer <info@appmixer.com>",
  "version": "1.0.0",
  "auth": {
    "service": "appmixer:tldv"
  },
  "inPorts": [
    {
      "name": "in",
      "schema": {
        "type": "object",
        "properties": {
          "query": {
            "type": "string"
          },
          "from": {
            "type": "string",
            "format": "date-time"
          },
          "to": {
            "type": "string",
            "format": "date-time"
          },
          "meetingType": {
            "type": "string",
            "enum": [
              "",
              "internal",
              "external"
            ]
          },
          "onlyParticipated": {
            "type": "boolean"
          },
          "outputType": {
            "type": "string"
          }
        }
      },
      "inspector": {
        "inputs": {
          "query": {
            "type": "text",
            "label": "Search Query",
            "index": 1,
            "tooltip": "Free-text search across meeting names."
          },
          "from": {
            "type": "date-time",
            "label": "From",
            "index": 2,
            "tooltip": "Only return meetings that happened on or after this date/time."
          },
          "to": {
            "type": "date-time",
            "label": "To",
            "index": 3,
            "tooltip": "Only return meetings that happened on or before this date/time."
          },
          "meetingType": {
            "type": "select",
            "label": "Meeting Type",
            "index": 4,
            "tooltip": "Filter by whether the meeting is internal (only your organization) or external (with outside participants).",
            "options": [
              {
                "label": "Any",
                "value": ""
              },
              {
                "label": "Internal",
                "value": "internal"
              },
              {
                "label": "External",
                "value": "external"
              }
            ]
          },
          "onlyParticipated": {
            "type": "toggle",
            "label": "Only Meetings I Participated In",
            "index": 5,
            "tooltip": "When enabled, only return meetings the API-key owner participated in."
          },
          "outputType": {
            "type": "select",
            "label": "Output Type",
            "index": 6,
            "defaultValue": "array",
            "tooltip": "Choose whether you want to receive the result set as one complete list, or first item only or one item at a time or stream the items to a file.",
            "options": [
              {
                "label": "First Item Only",
                "value": "first"
              },
              {
                "label": "All items at once",
                "value": "array"
              },
              {
                "label": "One item at a time",
                "value": "object"
              },
              {
                "label": "Store to CSV file",
                "value": "file"
              }
            ]
          }
        }
      }
    }
  ],
  "outPorts": [
    {
      "name": "out",
      "source": {
        "url": "/component/appmixer/tldv/core/FindMeetings?outPort=out&ignoreAuth=true",
        "data": {
          "properties": {
            "generateOutputPortOptions": true
          },
          "messages": {
            "in/outputType": "inputs/in/outputType"
          }
        }
      }
    },
    {
      "name": "notFound",
      "schema": {
        "type": "object",
        "properties": {}
      }
    }
  ],
  "icon": "(data URI omitted)"
}
```
