> ## Documentation Index > Fetch the complete documentation index at: https://docs.man0.space/llms.txt > Use this file to discover all available pages before exploring further. # Build a workflow with Vibe > Build or revise a workflow from a text prompt. Read newline-delimited JSON patches as they arrive. Requires current consent. Read the [streaming guide](https://docs.man0.space/developer/streaming.md) for event handling and resume behavior. ## OpenAPI ````yaml openapi.json POST /api/vibe openapi: 3.0.3 info: title: Man0 API version: 1.0.0 description: Man0 workflows, catalog, accounts and NEAR Intents. servers: - url: https://api.man0.space security: [] tags: - name: System - name: Accounts - name: Authentication - name: Catalog - name: Vibe and media - name: Workflows - name: Drafts - name: Execution - name: Analytics - name: NEAR accounts - name: Intents paths: /api/vibe: post: tags: - Vibe and media summary: Build a workflow with Vibe description: >- Build or revise a workflow from a text prompt. Read newline-delimited JSON patches as they arrive. Requires current consent. operationId: vibe requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/vibeRequestBody' responses: '200': description: Stream of newline-delimited JSON events. content: application/x-ndjson: schema: $ref: '#/components/schemas/VibeStreamEvent' '400': description: Invalid request. content: application/json: schema: $ref: '#/components/schemas/Error' '401': description: Authentication required or expired. content: application/json: schema: $ref: '#/components/schemas/Error' '403': description: Permission or current consent required. content: application/json: schema: $ref: '#/components/schemas/Error' '409': description: Resource or policy changed. content: application/json: schema: $ref: '#/components/schemas/Error' '413': description: >- Request body exceeds the size limit. Upload attachments accept at most 20 MB of decoded file bytes. content: application/json: schema: $ref: '#/components/schemas/Error' '429': description: Request rate exceeded. content: application/json: schema: $ref: '#/components/schemas/Error' '503': description: Service unavailable. content: application/json: schema: $ref: '#/components/schemas/Error' security: - man0Auth: [] components: schemas: vibeRequestBody: type: object properties: prompt: type: string minLength: 1 maxLength: 8000 flow: type: object properties: id: type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ name: type: string minLength: 1 maxLength: 200 brief: type: string maxLength: 32000 banner: nullable: true type: string maxLength: 524288 tasks: maxItems: 3 type: array items: type: string minLength: 1 maxLength: 64 coordinator: nullable: true type: object properties: id: type: string minLength: 1 maxLength: 160 userAddress: default: '' type: string maxLength: 160 agentId: default: 0 type: integer minimum: 0 maximum: 9007199254740991 walletAddress: type: string minLength: 2 maxLength: 160 name: type: string minLength: 1 maxLength: 120 image: default: '' type: string maxLength: 2048 personality: default: '' type: string maxLength: 8000 model: type: string minLength: 1 maxLength: 256 cid: default: '' type: string maxLength: 256 txHash: default: '' type: string maxLength: 256 contractId: default: '' type: string maxLength: 160 network: type: string minLength: 2 maxLength: 80 created: type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$ required: - id - walletAddress - name - model - network nodes: maxItems: 500 type: array items: type: object properties: id: type: string minLength: 1 maxLength: 100 type: type: string enum: - step position: type: object properties: x: type: number 'y': type: number required: - x - 'y' data: type: object properties: label: type: string minLength: 1 maxLength: 200 kind: type: string enum: - model - connector - agent entry: type: object properties: id: type: string minLength: 1 maxLength: 512 name: type: string minLength: 1 maxLength: 200 description: type: string maxLength: 10000 kind: type: string enum: - model - connector - agent groups: maxItems: 16 type: array items: type: string minLength: 1 maxLength: 80 subgroups: maxItems: 24 type: array items: type: string minLength: 1 maxLength: 120 modality: type: string minLength: 1 maxLength: 80 family: type: string minLength: 1 maxLength: 80 isFrontier: type: boolean isLatest: type: boolean logo: type: string maxLength: 1024 format: uri input: maxItems: 32 type: array items: type: string minLength: 1 maxLength: 80 output: maxItems: 32 type: array items: type: string minLength: 1 maxLength: 80 type: anyOf: - type: string minLength: 1 maxLength: 120 - maxItems: 32 type: array items: type: string minLength: 1 maxLength: 120 operations: maxItems: 64 type: array items: type: object properties: modality: type: string minLength: 1 maxLength: 80 operation: type: string minLength: 1 maxLength: 120 sourceTypes: maxItems: 32 type: array items: type: string maxLength: 120 input: maxItems: 32 type: array items: type: string maxLength: 80 output: maxItems: 32 type: array items: type: string maxLength: 80 pricingUnits: maxItems: 32 type: array items: type: string maxLength: 80 streamable: type: boolean required: - modality - operation - sourceTypes - input - output - pricingUnits - streamable additionalProperties: {} required: - id - name - description - kind note: type: string maxLength: 16000 required: - label - kind - note required: - id - type - position - data edges: maxItems: 2000 type: array items: type: object properties: id: type: string minLength: 1 maxLength: 200 source: type: string target: type: string sourceHandle: nullable: true type: string targetHandle: nullable: true type: string type: type: string enum: - wire required: - id - source - target modified: type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$ required: - id - name - nodes - edges - modified history: maxItems: 20 type: array items: type: object properties: role: type: string enum: - user - assistant content: type: string maxLength: 16000 required: - role - content required: - prompt - flow VibeStreamEvent: anyOf: - type: object properties: type: type: string enum: - status text: type: string required: - type - text - type: object properties: type: type: string enum: - delta text: type: string required: - type - text - type: object properties: type: type: string enum: - patch patch: $ref: '#/components/schemas/VibePatch' required: - type - patch - type: object properties: type: type: string enum: - banner_start required: - type - type: object properties: type: type: string enum: - workflow_ready text: type: string flow: $ref: '#/components/schemas/Flow' required: - type - text - flow - type: object properties: type: type: string enum: - done text: type: string flow: $ref: '#/components/schemas/Flow' required: - type - text - flow - type: object properties: type: type: string enum: - error error: type: string required: - type - error Error: type: object properties: error: type: string code: type: string threadId: type: string missing: type: array items: $ref: '#/components/schemas/MissingConnectorRequirement' missingInputs: type: array items: $ref: '#/components/schemas/MissingInputRequirement' required: - error VibePatch: anyOf: - type: object properties: op: type: string enum: - set_title name: type: string required: - op - name - type: object properties: op: type: string enum: - set_description brief: type: string required: - op - brief - type: object properties: op: type: string enum: - set_categories tasks: type: array items: type: string required: - op - tasks - type: object properties: op: type: string enum: - set_coordinator coordinator: $ref: '#/components/schemas/Coordinator' nullable: true required: - op - coordinator - type: object properties: op: type: string enum: - set_banner banner: type: string required: - op - banner - type: object properties: op: type: string enum: - add_step node: type: object properties: id: type: string minLength: 1 maxLength: 100 type: type: string enum: - step position: type: object properties: x: type: number 'y': type: number required: - x - 'y' data: type: object properties: label: type: string minLength: 1 maxLength: 200 kind: type: string enum: - model - connector - agent entry: type: object properties: id: type: string minLength: 1 maxLength: 512 name: type: string minLength: 1 maxLength: 200 description: type: string maxLength: 10000 kind: type: string enum: - model - connector - agent groups: maxItems: 16 type: array items: type: string minLength: 1 maxLength: 80 subgroups: maxItems: 24 type: array items: type: string minLength: 1 maxLength: 120 modality: type: string minLength: 1 maxLength: 80 family: type: string minLength: 1 maxLength: 80 isFrontier: type: boolean isLatest: type: boolean logo: type: string maxLength: 1024 format: uri input: maxItems: 32 type: array items: type: string minLength: 1 maxLength: 80 output: maxItems: 32 type: array items: type: string minLength: 1 maxLength: 80 type: anyOf: - type: string minLength: 1 maxLength: 120 - maxItems: 32 type: array items: type: string minLength: 1 maxLength: 120 operations: maxItems: 64 type: array items: type: object properties: modality: type: string minLength: 1 maxLength: 80 operation: type: string minLength: 1 maxLength: 120 sourceTypes: maxItems: 32 type: array items: type: string maxLength: 120 input: maxItems: 32 type: array items: type: string maxLength: 80 output: maxItems: 32 type: array items: type: string maxLength: 80 pricingUnits: maxItems: 32 type: array items: type: string maxLength: 80 streamable: type: boolean required: - modality - operation - sourceTypes - input - output - pricingUnits - streamable additionalProperties: {} required: - id - name - description - kind note: type: string maxLength: 16000 required: - label - kind - note required: - id - type - position - data edge: type: object properties: id: type: string minLength: 1 maxLength: 200 source: type: string target: type: string sourceHandle: nullable: true type: string targetHandle: nullable: true type: string type: type: string enum: - wire required: - id - source - target required: - op - node - type: object properties: op: type: string enum: - update_step stepId: type: string label: type: string note: type: string entry: $ref: '#/components/schemas/Entry' required: - op - stepId - type: object properties: op: type: string enum: - connect_steps edge: type: object properties: id: type: string minLength: 1 maxLength: 200 source: type: string target: type: string sourceHandle: nullable: true type: string targetHandle: nullable: true type: string type: type: string enum: - wire required: - id - source - target required: - op - edge - type: object properties: op: type: string enum: - remove_step stepId: type: string required: - op - stepId - type: object properties: op: type: string enum: - arrange_canvas positions: type: object additionalProperties: type: object properties: x: type: number 'y': type: number required: - x - 'y' required: - op - positions Flow: type: object properties: id: type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ name: type: string minLength: 1 maxLength: 200 brief: type: string maxLength: 32000 banner: nullable: true type: string maxLength: 524288 tasks: maxItems: 3 type: array items: type: string minLength: 1 maxLength: 64 coordinator: nullable: true type: object properties: id: type: string minLength: 1 maxLength: 160 userAddress: default: '' type: string maxLength: 160 agentId: default: 0 type: integer minimum: 0 maximum: 9007199254740991 walletAddress: type: string minLength: 2 maxLength: 160 name: type: string minLength: 1 maxLength: 120 image: default: '' type: string maxLength: 2048 personality: default: '' type: string maxLength: 8000 model: type: string minLength: 1 maxLength: 256 cid: default: '' type: string maxLength: 256 txHash: default: '' type: string maxLength: 256 contractId: default: '' type: string maxLength: 160 network: type: string minLength: 2 maxLength: 80 created: type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$ required: - id - walletAddress - name - model - network nodes: maxItems: 500 type: array items: type: object properties: id: type: string minLength: 1 maxLength: 100 type: type: string enum: - step position: type: object properties: x: type: number 'y': type: number required: - x - 'y' data: type: object properties: label: type: string minLength: 1 maxLength: 200 kind: type: string enum: - model - connector - agent entry: type: object properties: id: type: string minLength: 1 maxLength: 512 name: type: string minLength: 1 maxLength: 200 description: type: string maxLength: 10000 kind: type: string enum: - model - connector - agent groups: maxItems: 16 type: array items: type: string minLength: 1 maxLength: 80 subgroups: maxItems: 24 type: array items: type: string minLength: 1 maxLength: 120 modality: type: string minLength: 1 maxLength: 80 family: type: string minLength: 1 maxLength: 80 isFrontier: type: boolean isLatest: type: boolean logo: type: string maxLength: 1024 format: uri input: maxItems: 32 type: array items: type: string minLength: 1 maxLength: 80 output: maxItems: 32 type: array items: type: string minLength: 1 maxLength: 80 type: anyOf: - type: string minLength: 1 maxLength: 120 - maxItems: 32 type: array items: type: string minLength: 1 maxLength: 120 operations: maxItems: 64 type: array items: type: object properties: modality: type: string minLength: 1 maxLength: 80 operation: type: string minLength: 1 maxLength: 120 sourceTypes: maxItems: 32 type: array items: type: string maxLength: 120 input: maxItems: 32 type: array items: type: string maxLength: 80 output: maxItems: 32 type: array items: type: string maxLength: 80 pricingUnits: maxItems: 32 type: array items: type: string maxLength: 80 streamable: type: boolean required: - modality - operation - sourceTypes - input - output - pricingUnits - streamable additionalProperties: {} required: - id - name - description - kind note: type: string maxLength: 16000 required: - label - kind - note required: - id - type - position - data edges: maxItems: 2000 type: array items: type: object properties: id: type: string minLength: 1 maxLength: 200 source: type: string target: type: string sourceHandle: nullable: true type: string targetHandle: nullable: true type: string type: type: string enum: - wire required: - id - source - target modified: type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$ required: - id - name - nodes - edges - modified description: >- A directed acyclic workflow. Step, edge, and source-to-target route IDs must be unique; every connection must reference an existing step. MissingConnectorRequirement: type: object properties: entryId: type: string slug: type: string name: type: string type: type: string enum: - account - gated userAddress: type: string missingVars: type: array items: type: object properties: varName: type: string description: type: string obtainUrl: type: string required: - varName reason: type: string agentWallet: type: string runId: type: string threadId: type: string requestId: type: string required: - entryId - slug - name - type - reason MissingInputRequirement: type: object properties: stepId: type: string stepLabel: type: string modelId: type: string modelName: type: string acceptedInputs: type: array items: type: string questions: type: array items: type: string reason: type: string agentWallet: type: string runId: type: string threadId: type: string proposalId: type: string required: - stepId - stepLabel - acceptedInputs - reason Coordinator: type: object properties: id: type: string minLength: 1 maxLength: 160 userAddress: default: '' type: string maxLength: 160 agentId: default: 0 type: integer minimum: 0 maximum: 9007199254740991 walletAddress: type: string minLength: 2 maxLength: 160 name: type: string minLength: 1 maxLength: 120 image: default: '' type: string maxLength: 2048 personality: default: '' type: string maxLength: 8000 model: type: string minLength: 1 maxLength: 256 cid: default: '' type: string maxLength: 256 txHash: default: '' type: string maxLength: 256 contractId: default: '' type: string maxLength: 160 network: type: string minLength: 2 maxLength: 80 created: type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$ required: - id - walletAddress - name - model - network Entry: type: object properties: id: type: string minLength: 1 maxLength: 512 name: type: string minLength: 1 maxLength: 200 description: type: string maxLength: 10000 kind: type: string enum: - model - connector - agent groups: maxItems: 16 type: array items: type: string minLength: 1 maxLength: 80 subgroups: maxItems: 24 type: array items: type: string minLength: 1 maxLength: 120 modality: type: string minLength: 1 maxLength: 80 family: type: string minLength: 1 maxLength: 80 isFrontier: type: boolean isLatest: type: boolean logo: type: string maxLength: 1024 format: uri input: maxItems: 32 type: array items: type: string minLength: 1 maxLength: 80 output: maxItems: 32 type: array items: type: string minLength: 1 maxLength: 80 type: anyOf: - type: string minLength: 1 maxLength: 120 - maxItems: 32 type: array items: type: string minLength: 1 maxLength: 120 operations: maxItems: 64 type: array items: type: object properties: modality: type: string minLength: 1 maxLength: 80 operation: type: string minLength: 1 maxLength: 120 sourceTypes: maxItems: 32 type: array items: type: string maxLength: 120 input: maxItems: 32 type: array items: type: string maxLength: 80 output: maxItems: 32 type: array items: type: string maxLength: 80 pricingUnits: maxItems: 32 type: array items: type: string maxLength: 80 streamable: type: boolean required: - modality - operation - sourceTypes - input - output - pricingUnits - streamable additionalProperties: {} required: - id - name - description - kind securitySchemes: man0Auth: type: http scheme: bearer bearerFormat: JWT description: Man0 authentication token returned by sign-in. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.