Flowboard

Flowboard API

Flowboard API as documented publicly: 23 operations. Contract generated from the documentation by API Evangelist (2026-11-08); not the provider's own document.

GitHub OpenAPI

Operations 23

POST /Groups Create SCIM group #
GET /Users List SCIM users #
POST /Users Create SCIM user #
GET /api Discover the complete API surface. #
POST /api/diagrams POST /api/diagrams #
DELETE /api/diagrams/{id} Delete a diagram. #
PUT /api/diagrams/{id}/access Update sharing settings for a diagram. #
POST /api/diagrams/{id}/comments Add a comment to a diagram or node. #
POST /api/diagrams/{id}/validate Validate a saved diagram. #
GET /api/diagrams/{id}/{markdown|yaml} Read a portable text representation of a diagram. #
POST /api/events POST /api/events #
POST /api/github/generate POST /api/github/generate #
GET /api/me Read the signed-in account. #
GET /api/organizations/acme/audit Retrieve audit records #
PUT /api/organizations/acme/retention Update retention settings #
POST /api/organizations/acme/retention/enforce Enforce retention policy #
POST /api/organizations/acme/scim-token Create SCIM token #
GET /api/organizations/acme/sso Read SSO configuration #
PUT /api/organizations/acme/sso Update SSO configuration #
POST /api/organizations/acme/sso/test Test SSO configuration #
PUT /api/organizations/{slug}/sharing-policy Update the sharing policy for an organization. #
GET /api/shapes Search and paginate exact core, AWS, and Google Cloud shape types. #
POST /api/validate Validate an unsaved diagram document. #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/flowboard-studio/openapi/_ae-authored/flowboard-studio-openapi-generated.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/flowboard-studio/json-schema/flowboard-studio-put-api-organizations-acme-sso-request-schema.json
📊
JSONSchema
https://artifacts.apis.io/flowboard-studio/json-schema/flowboard-studio-post-api-diagrams-request-schema.json
📊
JSONSchema
https://artifacts.apis.io/flowboard-studio/json-schema/flowboard-studio-put-api-organizations-acme-retention-request-schema.json

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/flowboard-studio:flowboard-studio-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

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

flowboard-studio-openapi-generated.yml Raw ↑ 
openapi: 3.1.0
info:
  title: Flowboard API
  version: '2026-11-08'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-11-08: 23 operation(s) read from 2 public documentation page(s) (each operation
    names its page in x-source). This is not the provider''s published contract; Flowboard has published no machine-readable contract that the
    pipeline could find. Engine: local.'
  x-evidence-tiers:
    code-example: 1
    documentation: 22
    pages-with-code: 1
    pages-read: 2
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-11-08'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://flowboard.studio/api
  - https://flowboard.studio/guide
paths:
  /Groups:
    post:
      operationId: post_Groups
      tags:
      - Groups
      summary: Create SCIM group
      x-source: https://flowboard.studio/guide
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /Users:
    get:
      operationId: get_Users
      tags:
      - Users
      summary: List SCIM users
      x-source: https://flowboard.studio/guide
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
    post:
      operationId: post_Users
      tags:
      - Users
      summary: Create SCIM user
      x-source: https://flowboard.studio/guide
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api:
    get:
      operationId: get_api
      tags:
      - Api
      summary: Discover the complete API surface.
      x-source: https://flowboard.studio/guide
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/diagrams:
    post:
      operationId: post_api_diagrams
      tags:
      - Api
      summary: POST /api/diagrams
      x-source: https://flowboard.studio/guide
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiDiagramsRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -X POST https://flowboard.studio/api/diagrams  -H \"Authorization: Bearer $FLOWBOARD_API_KEY\"  -H \"Content-Type: application/yaml\"\
          \  --data-binary @architecture.yaml \n Route Purpose GET /api Discover the complete API surface. GET /api/shapes Search and paginate\
          \ exact core, AWS, and Google Cloud shape types. GET|POST /api/diagrams List accessible diagrams or create from Markdown, JSON, or YAML. "
  /api/diagrams/{id}:
    delete:
      operationId: delete_api_diagrams_id
      tags:
      - Api
      summary: Delete a diagram.
      x-source: https://flowboard.studio/guide
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/diagrams/{id}/access:
    put:
      operationId: put_api_diagrams_id_access
      tags:
      - Api
      summary: Update sharing settings for a diagram.
      x-source: https://flowboard.studio/guide
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/diagrams/{id}/comments:
    post:
      operationId: post_api_diagrams_id_comments
      tags:
      - Api
      summary: Add a comment to a diagram or node.
      x-source: https://flowboard.studio/guide
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/diagrams/{id}/validate:
    post:
      operationId: post_api_diagrams_id_validate
      tags:
      - Api
      summary: Validate a saved diagram.
      x-source: https://flowboard.studio/guide
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/diagrams/{id}/{markdown|yaml}:
    get:
      operationId: get_api_diagrams_id_markdown_yaml
      tags:
      - Api
      summary: Read a portable text representation of a diagram.
      x-source: https://flowboard.studio/guide
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      - name: markdown|yaml
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/events:
    post:
      operationId: post_api_events
      tags:
      - Api
      summary: POST /api/events
      x-source: https://flowboard.studio/api
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/github/generate:
    post:
      operationId: post_api_github_generate
      tags:
      - Api
      summary: POST /api/github/generate
      x-source: https://flowboard.studio/api
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/me:
    get:
      operationId: get_api_me
      tags:
      - Api
      summary: Read the signed-in account.
      x-source: https://flowboard.studio/guide
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/organizations/acme/audit:
    get:
      operationId: get_api_organizations_acme_audit
      tags:
      - Api
      summary: Retrieve audit records
      x-source: https://flowboard.studio/guide
      parameters:
      - name: action
        in: query
        required: false
        schema:
          type: string
      - name: from
        in: query
        required: false
        schema:
          type: string
      - name: format
        in: query
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/organizations/acme/retention:
    put:
      operationId: put_api_organizations_acme_retention
      tags:
      - Api
      summary: Update retention settings
      x-source: https://flowboard.studio/guide
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PutApiOrganizationsAcmeRetentionRequest'
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/organizations/acme/retention/enforce:
    post:
      operationId: post_api_organizations_acme_retention_enforce
      tags:
      - Api
      summary: Enforce retention policy
      x-source: https://flowboard.studio/guide
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/organizations/acme/scim-token:
    post:
      operationId: post_api_organizations_acme_scim_token
      tags:
      - Api
      summary: Create SCIM token
      x-source: https://flowboard.studio/guide
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/organizations/acme/sso:
    get:
      operationId: get_api_organizations_acme_sso
      tags:
      - Api
      summary: Read SSO configuration
      x-source: https://flowboard.studio/guide
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
    put:
      operationId: put_api_organizations_acme_sso
      tags:
      - Api
      summary: Update SSO configuration
      x-source: https://flowboard.studio/guide
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PutApiOrganizationsAcmeSsoRequest'
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/organizations/acme/sso/test:
    post:
      operationId: post_api_organizations_acme_sso_test
      tags:
      - Api
      summary: Test SSO configuration
      x-source: https://flowboard.studio/guide
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/organizations/{slug}/sharing-policy:
    put:
      operationId: put_api_organizations_slug_sharing_policy
      tags:
      - Api
      summary: Update the sharing policy for an organization.
      x-source: https://flowboard.studio/guide
      parameters:
      - name: slug
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/shapes:
    get:
      operationId: get_api_shapes
      tags:
      - Api
      summary: Search and paginate exact core, AWS, and Google Cloud shape types.
      x-source: https://flowboard.studio/guide
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/validate:
    post:
      operationId: post_api_validate
      tags:
      - Api
      summary: Validate an unsaved diagram document.
      x-source: https://flowboard.studio/guide
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
components:
  schemas:
    PostApiDiagramsRequest:
      type: object
      properties:
        enabled:
          type: boolean
        require_sso:
          type: boolean
        updated_at:
          type: string
        domains:
          type: array
          items:
            type: string
        entity_id:
          type: string
        sso_url:
          type: string
        certificate:
          type: string
    PutApiOrganizationsAcmeRetentionRequest:
      type: object
      properties:
        diagram_days:
          type: string
        revision_days:
          type: string
        comment_days:
          type: string
      required:
      - diagram_days
      - revision_days
      - comment_days
    PutApiOrganizationsAcmeSsoRequest:
      type: object
      properties:
        enabled:
          type: string
        require_sso:
          type: string
        updated_at:
          type: string
        domains:
          type: string
        entity_id:
          type: string
        sso_url:
          type: string
        certificate:
          type: string
      required:
      - enabled
      - require_sso
      - updated_at
      - domains
      - entity_id
      - sso_url
      - certificate
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
security:
- bearer: []
tags:
- name: Api
- name: Groups
- name: Users