Flowise

Flowise assistants API

The assistants API from Flowise — 2 operation(s) for assistants.

GitHub OpenAPI

Operations 5

POST /assistants Create a new assistant #
GET /assistants List all assistants #
GET /assistants/{id} Get assistant by ID #
PUT /assistants/{id} Update assistant details #
DELETE /assistants/{id} Delete an assistant #

Documentation

📖
Documentation
https://docs.flowiseai.com/api-reference
📖
Authentication
https://docs.flowiseai.com/using-flowise/api-keys

Specifications

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

Other Resources

🔗
SwaggerUI
https://github.com/FlowiseAI/Flowise/tree/main/packages/api-documentation
🔗
Prediction
https://docs.flowiseai.com/api-reference/prediction
🔗
APIsJSON
https://raw.githubusercontent.com/api-evangelist/flowise/refs/heads/main/apis.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/flowise-assistants-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

flowise-assistants-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Flowise Assistants API
  version: 1.0.0
  description: 'Flowise REST API for managing AI agent flows, chatflows, assistants, document stores, tools, variables, and predictions.

    Bearer token authentication uses an API key generated in the Flowise admin UI. The default server is your local or hosted Flowise instance at /api/v1.

    '
  license:
    name: Apache 2.0
    url: https://github.com/FlowiseAI/Flowise/blob/main/LICENSE.md
  contact:
    name: FlowiseAI
    email: support@flowiseai.com
servers:
- url: http://localhost:3000/api/v1
  description: Local Flowise server
- url: https://{instance}.flowiseai.com/api/v1
  description: Flowise Cloud instance
  variables:
    instance:
      default: app
tags:
- name: assistants
paths:
  /assistants:
    post:
      tags:
      - assistants
      security:
      - bearerAuth: []
      operationId: createAssistant
      summary: Create a new assistant
      description: Create a new assistant with the provided details
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Assistant'
        required: true
      responses:
        '200':
          description: Assistant created successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Assistant'
        '400':
          description: Invalid input provided
        '422':
          description: Validation exception
    get:
      tags:
      - assistants
      security:
      - bearerAuth: []
      summary: List all assistants
      description: Retrieve a list of all assistants
      operationId: listAssistants
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Assistant'
        '500':
          description: Internal error
  /assistants/{id}:
    get:
      tags:
      - assistants
      security:
      - bearerAuth: []
      summary: Get assistant by ID
      description: Retrieve a specific assistant by ID
      operationId: getAssistantById
      parameters:
      - in: path
        name: id
        required: true
        schema:
          type: string
        description: Assistant ID
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Assistant'
        '400':
          description: The specified ID is invalid
        '404':
          description: Assistant not found
        '500':
          description: Internal error
    put:
      tags:
      - assistants
      security:
      - bearerAuth: []
      summary: Update assistant details
      description: Update the details of an existing assistant
      operationId: updateAssistant
      parameters:
      - in: path
        name: id
        required: true
        schema:
          type: string
        description: Assistant ID
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Assistant'
      responses:
        '200':
          description: Assistant updated successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Assistant'
        '400':
          description: The specified ID is invalid or body is missing
        '404':
          description: Assistant not found
        '500':
          description: Internal error
    delete:
      tags:
      - assistants
      security:
      - bearerAuth: []
      summary: Delete an assistant
      description: Delete an assistant by ID
      operationId: deleteAssistant
      parameters:
      - in: path
        name: id
        required: true
        schema:
          type: string
        description: Assistant ID
      responses:
        '200':
          description: Assistant deleted successfully
        '400':
          description: The specified ID is invalid
        '404':
          description: Assistant not found
        '500':
          description: Internal error
components:
  schemas:
    Assistant:
      type: object
      properties:
        id:
          type: string
          example: d290f1ee-6c54-4b01-90e6-d701748f0851
        details:
          type: object
          properties:
            id:
              type: string
              example: asst_zbNeYIuXIUSKVHjJkfRo6ilv
            name:
              type: string
              example: assistant
            description:
              type: string
            model:
              type: string
              example: gpt-4
            instructions:
              type: string
              example: You are a helpful assistant, do your best to answer question and query
            temperature:
              type: number
              example: 1
            top_p:
              type: number
              example: 1
            tools:
              type: array
              items:
                type: string
              example:
              - function
              - code_interpreter
              - file_search
            tool_resources:
              type: object
              additionalProperties:
                type: object
        credential:
          type: string
          example: 7db93c02-8d5a-4117-a8f1-3dfb6721b339
        iconSrc:
          type: string
          example: /images/assistant.png
        createdDate:
          type: string
          format: date-time
          example: '2024-08-24T14:15:22Z'
        updatedDate:
          type: string
          format: date-time
          example: '2024-08-24T14:15:22Z'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT