Brainfish · Arazzo Workflow

Create a collection and add a document

Version 1.0.0

Validate the token, create a knowledge-base collection, then create a document inside it.

1 workflow 3 source APIs 1 provider
View Spec View on GitHub CompanyArtificial IntelligenceCustomer-SupportKnowledge BaseHelp DeskAgentsSupport AutomationSoftware-as-a-ServiceArazzoWorkflows

Provider

brainfish

Workflows

create-collection-and-document
Create a collection and a document within it.
3 steps inputs: collectionName, documentContent, documentTitle outputs: collectionId, documentId
1
validate
2
createCollection
3
createDocument

Source API Descriptions

Arazzo Workflow Specification

Raw ↑
arazzo: 1.0.1
info:
  title: Create a collection and add a document
  version: 1.0.0
  summary: Validate the token, create a knowledge-base collection, then create a document inside it.
sourceDescriptions:
- name: authenticationApi
  url: ../openapi/brainfish-authentication-api-openapi.yml
  type: openapi
- name: collectionsApi
  url: ../openapi/brainfish-collections-api-openapi.yml
  type: openapi
- name: documentsApi
  url: ../openapi/brainfish-documents-api-openapi.yml
  type: openapi
workflows:
- workflowId: create-collection-and-document
  summary: Create a collection and a document within it.
  inputs:
    type: object
    properties:
      collectionName: {type: string}
      documentTitle: {type: string}
      documentContent: {type: string}
  steps:
  - stepId: validate
    operationId: validateToken
    successCriteria:
    - condition: $statusCode == 200
  - stepId: createCollection
    operationId: createCollection
    requestBody:
      contentType: application/json
      payload:
        name: $inputs.collectionName
    successCriteria:
    - condition: $statusCode == 200
    outputs:
      collectionId: $response.body#/id
  - stepId: createDocument
    operationId: createDocument
    requestBody:
      contentType: application/json
      payload:
        title: $inputs.documentTitle
        content: $inputs.documentContent
        collectionId: $steps.createCollection.outputs.collectionId
    successCriteria:
    - condition: $statusCode == 200
    outputs:
      documentId: $response.body#/id
  outputs:
    collectionId: $steps.createCollection.outputs.collectionId
    documentId: $steps.createDocument.outputs.documentId

Work with this as data

Every workflow 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 arazzo workflows

4 MCP tools reach this
  • find_arazzoBrowse and filter every workflow in the catalog.
  • 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 workflow
curl "https://apis.io/api/v1/arazzo/brainfish-create-collection-and-document"
All arazzo workflows
curl "https://apis.io/api/v1/arazzo?limit=25"

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

Get an API key

Free tier, no email required.

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