Shape your requests

Pagination, filtering, sorting, and field selection work the same on every MindCloud API list endpoint.

Every list endpoint supports the same query grammar. Learn it once and it applies to workflows, runs, connections, and everything else.

Pagination

Use limit and offset. limit defaults to 100 and caps at 1000. The response meta includes the total count:

curl "https://connect.mindcloud.co/v2/workflows/wf_8f2k1/runs?limit=50&offset=100" \
  -H "Authorization: Bearer $MINDCLOUD_API_KEY"

Every list has a stable default order, so pages stay consistent without passing sort.

Sorting

Pass sort with one or more comma-separated fields. Prefix a field with - for descending:

curl "https://connect.mindcloud.co/v2/workflows/wf_8f2k1/runs?sort=-startedOn" \
  -H "Authorization: Bearer $MINDCLOUD_API_KEY"

Field selection

Pass fields to receive only the columns you need:

curl "https://connect.mindcloud.co/v2/workflows?fields=id,name,isActive" \
  -H "Authorization: Bearer $MINDCLOUD_API_KEY"

Filtering

Any exposed field filters with plain equality or a bracket operator:

# Equality
curl "https://connect.mindcloud.co/v2/workflows/wf_8f2k1/runs?status=failed" \
  -H "Authorization: Bearer $MINDCLOUD_API_KEY"

# Operators
curl "https://connect.mindcloud.co/v2/workflows/wf_8f2k1/runs?startedOn[gte]=2026-07-01&status[in]=failed,interrupted" \
  -H "Authorization: Bearer $MINDCLOUD_API_KEY"

Operator	Meaning
`eq`	Equals (same as no operator)
`ne`	Not equal
`gt`, `gte`	Greater than, greater or equal
`lt`, `lte`	Less than, less or equal
`contains`	Substring match
`starts`, `ends`	Prefix or suffix match
`in`, `nin`	In or not in a comma-separated list

Errors

Invalid parameters return 400 with code INVALID_QUERY. Missing resources return 404 with code NOT_FOUND. Reading outside your company scope returns 403 with code FORBIDDEN. The envelope is always:

{
  "success": false,
  "error": { "code": "INVALID_QUERY", "message": "Invalid filter \"startedOn[foo]\"" }
}