Taskfolk

Taskfolk Workflows API

The Workflows API from Taskfolk — 8 operation(s) for workflows.

GitHub OpenAPI

Operations 12

GET /v1/workspaces/{slug}/workflows List workflows #
POST /v1/workspaces/{slug}/workflows Create a workflow (draft; admin-tier scope) #
GET /v1/workspaces/{slug}/workflows/{id} Get a workflow with its nodes and edges #
PATCH /v1/workspaces/{slug}/workflows/{id} Update name/description, or enable/disable (enabling enforces the plan cap and… #
DELETE /v1/workspaces/{slug}/workflows/{id} Soft-delete a workflow. #
PUT /v1/workspaces/{slug}/workflows/{id}/graph Replace a workflow's nodes and edges atomically (referential + acyclicity… #
GET /v1/workspaces/{slug}/workflows/{id}/runs List a workflow's runs (newest first) #
GET /v1/workspaces/{slug}/workflow-runs/{id} Get a workflow run with its stage states #
POST /v1/workspaces/{slug}/workflow-runs/{id}/advance Force-advance a run's state machine #
POST /v1/workspaces/{slug}/workflow-runs/{id}/complete-stage Complete the current active stage(s) of a run (member-tier workflow.run) #
POST /v1/workspaces/{slug}/projects/{key}/issues/{issueKey}/workflow Route an issue through an enabled workflow (member-tier workflow.run) #
DELETE /v1/workspaces/{slug}/projects/{key}/issues/{issueKey}/workflow Cancel the issue's active workflow run (member-tier workflow.run) #

Documentation

📖
Documentation
https://taskfolk.ai/api/v1/reference
📖
APIReference
https://taskfolk.ai/api/v1/reference
📖
Authentication
https://raw.githubusercontent.com/api-evangelist/taskfolk/refs/heads/main/authentication/taskfolk-authentication.yml
📖
RateLimits
https://raw.githubusercontent.com/api-evangelist/taskfolk/refs/heads/main/rate-limits/taskfolk-rate-limits.yml

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/taskfolk/refs/heads/main/openapi/taskfolk-workflows-api-openapi.yml

Other Resources

🔗
DeveloperPortal
https://taskfolk.ai/developer
🔗
ToolCrosswalk
https://raw.githubusercontent.com/api-evangelist/taskfolk/refs/heads/main/mcp/taskfolk-tool-crosswalk.yml
🔗
AgentCard
https://raw.githubusercontent.com/api-evangelist/taskfolk/refs/heads/main/a2a/taskfolk-a2a.yml
🔗
OAuthScopes
https://raw.githubusercontent.com/api-evangelist/taskfolk/refs/heads/main/scopes/taskfolk-scopes.yml
🔗
Webhooks
https://raw.githubusercontent.com/api-evangelist/taskfolk/refs/heads/main/asyncapi/taskfolk-webhooks.yml
🔗
ErrorCatalog
https://raw.githubusercontent.com/api-evangelist/taskfolk/refs/heads/main/errors/taskfolk-problem-types.yml
🔗
Conventions
https://raw.githubusercontent.com/api-evangelist/taskfolk/refs/heads/main/conventions/taskfolk-conventions.yml
🔗
Idempotency
https://raw.githubusercontent.com/api-evangelist/taskfolk/refs/heads/main/conventions/taskfolk-conventions.yml
🔗
DataModel
https://raw.githubusercontent.com/api-evangelist/taskfolk/refs/heads/main/data-model/taskfolk-data-model.yml
🔗
Plans
https://raw.githubusercontent.com/api-evangelist/taskfolk/refs/heads/main/plans/taskfolk-plans-pricing.yml
🔗
Conformance
https://raw.githubusercontent.com/api-evangelist/taskfolk/refs/heads/main/conformance/taskfolk-conformance.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/taskfolk-workflows-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 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.

GitHub Google LinkedIn

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

OpenAPI Specification

taskfolk-workflows-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Taskfolk Workflows API
  version: 1.0.0
  description: Public REST API for Taskfolk (taskfolk.ai). All endpoints require a workspace-scoped bearer API key. Paths are nested under `/v1/workspaces/{slug}/…`.
servers:
- url: https://taskfolk.ai/api
security:
- bearerAuth: []
tags:


# --- truncated at 32 KB (34 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/taskfolk/refs/heads/main/openapi/taskfolk-workflows-api-openapi.yml