Fetch dynamic dropdown options for a step's field

curl --request POST \
  --url https://{subdomain}.mihu.ai/api/v1/flow/apps/{uid}/options \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "kind": "channels",
  "connection_uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "params": {}
}
'

{
  "success": true,
  "data": [
    {
      "label": "#general",
      "value": "C01234ABCDE"
    }
  ]
}

Flow Catalog

Fetch dynamic dropdown options for a step's field

Mirrors every ‘Refresh’ dropdown in the Studio Setup tab. Used to resolve human references like ‘#general’ or ‘Contacts module’ into the actual identifiers the action config requires. Always ask the user to pick from the response — never silently auto-select, even when only one option exists.

Per-app supported kind values:

Slack: channels, private_channels, users
Zoho CRM / Freshworks / Salesforce / Microsoft Dynamics: modules, module_fields (params.module), records (params.module)
Airtable: bases, tables (params.base_id), fields (params.base_id, table_id), records (params.base_id, table_id)
Apify: actors, tasks
Gmail: labels, messages
Google Calendar: calendars, events (params.calendar_id)
Google Sheet: spreadsheets, worksheets (params.spreadsheet_id), columns (params.spreadsheet_id, worksheet_title)
Notion: databases, pages, database_properties (params.database_id), users
Twilio: phone_numbers
Logic (builtin, no connection needed): operators, joiners, delay_units
Tables (builtin, no connection needed): tables, columns (params.table_id), operators, operators_for_type (params.type), aggregates, order_directions
Telegram: returns 422 — Bot API has no list endpoint

POST

api

flow

apps

{uid}

options

Fetch dynamic dropdown options for a step's field

curl --request POST \
  --url https://{subdomain}.mihu.ai/api/v1/flow/apps/{uid}/options \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "kind": "channels",
  "connection_uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "params": {}
}
'

{
  "success": true,
  "data": [
    {
      "label": "#general",
      "value": "C01234ABCDE"
    }
  ]
}

Authorizations

Authorization

string

header

required

Use a Bearer token to access these API endpoints. Example: "Bearer {your-token}"

Path Parameters

uid

string

required

Body

application/json

kind

string

required

App-specific lookup name. See description for the full per-app list.

Example:

"channels"

connection_uuid

string<uuid> | null

Required for connect-category apps. Optional/null for builtin apps (Logic, Tables).

params

object

Cascading dependencies. E.g. for Zoho module_fields send {module: 'Contacts'}; for Airtable tables send {base_id: '...'}.

Response

success

boolean

Example:

true

data

object[]

Show child attributes

List the tenant's connections (OAuth accounts) for one app List flows (paginated, filterable)

Documentation Index

Authorizations

Path Parameters

Body

Response