COcortex
Workflows

List workflow runs

Changed on

List workflow runs based on filters.

API key must have the View workflow runs permission.

get/api/v1/workflows/runs

Request

  • Base URL
    https://api.getcortexapp.com
  • URL
    https://api.getcortexapp.com/api/v1/workflows/runs
  • Auth
    HTTP bearer

Query parameters

includeContextboolean

When true, the response includes the run context. Defaults to false for MCP clients and true otherwise.

workflowIdsstring[]

Filter by workflow tag or CID. Repeat the parameter for several workflows.

searchQuerystring

Search query for workflow name or description

entityIdstring

Filter by target entity tag or CID

initiatedBystring[]

Filter by the email of the user who initiated the run. Repeat the parameter for several users.

startedAfterstring

Filter runs started after this time (UTC, without an offset, e.g. 2026-06-22T00:00:00). Runs older than 30 days are never returned.

startedBeforestring

Filter runs started before this time (UTC, without an offset, e.g. 2026-06-22T00:00:00)

pageinteger

Page number, starting at 0

sizeinteger

Number of runs per page

sortstring[]

Sort as property,direction. Defaults to dateCreated,desc.

Response

Successfully found workflow runs

hasMoreboolean required
pageinteger required
totalinteger required
totalCappedboolean required
totalPagesinteger required

Example response

{
  "items": [
    {
      "initiatedBy": {
        "email": "cristina@cortex.io",
        "name": "Cristina Buenahora"
      }
    }
  ]
}

Changes