LittleHorse User Tasks API

The User Tasks API from LittleHorse — 3 operation(s) for user tasks.

Documentation GitHub OpenAPI

Specifications

https://raw.githubusercontent.com/api-evangelist/littlehorse/refs/heads/main/openapi/littlehorse-user-tasks-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

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.

All 92 tools

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/littlehorse-user-tasks-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.1.0
info:
  title: LittleHorse REST External Events User Tasks 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: User Tasks
paths:
  /wfRun/{wfRunId}/userTaskRun/{userTaskRunId}:
    get:
      operationId: getUserTaskRun
      summary: Get a user task run
      description: Returns details of a specific user task run.
      tags:
      - User Tasks
      parameters:
      - name: wfRunId
        in: path
        required: true
        schema:
          type: string
      - name: userTaskRunId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UserTaskRun'
  /wfRun/{wfRunId}/userTaskRun/{userTaskRunId}/assign:
    post:
      operationId: assignUserTask
      summary: Assign a user task
      description: Assigns a user task to a user or group.
      tags:
      - User Tasks
      parameters:
      - name: wfRunId
        in: path
        required: true
        schema:
          type: string
      - name: userTaskRunId
        in: path
        required: true
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                userId:
                  type: string
                userGroup:
                  type: string
                overrideClaim:
                  type: boolean
      responses:
        '200':
          description: User task assigned
  /wfRun/{wfRunId}/userTaskRun/{userTaskRunId}/complete:
    post:
      operationId: completeUserTask
      summary: Complete a user task
      description: Completes a user task with results.
      tags:
      - User Tasks
      parameters:
      - name: wfRunId
        in: path
        required: true
        schema:
          type: string
      - name: userTaskRunId
        in: path
        required: true
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                userId:
                  type: string
                results:
                  type: object
      responses:
        '200':
          description: User task completed
components:
  schemas:
    UserTaskRun:
      type: object
      properties:
        id:
          type: object
        userTaskDefName:
          type: string
        status:
          type: string
          enum:
          - UNASSIGNED
          - ASSIGNED
          - DONE
          - CANCELLED
        userId:
          type: string
        userGroup:
          type: string
        results:
          type: object
        scheduledTime:
          type: string
          format: date-time