B3

B3 Workflows API

The Workflows API from B3 — 22 operation(s) for workflows.

GitHub OpenAPI

Operations 44

GET /v1/workflows Get workflows #
POST /v1/workflows Create workflows #
POST /v1/workflows/validate Create workflows validate #
DELETE /v1/workflows/{id} Delete workflows by id #
GET /v1/workflows/{id} Get workflows by id #
PUT /v1/workflows/{id} Replace workflows by id #
DELETE /v1/workflows/{id}/draft Delete workflows by id draft #
GET /v1/workflows/{id}/draft Get workflows by id draft #
GET /v1/workflows/{id}/live Get workflows by id live #
POST /v1/workflows/{id}/pause Create workflows by id pause #
POST /v1/workflows/{id}/publish Create workflows by id publish #
POST /v1/workflows/{id}/refill Create workflows by id refill #
POST /v1/workflows/{id}/regenerate-descriptions Create workflows by id regenerate descriptions #
POST /v1/workflows/{id}/resume Create workflows by id resume #
POST /v1/workflows/{id}/rollback Create workflows by id rollback #
POST /v1/workflows/{id}/run Create workflows by id run #
GET /v1/workflows/{id}/runs Get workflows by id runs #
GET /v1/workflows/{id}/runs/count Get workflows by id runs count #
DELETE /v1/workflows/{id}/storage Delete workflows by id storage #
GET /v1/workflows/{id}/trigger-info Get workflows by id trigger info #
PATCH /v1/workflows/{id}/ui-metadata Update workflows by id ui metadata #
GET /v1/workflows/{id}/versions Get workflows by id versions #
GET /v1/workflows/{id}/versions/count Get workflows by id versions count #
GET /v1/workflows/{id}/versions/{versionNumber} Get workflows by id versions by version number #
DELETE /v1/workflows/{id}/widget Delete workflows by id widget #
POST /v1/workflows/{id}/widget Create workflows by id widget #
GET /v1/workflows/{id}/runs/stream Stream workflow run events #
POST /v1/workflows/analyze-funds Create workflows analyze funds #
GET /v1/workflows/counts Get workflows counts #
GET /v1/workflows/owner-counts Get workflows owner counts #
GET /v1/workflows/{id}/analyze-funds Get workflows by id analyze funds #
PUT /v1/workflows/{id}/fund-auto-swap Replace workflows by id fund auto swap #
PUT /v1/workflows/{id}/owner Replace workflows by id owner #
POST /v1/workflows/{id}/release Create workflows by id release #
GET /v1/workflows/{id}/releases Get workflows by id releases #
POST /v1/workflows/{id}/releases/{releaseVersion}/revert Create workflows by id releases by release version revert #
POST /v1/workflows/{id}/revert-to-version Create workflows by id revert to version #
GET /v1/workflows/{id}/schedule Get workflows by id schedule #
GET /v1/workflows/{id}/trigger-aggregates Get workflows by id trigger aggregates #
POST /v1/workflows/{id}/unarchive Create workflows by id unarchive #
PUT /v1/workflows/{id}/visibility Replace workflows by id visibility #
GET /v1/workflow-runs/stream Stream run events for multiple workflows #
POST /v1/workflows/batch-meta Batch workflow metadata #

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/b3/refs/heads/main/openapi/b3-workflows-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/b3-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

b3-workflows-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: B3 Workflows API
  version: '1.0'
  description: 'Operations tagged Workflows across 2 of this provider''s published API definitions: b3-b3os-workflow-openapi.json, b3-b3os-workflow-openapi_2.json. Each path carries the servers of the definition it was published in.'
tags:
- name: Workflows
paths:
  /v1/workflows:
    get:
      description: Get all workflows
      parameters:
      - description: Number of items (default 20, max 100)
        in: query
        name: limit
        schema:
          type: integer
      - description: Offset for pagination (default 0)
        in: query
        name: offset
        schema:
          type: integer
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListWorkflowsSuccessResponse'
          description: OK
      tags:
      - Workflows
      summary: Get workflows
      x-summary-source: derived
      operationId: getV1Workflows
      x-operation-id-source: derived
    post:
      description: Create a new workflow
      requestBody:
        content:
          application/json:
            schema:
              oneOf:
              - type: object
              - $ref: '#/components/schemas/CreateWorkflowParams'
                summary: request
                description: Workflow details
        description: Workflow details
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreateWorkflowSuccessResponse'
          description: OK
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/github_com_b3-fun_b3-mono_services_b3os-workflow_internal_app_api_http.ErrorResponse'
          description: Bad Request
      tags:
      - Workflows
      summary: Create workflows
      x-summary-source: derived
      operationId: postV1Workflows
      x-operation-id-source: derived
  /v1/workflows/validate:
    post:
      description: Validate a workflow definition without saving
      requestBody:
        content:
          application/json:
            schema:
              oneOf:
              - type: object
              - $ref: '#/components/schemas/ValidateWorkflowParams'
                summary: request
                description: Workflow definition and name to validate
        description: Workflow definition and name to validate
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValidateWorkflowSuccessResponse'
          description: OK
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/github_com_b3-fun_b3-mono_services_b3os-workflow_internal_app_api_http.ErrorResponse'
          description: Bad Request
      tags:
      - Workflows
      summary: Create workflows validate
      x-summary-source: derived
      operationId: postV1WorkflowsValidate
      x-operation-id-source: derived
  /v1/workflows/{id}:
    delete:
      description: Archive a workflow (soft delete)
      parameters:
      - description: Workflow ID
        in: path
        name: id
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              type: object
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/github_com_b3-fun_b3-mono_services_b3os-workflow_internal_app_api_http.SuccessResponse'
          description: OK
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/github_com_b3-fun_b3-mono_services_b3os-workflow_internal_app_api_http.ErrorResponse'
          description: Not Found
      tags:
      - Workflows
      summary: Delete workflows by id
      x-summary-source: derived
      operationId: deleteV1WorkflowsById
      x-operation-id-source: derived
    get:
      description: Get a workflow by ID
      parameters:
      - description: Workflow ID
        in: path
        name: id
        required: true
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetWorkflowSuccessResponse'
          description: OK
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/github_com_b3-fun_b3-mono_services_b3os-workflow_internal_app_api_http.ErrorResponse'
          description: Not Found
      tags:
      - Workflows
      summary: Get workflows by id
      x-summary-source: derived
      operationId: getV1WorkflowsById
      x-operation-id-source: derived
    put:
      description: Update a workflow (creates new version due to immutability)
      parameters:
      - description: Workflow ID
        in: path
        name: id
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              oneOf:
              - type: object
              - $ref: '#/components/schemas/UpdateWorkflowParams'
                summary: request
                description: New workflow definition
        description: New workflow definition
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UpdateWorkflowSuccessResponse'
          description: OK
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/github_com_b3-fun_b3-mono_services_b3os-workflow_internal_app_api_http.ErrorResponse'
          description: Bad Request
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/github_com_b3-fun_b3-mono_services_b3os-workflow_internal_app_api_http.ErrorResponse'
          description: Not Found
      tags:
      - Workflows
      summary: Replace workflows by id
      x-summary-source: derived
      operationId: putV1WorkflowsById
      x-operation-id-source: derived
  /v1/workflows/{id}/draft:
    delete:
      description: Discard the draft version of a workflow
      parameters:
      - description: Workflow ID
        in: path
        name: id
        required: true
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/github_com_b3-fun_b3-mono_services_b3os-workflow_internal_app_api_http.SuccessResponse'
          description: OK
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/github_com_b3-fun_b3-mono_services_b3os-workflow_internal_app_api_http.ErrorResponse'
          description: Not Found
      tags:
      - Workflows
      summary: Delete workflows by id draft
      x-summary-source: derived
      operationId: deleteV1WorkflowsByIdDraft
      x-operation-id-source: derived
    get:
      description: Get the draft version of a workflow
      parameters:
      - description: Workflow ID
        in: path
        name: id
        required: true
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetWorkflowSuccessResponse'
          description: OK
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/github_com_b3-fun_b3-mono_services_b3os-workflow_internal_app_api_http.ErrorResponse'
          description: Not Found
      tags:
      - Workflows
      summary: Get workflows by id draft
      x-summary-source: derived
      operationId: getV1WorkflowsByIdDraft
      x-operation-id-source: derived
  /v1/workflows/{id}/live:
    get:
      description: Get the live (active/paused) version of a workflow
      parameters:
      - description: Workflow ID
        in: path
        name: id
        required: true
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetWorkflowSuccessResponse'
          description: OK
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/github_com_b3-fun_b3-mono_services_b3os-workflow_internal_app_api_http.ErrorResponse'
          description: Not Found
      tags:
      - Workflows
      summary: Get workflows by id live
      x-summary-source: derived
      operationId: getV1WorkflowsByIdLive
      x-operation-id-source: derived
  /v1/workflows/{id}/pause:
    post:
      description: Pause a workflow
      parameters:
      - description: Workflow ID
        in: path
        name: id
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              type: object
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/github_com_b3-fun_b3-mono_services_b3os-workflow_internal_app_api_http.SuccessResponse'
          description: OK
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/github_com_b3-fun_b3-mono_services_b3os-workflow_internal_app_api_http.ErrorResponse'
          description: Bad Request
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/github_com_b3-fun_b3-mono_services_b3os-workflow_internal_app_api_http.ErrorResponse'
          description: Not Found
      tags:
      - Workflows
      summary: Create workflows by id pause
      x-summary-source: derived
      operationId: postV1WorkflowsByIdPause
      x-operation-id-source: derived
  /v1/workflows/{id}/publish:
    post:
      description: Publish a draft workflow (validates cronjob intervals, activates)
      parameters:
      - description: Workflow ID
        in: path
        name: id
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              oneOf:
              - type: object
              - $ref: '#/components/schemas/PublishWorkflowParams'
                summary: body
                description: Optional parameters
        description: Optional parameters
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/github_com_b3-fun_b3-mono_services_b3os-workflow_internal_app_api_http.SuccessResponse'
          description: OK
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/github_com_b3-fun_b3-mono_services_b3os-workflow_internal_app_api_http.ErrorResponse'
          description: Bad Request
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/github_com_b3-fun_b3-mono_services_b3os-workflow_internal_app_api_http.ErrorResponse'
          description: Not Found
        '409':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/github_com_b3-fun_b3-mono_services_b3os-workflow_internal_app_api_http.ErrorResponse'
          description: Conflict
      tags:
      - Workflows
      summary: Create workflows by id publish
      x-summary-source: derived
      operationId: postV1WorkflowsByIdPublish
      x-operation-id-source: derived
  /v1/workflows/{id}/refill:
    post:
      description: Refill remaining runs for a workflow
      parameters:
      - description: Workflow ID
        in: path
        name: id
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              oneOf:
              - type: object
              - $ref: '#/components/schemas/RefillWorkflowParams'
                summary: request
                description: New remain_runs value
        description: New remain_runs value
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RefillWorkflowSuccessResponse'
          description: OK
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/github_com_b3-fun_b3-mono_services_b3os-workflow_internal_app_api_http.ErrorResponse'
          description: Bad Request
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/github_com_b3-fun_b3-mono_services_b3os-workflow_internal_app_api_http.ErrorResponse'
          description: Not Found
      tags:
      - Workflows
      summary: Create workflows by id refill
      x-summary-source: derived
      operationId: postV1WorkflowsByIdRefill
      x-operation-id-source: derived
  /v1/workflows/{id}/regenerate-descriptions:
    post:
      description: Regenerate AI descriptions for a workflow
      parameters:
      - description: Workflow ID
        in: path
        name: id
        required: true
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RegenerateDescriptionsSuccessResponse'
          description: OK
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/github_com_b3-fun_b3-mono_services_b3os-workflow_internal_app_api_http.ErrorResponse'
          description: Not Found
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/github_com_b3-fun_b3-mono_services_b3os-workflow_internal_app_api_http.ErrorResponse'
          description: Internal Server Error
      tags:
      - Workflows
      summary: Create workflows by id regenerate descriptions
      x-summary-source: derived
      operationId: postV1WorkflowsByIdRegenerateDescriptions
      x-operation-id-source: derived
  /v1/workflows/{id}/resume:
    post:
      description: Resume a paused workflow
      parameters:
      - description: Workflow ID
        in: path
        name: id
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              type: object
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/github_com_b3-fun_b3-mono_services_b3os-workflow_internal_app_api_http.SuccessResponse'
          description: OK
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/github_com_b3-fun_b3-mono_services_b3os-workflow_internal_app_api_http.ErrorResponse'
          description: Bad Request
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/github_com_b3-fun_b3-mono_services_b3os-workflow_internal_app_api_http.ErrorResponse'
          description: Not Found
      tags:
      - Workflows
      summary: Create workflows by id resume
      x-summary-source: derived
      operationId: postV1WorkflowsByIdResume
      x-operation-id-source: derived
  /v1/workflows/{id}/rollback:
    post:
      description: Rollback workflow to a previous version
      parameters:
      - description: Workflow ID
        in: path
        name: id
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              oneOf:
              - type: object
              - $ref: '#/components/schemas/RollbackWorkflowParams'
                summary: body
                description: Rollback params
        description: Rollback params
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RollbackWorkflowSuccessResponse'
          description: OK
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/github_com_b3-fun_b3-mono_services_b3os-workflow_internal_app_api_http.ErrorResponse'
          description: Bad Request
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/github_com_b3-fun_b3-mono_services_b3os-workflow_internal_app_api_http.ErrorResponse'
          description: Not Found
      tags:
      - Workflows
      summary: Create workflows by id rollback
      x-summary-source: derived
      operationId: postV1WorkflowsByIdRollback
      x-operation-id-source: derived
  /v1/workflows/{id}/run:
    post:
      description: Run a workflow with optional payload. Works for draft and active workflows. Does not count against maxRuns or enforce cooldown.
      parameters:
      - description: Workflow ID
        in: path
        name: id
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              oneOf:
              - type: object
              - $ref: '#/components/schemas/RunParams'
                summary: body
                description: Optional payload
        description: Optional payload
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RunSuccessResponse'
          description: OK
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/github_com_b3-fun_b3-mono_services_b3os-workflow_internal_app_api_http.ErrorResponse'
          description: Bad request or workflow is not runnable (paused/archived)
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/github_com_b3-fun_b3-mono_services_b3os-workflow_internal_app_api_http.ErrorResponse'
          description: Workflow not found
      tags:
      - Workflows
      summary: Create workflows by id run
      x-summary-source: derived
      operationId: postV1WorkflowsByIdRun
      x-operation-id-source: derived
  /v1/workflows/{id}/runs:
    get:
      description: List all runs for a specific workflow
      parameters:
      - description: Workflow ID
        in: path
        name: id
        required: true
        schema:
          type: string
      - description: Number of items (default 20, max 100)
        in: query
        name: limit
        schema:
          type: integer
      - description: Offset for pagination (default 0)
        in: query
        name: offset
        schema:
          type: integer
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListRunsSuccessResponse'
          description: OK
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/github_com_b3-fun_b3-mono_services_b3os-workflow_internal_app_api_http.ErrorResponse'
          description: Not Found
      tags:
      - Workflows
      summary: Get workflows by id runs
      x-summary-source: derived
      operationId: getV1WorkflowsByIdRuns
      x-operation-id-source: derived
  /v1/workflows/{id}/runs/count:
    get:
      description: Count runs for a specific workflow, grouped by status
      parameters:
      - description: Workflow ID
        in: path
        name: id
        required: true
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CountWorkflowRunsSuccessResponse'
          description: OK
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/github_com_b3-fun_b3-mono_services_b3os-workflow_internal_app_api_http.ErrorResponse'
          description: Not Found
      tags:
      - Workflows
      summary: Get workflows by id runs count
      x-summary-source: derived
      operationId: getV1WorkflowsByIdRunsCount
      x-operation-id-source: derived
  /v1/workflows/{id}/storage:
    delete:
      description: Clear all storage data for a workflow
      parameters:
      - description: Workflow ID
        in: path
        name: id
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              type: object
      responses:
        '200':
          content:
            application/json:
              schema:
                additionalProperties: {}
                type: object
          description: OK
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/github_com_b3-fun_b3-mono_services_b3os-workflow_internal_app_api_http.ErrorResponse'
          description: Not Found
      tags:
      - Workflows
      summary: Delete workflows by id storage
      x-summary-source: derived
      operationId: deleteV1WorkflowsByIdStorage
      x-operation-id-source: derived
  /v1/workflows/{id}/trigger-info:
    get:
      description: Get trigger info (e.g. Pipedream email address) for a workflow
      parameters:
      - description: Workflow ID
        in: path
        name: id
        required: true
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetTriggerInfoSuccessResponse'
          description: OK
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/github_com_b3-fun_b3-mono_services_b3os-workflow_internal_app_api_http.ErrorResponse'
          description: Not Found
      tags:
      - Workflows
      summary: Get workflows by id trigger info
      x-summary-source: derived
      operationId: getV1WorkflowsByIdTriggerInfo
      x-operation-id-source: derived
  /v1/workflows/{id}/ui-metadata:
    patch:
      description: Update workflow UI metadata (node positions) in-place
      parameters:
      - description: Workflow ID
        in: path
        name: id
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              oneOf:
              - type: object
              - $ref: '#/components/schemas/UpdateWorkflowUIMetadataParams'
                summary: request
                description: UI metadata
        description: UI metadata
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UpdateWorkflowUIMetadataSuccessResponse'
          description: OK
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/github_com_b3-fun_b3-mono_services_b3os-workflow_internal_app_api_http.ErrorResponse'
          description: Bad Request
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/github_com_b3-fun_b3-mono_services_b3os-workflow_internal_app_api_http.ErrorResponse'
          description: Not Found
        '409':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/github_com_b3-fun_b3-mono_services_b3os-workflow_internal_app_api_http.ErrorResponse'
          description: Conflict
      tags:
      - Workflows
      summary: Update workflows by id ui metadata
      x-summary-source: derived
      operationId: patchV1WorkflowsByIdUiMetadata
      x-operation-id-source: derived
  /v1/workflows/{id}/versions:
    get:
      description: List all versions of a workflow
      parameters:
      - description: Workflow ID (any version)
        in: path
        name: id
        required: true
        schema:
          type: string
      - description: Number of items (default 20, max 100)
        in: query
        name: limit
        schema:
          type: integer
      - description: Offset for pagination (default 0)
        in: query
        name: offset
        schema:
          type: integer
      requestBody:
        content:
          application/json:
            schema:
              type: object
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListWorkflowVersionsSuccessResponse'
          description: OK
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/github_com_b3-fun_b3-mono_services_b3os-workflow_internal_app_api_http.ErrorResponse'
          description: Not Found
      tags:
      - Workflows
      summary: Get workflows by id versions
      x-summary-source: derived
      operationId: getV1WorkflowsByIdVersions
      x-operation-id-source: derived
  /v1/workflows/{id}/versions/count:
    get:
      description: Count total versions for a specific workflow
      parameters:
      - description: Workflow ID
        in: path
        name: id
        required: true
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CountWorkflowVersionsSuccessResponse'
          description: OK
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/github_com_b3-fun_b3-mono_services_b3os-workflow_internal_app_api_http.ErrorResponse'
          description: Not Found
      tags:
      - Workflows
      summary: Get workflows by id versions count
      x-summary-source: derived
      operationId: getV1WorkflowsByIdVersionsCount
      x-operation-id-source: derived
  /v1/workflows/{id}/versions/{versionNumber}:
    get:
      description: Get a specific version of a workflow by version number
      parameters:
      - description: Workflow ID
        in: path
        name: id
        required: true
        schema:
          type: string
      - description: Version number
        in: path
        name: versionNumber
        required: true
        schema:
          type: integer
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetWorkflowVersionSuccessResponse'
          description: OK
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/github_com_b3-fun_b3-mono_services_b3os-workflow_internal_app_api_http.ErrorResponse'
          description: Bad Request
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/github_com_b3-fun_b3-mono_services_b3os-workflow_internal_app_api_http.ErrorResponse'
          description: Not Found
      tags:
      - Workflows
      summary: Get workflows by id versions by version number
      x-summary-source: derived
      operationId: getV1WorkflowsByIdVersionsByVersionNumber
      x-operation-id-source: derived
  /v1/workflows/{id}/widget:
    delete:
      description: Disable public widget for a workflow
      parameters:
      - description: Workflow ID
        in: path
        name: id
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              type: object
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/github_com_b3-fun_b3-mono_services_b3os-workflow_internal_app_api_http.SuccessResponse'
          description: OK
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/github_com_b3-fun_b3-mono_services_b3os-workflow_internal_app_api_http.ErrorResponse'
          description: Bad Request
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/github_com_b3-fun_b3-mono_services_b3os-workflow_internal_app_api_http.ErrorResponse'
          description: Not Found
      tags:
      - Workflows
      summary: Delete workflows by id widget
      x-summary-source: derived
      operationId: deleteV1WorkflowsByIdWidget
      x-operation-id-source: derived
    post:
      description: Enable public widget for a workflow
      parameters:
      - description: Workflow ID
        in: path
        name: id
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              oneOf:
              - type: object
              - $ref: '#/components/schemas/PublishWidgetParams'
                summary: body
                description: Widget configuration
        description: Widget configuration
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublishWidgetSuccessResponse'
          description: OK
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/github_com_b3-fun_b3-mono_services_b3os-workflow_internal_app_api_http.ErrorResponse'
          description: Bad Request
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/github_com_b3-fun_b3-mono_services_b3os-workflow_internal_app_api_http.ErrorResponse'
          description: Not Found
      tags:
      - Workflows
      summary: Create workflows by id widget
      x-summary-source: derived
      operationId: postV1WorkflowsByIdWidget
      x-operation-id-source: derived
  /v1/workflows/{id}/runs/stream:
    get:
      description: SSE endpoint for real-time notifications when runs start/complete for a workflow.
      parameters:
      - description: Workflow ID
        in: path
        name: id
        required: true
        schema:
          type: string
      responses:
        '200':
          content:
            text/event-stream:
              schema:
                type: string
          description: SSE stream with workflow run events
        '400':
          content:
            text/event-stream:
              schema:
                $ref: '#/components/schemas/github_com_b3-fun_b3-mono_services_b3os-workflow_internal_app_api_http.ErrorResponse'
          description: Bad Request
        '403':
          content:
            text/event-stream:
              schema:
                $ref: '#/components/schemas/github_com_b3-fun_b3-mono_services_b3os-workflow_internal_app_api_http.ErrorResponse'
          description: Forbidden
      summary: Stream workflow run events
      tags:
      - Workflows
      operationId: getV1WorkflowsByIdRunsStream
      x-operation-id-source: derived
  /v1/workflows/analyze-funds:
    post:
      description: Analyze the fund requirements of an inline workflow definition without saving or executing it. Same response shape as the workflow-scoped variant, with `workflowId` empty. Read-only — does not consume CU.
      requestBody:
        content

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