Skip to content

GET - MinuteView API ​

Exposes a workflow as an HTTP GET endpoint within the MinuteView API, starting execution when the endpoint is called.

Purpose ​

Use this trigger to create a custom read-only API endpoint that launches a workflow. External systems or client applications can call the generated URL with URL query parameters, and those parameters are injected into the workflow as data. This is the standard choice when you need to provide data retrieval or status-check functionality through a simple HTTP GET interface without building a dedicated controller.

Inputs ​

FieldTypeRequiredDescription
Requires AuthenticationCheckboxNoWhen checked, the endpoint requires a valid MinuteView authentication token before the workflow runs. Leave unchecked to allow unauthenticated access.
Allowed IPsTextareaNoEnter one IP address per line. If any IPs are listed, only requests from those addresses will be accepted — all others receive a 403 response. Leave blank to allow requests from any IP.

Outputs ​

NameDescription
UrlParamsA key-value dictionary of the URL query parameters supplied when the endpoint was called.
CallerIPThe IP address of the system that called this endpoint. Use this to identify the caller's IP before adding it to the Allowed IPs list.

IP Allowlisting ​

The Allowed IPs field lets you restrict which systems can trigger the workflow. When one or more IPs are entered, any request from an address not on the list is rejected with a 403 Access denied response before the workflow runs.

Recommended setup when locking down a workflow:

  1. Leave Allowed IPs blank initially and run the workflow once from your external system.
  2. Check the CallerIP output variable in the workflow run history to see the IP address that made the call.
  3. Copy that IP into the Allowed IPs field and save the workflow.

Multiple IPs are supported — enter one per line.

Tentech