Monday Query
CertifiedQuery Monday users
Monday Query
Query Monday users
Query Monday users. Uses the Monday.com GraphQL API.
type: io.kestra.plugin.monday.users.QueryExamples
Fetch the first 50 active users
id: monday_query_users
namespace: company.team
tasks:
- id: list
type: io.kestra.plugin.monday.users.Query
apiToken: "{{ secret('MONDAY_API_TOKEN') }}"
limit: 50
fetchType: FETCH
Properties
apiToken *Requiredstring
Monday API token
Personal API v2 token. Generate it in Monday under Profile, Developers, My Access Tokens.
Treat the token as a secret and prefer Kestra secrets, e.g. {{ secret('MONDAY_API_TOKEN') }}.
apiUrl string
https://api.monday.com/v2Monday GraphQL endpoint
Override only for proxies or test fixtures (WireMock).
apiVersion string
2024-10Monday API version header
Sent as the API-Version header. See the Monday API versioning docs.
fetchType string
FETCHSTOREFETCHFETCH_ONENONEOutput fetch type
Controls how results are returned: FETCH_ONE returns the first row as a map,
FETCH returns all rows as an in-memory list, STORE serialises all rows to
Kestra internal storage in Ion format and returns a URI, NONE discards results
and returns only the count.
ids array
User ids filter
kind string
ALLNON_GUESTSGUESTSNON_PENDINGUser kind
One of all, non_guests, guests, non_pending.
limit integerstring
50Page size
maxRetries integerstring
3Maximum retry attempts
Number of attempts before giving up on transient Monday API errors (HTTP 429, COMPLEXITY_BUDGET_EXHAUSTED).
retryInterval string
PT5SInitial retry interval
Base wait between retry attempts. Doubles each attempt up to maxRetryInterval.
retryMaxInterval string
PT30SMaximum retry interval
Cap on the exponentially-growing retry delay.
Metrics
users.fetched counter
Total users fetched.
