LittleHorse Workflow Runs API
The Workflow Runs API from LittleHorse — 5 operation(s) for workflow runs.
The Workflow Runs API from LittleHorse — 5 operation(s) for workflow runs.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/littlehorse-workflow-runs-api"
curl "https://apis.io/api/v1/apis?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: LittleHorse REST External Events Workflow Runs API
description: The LittleHorse REST API provides HTTP endpoints for managing workflow specifications (WfSpec), workflow runs (WfRun), task definitions (TaskDef), external event definitions, user tasks, and other resources in the LittleHorse workflow engine.
version: 0.12.0
contact:
name: LittleHorse
url: https://littlehorse.dev/
license:
name: Server Side Public License
url: https://www.mongodb.com/licensing/server-side-public-license
servers:
- url: '{baseUrl}'
description: LittleHorse Server
variables:
baseUrl:
default: http://localhost:2023
tags:
- name: Workflow Runs
paths:
/wfRun:
post:
operationId: runWf
summary: Run a workflow
description: Starts a new workflow run based on a workflow specification.
tags:
- Workflow Runs
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/RunWfRequest'
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/WfRun'
/wfRun/{wfRunId}:
get:
operationId: getWfRun
summary: Get a workflow run
description: Returns details of a specific workflow run.
tags:
- Workflow Runs
parameters:
- name: wfRunId
in: path
required: true
schema:
type: string
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/WfRun'
delete:
operationId: deleteWfRun
summary: Delete a workflow run
description: Deletes a workflow run and its data.
tags:
- Workflow Runs
parameters:
- name: wfRunId
in: path
required: true
schema:
type: string
responses:
'200':
description: WfRun deleted
/wfRun/{wfRunId}/stop:
post:
operationId: stopWfRun
summary: Stop a workflow run
description: Stops a running workflow.
tags:
- Workflow Runs
parameters:
- name: wfRunId
in: path
required: true
schema:
type: string
requestBody:
content:
application/json:
schema:
type: object
properties:
threadRunNumber:
type: integer
responses:
'200':
description: WfRun stopped
/wfRun/{wfRunId}/resume:
post:
operationId: resumeWfRun
summary: Resume a workflow run
description: Resumes a halted workflow run.
tags:
- Workflow Runs
parameters:
- name: wfRunId
in: path
required: true
schema:
type: string
requestBody:
content:
application/json:
schema:
type: object
properties:
threadRunNumber:
type: integer
responses:
'200':
description: WfRun resumed
/wfRun/search:
get:
operationId: searchWfRuns
summary: Search workflow runs
description: Search for workflow runs based on criteria.
tags:
- Workflow Runs
parameters:
- name: wfSpecName
in: query
schema:
type: string
- name: status
in: query
schema:
type: string
enum:
- RUNNING
- COMPLETED
- HALTING
- HALTED
- ERROR
- name: limit
in: query
schema:
type: integer
- name: bookmark
in: query
schema:
type: string
responses:
'200':
description: Successful response
components:
schemas:
RunWfRequest:
type: object
required:
- wfSpecName
properties:
wfSpecName:
type: string
majorVersion:
type: integer
revision:
type: integer
id:
type: string
variables:
type: object
parentWfRunId:
type: string
WfRun:
type: object
properties:
id:
type: string
wfSpecId:
type: object
properties:
name:
type: string
majorVersion:
type: integer
revision:
type: integer
status:
type: string
enum:
- RUNNING
- COMPLETED
- HALTING
- HALTED
- ERROR
startTime:
type: string
format: date-time
endTime:
type: string
format: date-time
threadRuns:
type: array
items:
type: object
pendingInterrupts:
type: array
items:
type: object
pendingFailures:
type: array
items:
type: object