Jinba Flows API

The Flows API from Jinba — 1 operation(s) for flows.

Operations 1

POST /api/v2/external/flows/{flowId}/published-run Run a published workflow #

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/jinba-flows-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.

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

OpenAPI Specification

jinba-flows-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Jinba Flow External Flows API
  version: v2
  description: REST API for executing published Jinba Flow workflows programmatically.
  x-apievangelist-method: generated
  x-apievangelist-source: https://docs.jinba.io/en/pages/basics/api
  contact:
    name: Jinba
    url: https://jinba.io
servers:
- url: https://api.jinba.dev
  description: Production
security:
- bearerAuth: []
tags:
- name: Flows
paths:
  /api/v2/external/flows/{flowId}/published-run:
    parameters:
    - name: flowId
      in: path
      required: true
      description: The published flow id.
      schema:
        type: string
    post:
      tags:
      - Flows
      operationId: runPublishedFlow
      summary: Run a published workflow
      description: Execute a published workflow. Provide input arguments as an array of name/value pairs and choose sync (blocking) or async (fire-and-forget) execution mode.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - args
              properties:
                args:
                  type: array
                  items:
                    type: object
                    required:
                    - name
                    - value
                    properties:
                      name:
                        type: string
                      value:
                        description: String, number, boolean, object, or array matching the workflow's expected input.
                mode:
                  type: string
                  enum:
                  - sync
                  - async
                  default: sync
                  description: sync blocks for the result; async returns immediately.
              example:
                args:
                - name: input1
                  value: example
                mode: sync
      responses:
        '200':
          description: Workflow execution result
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FlowRunResult'
        '400':
          description: Bad Request — invalid request format or missing required arguments
        '401':
          description: Unauthorized — invalid or missing API key
        '403':
          description: Forbidden — API key does not have access to this workflow
        '404':
          description: Not Found — workflow not found, not published, or archived
        '429':
          description: Too Many Requests — rate limit exceeded
          headers:
            Retry-After:
              schema:
                type: integer
              description: Seconds to wait before retrying
components:
  schemas:
    FlowRunResult:
      type: object
      properties:
        status:
          type: string
          enum:
          - success
          - failed
        result:
          type: object
          description: The workflow output.
        error:
          type: object
          properties:
            name:
              type: string
            value:
              type: string
            traceback:
              type: string
        stepOutputs:
          type: object
          additionalProperties:
            type: object
            properties:
              status:
                type: string
                enum:
                - success
                - failed
              result:
                type: object
              error:
                type: object
                properties:
                  name:
                    type: string
                  value:
                    type: string
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Per-flow API key passed as a Bearer token. A key is automatically generated when a workflow is first published.