What is an OpenVerb Library? OpenVerb Core is the execution engine, but OpenVerb Libraries (like this one) are reusable AI action blueprints. They are NOT npm packages. You can copy the schema directly into an AI prompt to instantly give it a structured action space.

Survey & Forms Workflow

v1.0.0

Published by @OpenVerb Official

•

survey.workflow

•

Updated 22 days ago

Foundational verbs for survey creation, distribution, and response analysis. Build feedback loops, intake forms, questionnaires, and data collection pipelines for any AI agent.

surveyformsfeedbackdata-collectionquestionnaire

4216

572

survey.workflow.create_form

Create a new survey or form template with typed questions

Input

{
  "type": "object",
  "required": [
    "title",
    "questions"
  ],
  "properties": {
    "title": {
      "type": "string"
    },
    "questions": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "type": {
            "enum": [
              "text",
              "number",
              "select",
              "multiselect",
              "rating",
              "boolean"
            ],
            "type": "string"
          },
          "label": {
            "type": "string"
          },
          "options": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Options for select/multiselect types"
          },
          "required": {
            "type": "boolean"
          }
        }
      }
    },
    "description": {
      "type": "string"
    }
  }
}

Output

{
  "type": "object",
  "properties": {
    "formId": {
      "type": "string"
    },
    "shareUrl": {
      "type": "string"
    }
  }
}

survey.workflow.distribute

Send a survey to a list of recipients via email or link

Input

{
  "type": "object",
  "required": [
    "formId",
    "channel"
  ],
  "properties": {
    "formId": {
      "type": "string"
    },
    "channel": {
      "enum": [
        "email",
        "link",
        "embed"
      ],
      "type": "string"
    },
    "deadline": {
      "type": "string",
      "description": "ISO 8601 response deadline"
    },
    "recipients": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Email addresses or user IDs"
    }
  }
}

Output

{
  "type": "object",
  "properties": {
    "sentCount": {
      "type": "number"
    },
    "distributionId": {
      "type": "string"
    }
  }
}

Policies:require_auth

survey.workflow.submit_response

Submit a completed response to a survey

Input

{
  "type": "object",
  "required": [
    "formId",
    "answers"
  ],
  "properties": {
    "formId": {
      "type": "string"
    },
    "answers": {
      "type": "object",
      "description": "Key-value pairs of questionId to answer"
    },
    "respondentId": {
      "type": "string"
    }
  }
}

Output

{
  "type": "object",
  "properties": {
    "responseId": {
      "type": "string"
    },
    "submittedAt": {
      "type": "string"
    }
  }
}

survey.workflow.analyze_results

Generate an analysis summary of collected survey responses

Input

{
  "type": "object",
  "required": [
    "formId"
  ],
  "properties": {
    "formId": {
      "type": "string"
    },
    "format": {
      "enum": [
        "summary",
        "detailed",
        "csv_export"
      ],
      "type": "string"
    }
  }
}

Output

{
  "type": "object",
  "properties": {
    "breakdown": {
      "type": "object",
      "description": "Per-question aggregated results"
    },
    "completionRate": {
      "type": "number"
    },
    "totalResponses": {
      "type": "number"
    }
  }
}