openclaw-backups/skills/vibesurf/references/config-vibesurf.md

name, description

name	description
config-vibesurf	Use when user asks to configure VibeSurf API key, import or export workflows, manage workflow skills, or execute custom workflows.

Config VibeSurf - VibeSurf Configuration

Overview

Manage VibeSurf API key and workflow configurations. Import, export, and execute custom workflows.

When to Use

• User needs to set up VibeSurf API key
• User wants to import a workflow from JSON
• User needs to export a workflow to JSON

API Endpoints

Base path: $VIBESURF_ENDPOINT/api/vibesurf

API Key Management

Action	Method	Endpoint	Description
Check Status	GET	/api/vibesurf/status	Get VibeSurf connection status
Verify Key	POST	/api/vibesurf/verify-key	Verify and store API key

Workflow Management

Action	Method	Endpoint	Description
Import Workflow	POST	/api/vibesurf/import-workflow	Import workflow from JSON
Export Workflow	GET	/api/vibesurf/export-workflow/{flow_id}	Export workflow to JSON file

Request Examples

Verify API Key

POST /api/vibesurf/verify-key
{
  "api_key": "vs-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}

Import Workflow

POST /api/vibesurf/import-workflow
{
  "workflow_json": "{\"name\": \"My Workflow\", \"description\": \"...\", \"data\": {...}}"
}

API Key Format

VibeSurf API keys must:

• Start with vs-
• Be 51 characters total length
• Example: vs-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Workflow Import/Export

Import

• Accepts Langflow-compatible JSON format
• Requires valid VibeSurf API key
• Returns workflow_id and edit_url

Export

• Exports workflow to JSON file
• Removes sensitive data (API keys) automatically
• Returns file path to exported JSON

Workflow

1. Check API key status → GET /api/vibesurf/status
2. Set up API key (if needed) → POST /api/vibesurf/verify-key
3. Import workflows → POST /api/vibesurf/import-workflow
4. Export workflows → GET /api/vibesurf/export-workflow/{flow_id}